指令和条目之间缺少空白行错误

Question

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

.. toctree::
   :maxdepth: 2
    tutorial

并且当我“制作html”时，我在索引页面上没有得到“教程”。然后，我在与index.rst相同的目录中创建了一个tutorial.rst。我再次执行“ make html”，并且收到此错误消息：

toctree包含对不存在文档的引用

我该如何解决？

Answer 1

也许试试这个：

.. toctree::
   :maxdepth: 2

   tutorial <tutorial>

..

Answer 2

您必须在maxdepth定义和文件名之间留空行。