使用ReadTheDocs主题阅读Docs＆Sphinx时删除Github上的编辑链接

Question

我试图找出如何在Sphinx中使用_template覆盖选项来覆盖默认的ReadTheDocs主题，以便在http://readthedocs.org上托管Sphinx文档。

具体来说，我想要删除/隐藏此主题右上角显示的“在Github上编辑”链接。

任何提示将非常感谢！谢谢！

我在这里查看了文档：http://www.sphinx-doc.org/en/stable/templating.html，但是，我很难过，真的需要一些帮助。

谢谢！

Answer 1

好吧，我想通了，所以我会回答我自己的询问，希望能帮助别人。

假设您正在使用ReadTheDocs默认主题，这应该可以正常工作。

• 将ReadTheDocs主题从Github repo克隆到您的计算机。 （https://github.com/snide/sphinx_rtd_theme/）
• 找到breadcrumbs.html文件（https://github.com/snide/sphinx_rtd_theme/blob/master/sphinx_rtd_theme/breadcrumbs.html）
• 将breadcrumbs.html文件添加到_templates文件夹中的Sphinx文档文件夹中。如果此目录尚不存在，则需要创建它。
• 在你的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
• 推送到远程Github仓库
• 利润

参考

• https://github.com/duelingdogs/dueling-docs/blob/master/source/conf.py#L36-L40
• http://help.duelingdogs.net/en/latest/（示例显示Edit on Github选项现已删除。

Answer 2

阅读文档文档有类似的说明：https://docs.readthedocs.io/en/latest/guides/remove-edit-buttons.html#。因此，自最初的答案发布以来，可能存在潜在的代码更改。

Answer 3

我的需求非常相似，但并不完全相同。我想删除生成页面的链接（“搜索”和“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