文章/答案/技术大牛

发布

社区首页 >问答首页 >多次启动Sphinx Confluence Builder

问多次启动Sphinx Confluence Builder
EN

Stack Overflow用户

提问于 2018-03-16 21:36:31

回答 1查看 272关注 0票数 0

我使用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命令启动的，但是builder只发布了branchs的最新版本。

现在它看起来像是：

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

但这是预期的：

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

Documentation branchX下的下拉页page1、page2、page3相同

python

python-sphinx

回答 1

Stack Overflow用户

发布于 2018-08-03 14:17:08

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扩展的合作者。

票数 0

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/49322102

复制

相似问题

问多次启动Sphinx Confluence Builder
EN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问多次启动Sphinx Confluence BuilderEN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问多次启动Sphinx Confluence Builder
EN