獅身人面像忽略`toctree`選項

Question

我是獅身人面像的新手，我想在獅身人面像中包含一個toctree，它似乎完全忽略了我的toctree選項。

我的代碼如下圖所示，一個

.. toctree:: 
    :titlesonly: 

    foo 
    bar 

這也忽略：

.. toctree:: 
    :maxdepth: 1 

    foo 
    bar 

隨着輸出結果看起來像這樣：

• 富
  • Foo1
    • Foo12
  • foo2的
• 酒吧
  • BAR1
    • Bar12
  • BAR2

我正在make html生成HTML文件，我想這是可能，我有一個設置錯誤的，我conf.py文件。

Answer 1

一致的縮進很重要。將toctree條目的名稱向右移動一列，它將起作用。

.. toctree:: 
    :maxdepth: 1 

    foo 
    bar