启动Sphinx Confluence Builder乘以次数

Question

我使用Sphinx Confluence Builder，我需要在config.py中使用不同的配置多次启动它，此文件的一部分是：

branchs = ['branch1', 'branch2']

extensions = ['sphinxcontrib.confluencebuilder']
confluence_publish = True
confluence_space_name = 'TEST'
for branch in branchs:
    confluence_parent_page = 'Documentation: %s' % branch
confluence_server_url = 'https://intranet-wiki.example.com'
confluence_server_user = 'username'
confluence_server_pass = 'password'
confluence_lang_transform = lambda lang: 'python'

我通过python -m sphinx -b confluence . _build/confluence命令启动它，但构建器仅发布branchs的最后一个 现在它看起来像：

-Documentation: branch1  
-Documentation: branch2
--page1
--page2
--page3

但预计：

-Documentation: branch1 
--page1
--page2
--page3 
-Documentation: branch2
--page1
--page2
--page3

page1下的page2，page3，Documentation branchX下拉网页

Answer 1

Confluence不支持以相同名称在目标空间中发布多个页面的功能。似乎正在发生的事情是，在处理branch1时，将发布预期的内容；但是，在处理branch2时，页面将被更新并移动到新的父（Documentation: branch2）下。

要解决此限制，可以使用配置选项confluence_publish_prefix确保两个文档集都没有冲突。例如，具有以下配置：

confluence_publish_prefix = '{}-'.format(branch)

发布的输出应为：

-Documentation: branch1 
--branch1-page1
--branch1-page2
--branch1-page3 
-Documentation: branch2
--branch2-page1
--branch2-page2
--branch2-page3

披露：我是Atlassian Confluence Builder for Sphinx扩展的合作者。