狮身人面像忽略`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