文档标签版本（Sphinx）

Question

我在下面使用Sphinx为我的项目生成文档。 如何根据标签/分支生成多个版本？

我确实检查了库sphinxcontrib-versioning，但是由于它最近没有更新，因此似乎已损坏。我有什么可以研究的吗？任何人都可以将我定向为来源吗？

谢谢。

Answer 1

这里是一种以Pyramid和Read the Docs为例发布多种版本的文档的方法。

将conf.py on the master branch与其他编号的分支进行比较。这些版本几乎相同，除了older versions我们在固定的div上打上“阅读此页面的最新版本”并链接到最新的稳定版本外，对于master branch在警告徽章“ NOTICE Documentation in Progress”上。

然后configure RTD to build multiple versions您的文档。