狮身人面像忽略`toctree`选项答案

【问题标题】：Sphinx ignoring `toctree` options狮身人面像忽略`toctree`选项
【发布时间】：2016-02-29 00:43:11
【问题描述】：

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

我有如下代码：

.. toctree::
   :titlesonly:

  foo
  bar

这也被忽略了：

.. toctree::
   :maxdepth: 1

  foo
  bar

生成的输出如下所示：

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

【问题讨论】：

【解决方案1】：

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

.. toctree::
   :maxdepth: 1

   foo
   bar

【讨论】：