python - 如何将目录添加到我的 Sphinx 文档中的每一页？

Question

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

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

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

它调用:

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

但这似乎并没有包含我的自定义文档。

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

Answer 1

答案(请参阅问题作者的更新)是，如果您的页面中有章节标题，您只会在侧边栏中获得目录。没有标题，根据 Sphinx 就不需要 ToC。