如何在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。根據獅身人面像，沒有標題，沒有ToC是必要的。