TOC树问题

Question

我刚刚使用Sphinx创建了我的文档，这是我的问题： 最初在Toc树指令是空的，然后我在下面添加“教程”，它看起来像这样：

.. toctree::
   :maxdepth: 2
    tutorial

当我“制作html”时，我没有在索引页面上获得“教程”。然后我在与index.rst相同的dircetory中创建了一个tutorial.rst。我再次“制作HTML”，我收到此错误消息： “toctree包含对不存在的文档的引用”。

我该如何解决这个问题？谢谢。

Answer 1

也许试试这个：

.. toctree::
   :maxdepth: 2

   tutorial <tutorial>

..

假设您的tutorial.rst文件位于index.rst文件的同一级别的“source”目录中

编辑以下注释：换行在toctree选项和页面列表之间很重要

Answer 2

maxdepth定义和文件名之间必须有一个空行。