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

【问题标题】：How to host multiple version of a Sphinx based documentation on GitHub?如何在 GitHub 上托管基于 Sphinx 的文档的多个版本？
【发布时间】：2022-09-23 17:58:52
【问题描述】：

当使用 Github 页面托管 Sphinx 文档时，可能需要为不同的分支或代码标签托管同一文档的多个版本。但是，sphinxcontrib-multiversion 和 sphinxcontrib-versioning 都没有得到积极维护，并且它们不适用于最新版本的 Sphinx。

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

标签： python python-sphinx

【解决方案1】：

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

这些是相关的提交：

【讨论】：