如何在我的 Sphinx 文档的每个页面中添加目录？

Question

我正在尝试复制 ToC 在此页面侧边栏中的显示方式：http://matplotlib.sourceforge.net/sampledoc/extensions.html

...但我找不到任何解释如何在模板本身上或“显示源”的文档。

这是他们在该教程中使用的模板源：http://matplotlib.sourceforge.net/sampledoc/custom_look.html

它调用：

{% block sidebar1 %}{{ sidebar() }}{% endblock %}

但这似乎不是 ToC 我的自定义文档。

更新：要回答我自己的问题，您只需将子部分添加到同一页面，它会自动将这些子部分生成为 ToC。

Answer 1

答案（请参阅问题作者的更新）是，如果您的页面中有部分标题，您只会在侧边栏中获得一个 ToC。根据 Sphinx，没有标题，就不需要 ToC。