狮身人面像忽略“toctree”选项

Question

我是 Sphinx 的新手，我试图在 Sphinx 中包含一个 toctree，但它似乎完全忽略了我的 toctree 选项。

我有如下代码：

.. toctree::
   :titlesonly:

  foo
  bar

这个也忽略了：

.. toctree::
   :maxdepth: 1

  foo
  bar

结果输出看起来像这样：

• 富
  • Foo1
    • Foo12
  • Foo2
• 酒吧
  • 酒吧1
    • 第 12 栏
  • 酒吧2

我 运行 make html 生成 HTML 文件，我想我的 conf.py 文件中的设置可能有误。

Answer 1

一致的缩进很重要。将 toctree 条目的名称向右移动一列，它将起作用。

.. toctree::
   :maxdepth: 1

   foo
   bar