禁用 Sphinx ReadTheDocs 主题中的顶部导航栏（面包屑）

Question

我想禁用 ReadTheDocs 主题的顶部导航栏。对于其他主题，例如

classic

，它只是一个选项

html_theme = "classic"
html_theme_options = {
    "showrelbartop": False
}

如何修改阅读文档主题以禁用此顶部导航栏？

编辑： 使用

make html

处理源文件后，我必须删除html文件中的这些行

<div role="navigation" aria-label="breadcrumbs navigation">
  <ul class="wy-breadcrumbs">
    <li><a href="index.html">Docs</a> &raquo;</li>
    <li></li>
      <li class="wy-breadcrumbs-aside">
      </li>
  </ul>
  <hr/>
</div>

获得预期的结果。在用

make html

编译源代码之前是否可以获得这个结果？

Answer 1

我假设你指的是面包屑（

breadcrumbs.html

）。您只需打开主模板文件 -

layout.html

- 并删除或注释掉以下行：

{% include "breadcrumbs.html" %}

Answer 2

一个老问题，但我也需要这个。比当前接受的答案更简单的答案适用于 Sphinx==3.5.3 和 sphinx-rtd-theme==0.5.2 是：

• 在

  docs/_templates/

  中，创建一个名为

  breadcrumbs.html

的文件
• 在该文件中，编写 html 注释，如

  <!-- Empty override file take the place of env/lib/python3.8/site-packages/sphinx_rtd_theme/breadcrumbs.html, which generates the top nav breadcrumbs. -->

  。

重建，就完成了。

Answer 3

不要这样做，

breadcrumbs.html

的空覆盖正在破坏。

我已经做到了，它破坏了我的谷歌网站，因为你破坏了盲人用户的网站导航，包括网络引擎。他们想知道自己在网站的哪个位置。对我来说，这变成了一个 JavaScript 错误，因为变量没有设置。

而是做

.wy-breadcrumbs {
    display: none;
}

这在 HTML 中留下了一个

<hr>

，我不知道如何在 CSS 中隐藏它，因为我已经有 LXML 来修改生成的 HTML 代码以提高我的网站的性能。