如何在GitHub上托管基于狮身狮身来临的文档的多个版本?

发布于 2025-01-26 03:37:14 字数 228 浏览 3 评论 0原文

当使用github页面托管狮身人面像文档时,可能需要为不同分支或代码的标签托管多个版本的同一文档的多个版本。 但是,sphinxcontrib-multiversionsphinxcontrib-versioning均未积极维护,并且它们不适用于最新版本的sphinx。

如果一个人不想使用readthedocs,并且不想坚持雪花石膏主题,那么正确的解决方案是什么?

When using Github pages to host Sphinx documentation, it might be desirable to host multiple versions of the same documentation for different branches or tag of the code.
However, both sphinxcontrib-multiversion and sphinxcontrib-versioning are not actively maintained and they do not work with the latest version of Sphinx.

If one does not want to use ReadTheDocs, and want to stick to the Alabaster theme, what would be the right solution ?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

伤痕我心 2025-02-02 03:37:14

对于DIY实施,您可以参考我如何实现此目标,以 rinohtype文档。我首先为狮身人面像RTD主题实施了此功能,然后切换到狮身人面像材料。请注意,这两个主题都提供了版本选择器,我认为Alabaster不会。

这些是相关的提交:

  • https://github.com/brechtm/rinohtype/commit/8a23be41d39d748955b139f0fab139f0fabefe3205a4fd93”
  • “ /rinohtype/commit/1270802C4959EB4742C51D3307222930AC73A80C“ rel =“ noreferrer”> html docs:json file from json file BB50DFB92EA8F0E0282CE291B1E21“
  • rel =” noreferrer“> docs:configure/create im_versions.json for sphinx-immaterial

For a DIY implementation, you can refer to how I implemented this for the rinohtype documentation. I first implemented this for the Sphinx RTD theme and later switched to Sphinx-Immaterial. Note that both of these themes provide version selectors, which I don't think Alabaster does.

These are the relevant commits:

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文