python - Toctree 激活侧边栏上的当前页面和主页

Question

de上没有问题，index.rst如下所示：

但是，当我转到另一个页面时，在我的情况下是annotation-module.rst，侧边栏会选择并同时显示index和annotation-module，如下所示：

但是，我只想激活注释模块页面并显示其子部分。

我conf.py唯一的用途html_theme是通过查找READTHEDOCS如下环境变量：

if not on_rtd:  # only import and set the theme if we're building docs locally
    try:
        import sphinx_rtd_theme

        html_theme = "sphinx_rtd_theme"
        html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
    except Exception:
        pass

我的index.rst：

Welcome to exceptive's documentation!
=====================================

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   index
   annotation-module

Here I have some introductory text.

annotation-module.rst甚至不包括任何，我toctree只有它下面的部分。

那么，如何仅激活侧边栏上的当前文档部分？

这是Steve Piercy要求的文档源目录。

---

环境

• 蟒蛇 3.5
• 狮身人面像 1.7.6
• 狮身人面像 rtd 主题 0.4.0

标签： pythonpython-sphinxsidebarread-the-docstoctree

Answer 1

所以，我有点解决了这个问题。问题出在sphinx-autobuild某种程度上，我在问题中没有提到。

make html每次我更新我的文档并使用node's提供它时，我都会简单地使用它http-server。

还引用indexinindex.rst创建警告：

WARNING: self referenced toctree found. Ignored.

所以，index从toctree现在解决我的问题。