我正在尝试找出如何使用 Sphinx 中的 _template overrides 选项来覆盖默认的 ReadTheDocs 主题,以便在http://readthedocs.org上托管 Sphinx 文档。
具体来说,我想删除/隐藏此主题右上角显示的“在 Github 上编辑”链接。
任何提示将非常感谢!谢谢!
我在这里查看了文档:http ://www.sphinx-doc.org/en/stable/templating.html ,但是,我很难过,真的需要一些帮助。
谢谢!
我正在尝试找出如何使用 Sphinx 中的 _template overrides 选项来覆盖默认的 ReadTheDocs 主题,以便在http://readthedocs.org上托管 Sphinx 文档。
具体来说,我想删除/隐藏此主题右上角显示的“在 Github 上编辑”链接。
任何提示将非常感谢!谢谢!
我在这里查看了文档:http ://www.sphinx-doc.org/en/stable/templating.html ,但是,我很难过,真的需要一些帮助。
谢谢!
好的,我想通了,所以我会回答我自己的询问,希望能帮助其他人。
假设您使用的是 ReadTheDocs 默认主题,这应该可以正常工作。
breadcrumbs.html
文件(https://github.com/snide/sphinx_rtd_theme/blob/master/sphinx_rtd_theme/breadcrumbs.html)breadcrumbs.html
文件添加到您的 Sphinx 文档文件夹中的_templates
文件夹中。如果此目录尚不存在,则需要创建它。在你的conf.py
文件中找到你的html_context
部分,如果你还没有这个,你可以创建它。(下面链接的示例)。
html_context = {
"display_github": False, # Add 'Edit on Github' link instead of 'View page source'
"last_updated": True,
"commit": False,
}
使用将文件添加breadcrumbs.html
到跟踪的文件中Git
conf.py
参考
Edit on Github
选项现已被删除。阅读文档文档有类似的说明:https ://docs.readthedocs.io/en/latest/guides/remove-edit-buttons.html# 。因此,自发布原始答案以来,可能已经发生了潜在的代码更改。
我的需求非常相似,但并不完全相同。我想删除生成页面的这个链接(“搜索”和“genindex”),并更改链接文本,因为我们使用 framagit 作为项目托管。
这是我最后的版本:
{%- extends "sphinx_rtd_theme/breadcrumbs.html" %}
{% block breadcrumbs_aside %}
<li class="wy-breadcrumbs-aside">
{% if hasdoc(pagename) and pagename != "search" and pagename != "genindex" %}
<a href="{{ meta['framagit_url'] }}" class="fa fa-bitbucket"> {{ _('Edit on FramaGit') }}</a>
{% endif %}
</li>
{% endblock %}
在这里看到它: https ://framagit.org/simgrid/simgrid/tree/master/docs/source