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

时间:2016-02-29 00:43:12

标签: python python-sphinx tableofcontents

我是Sphinx的新手,我想在Sphinx中加入一个toctree,它似乎完全无视我的toctree选项。

我有如下所示的代码和

.. toctree::
   :titlesonly:

  foo
  bar

这也被忽略了:

.. toctree::
   :maxdepth: 1

  foo
  bar

结果输出看起来像这样:

    • Foo1
      • Foo12
    • foo2的
  • 酒吧
    • BAR1
      • Bar12
    • Bar2

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

1 个答案:

答案 0 :(得分:2)

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

.. toctree::
   :maxdepth: 1

   foo
   bar