如何在 GitHub 上托管基于 Sphinx 的文档的多个版本?

Edm*_*984 2 python python-sphinx

当使用 Github 页面托管 Sphinx 文档时,可能需要为代码的不同分支或标签托管同一文档的多个版本。但是,两者sphinxcontrib-multiversionsphinxcontrib-versioning没有得到积极维护,并且不能与最新版本的 Sphinx 一起使用。

如果不想使用 ReadTheDocs,并且想坚持 Alabaster 主题,那么正确的解决方案是什么?

Bre*_*els 5

对于 DIY 实现,您可以参考rinohtype 文档我是如何实现的。我首先为 Sphinx RTD 主题实现了此功能,后来切换到 Sphinx-Immaterial。请注意,这两个主题都提供版本选择器,但我认为 Alabaster 不提供。

这些是相关的提交: