gpt4 book ai didi

python - 自托管 Sphinx 文档中的多个版本

转载 作者:行者123 更新时间:2023-12-04 13:38:20 33 4
gpt4 key购买 nike

我正在尝试为自托管 GitLab 项目构建文档。该文档将托管在 GitLab 页面中,并且会有不同的版本。感谢 this answer ,我想出了如何在 GitLab 页面上托管多个版本。
我现在的问题是如何访问这些版本。
我想使用 ReadTheDocs 主题,这似乎是考虑到这一点而构建的:
rtd collapsible menu
如何访问和修改该导航菜单?我无法在文档中找到任何内容。
( 编辑: 刚刚了解到该菜单的名称是弹出)
如果这是不可能的,我想以某种方式在左侧面板上添加一个部分(例如经典主题上的 html_sidebars),因为我已经构建了一个脚本来获取版本的链接。
我真的只需要一种方法来向栏添加一个部分。

最佳答案

我的解决方案

由于@Steve Piercy 在评论中提到无法在 RTD 自托管主题中设置弹出窗口,因此我尝试个性化左侧边栏以添加版本链接。

与经典主题(我提到的 html_sidebars)不同,似乎无法配置显示的内容。你能做的是add customised javascript and css .因此,我创建了一个小脚本,用于添加一个新的无序列表,其中包含指向目录顶部版本的链接。

我更愿意遵循另一种方法,因为它很笨拙,并且它使用硬编码的 css 类名(可能会随时更改),但这是我唯一能想出并且可以正常工作的方法。

如果有人需要有关解决方案的更多详细信息,我可以提供。

关于python - 自托管 Sphinx 文档中的多个版本,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/60487622/

33 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com