Python sphinx 指令和条目之间缺少平衡线错误

Python sphinx 指令和条目之间缺少平衡线错误,python-sphinx,toctree,Python Sphinx,Toctree,我刚刚使用Sphinx创建了文档,这就是我的问题: 最初,Toc tree指令中的值为空,然后我在下面添加了“tutorial”,如下所示: .. toctree:: :maxdepth: 2 tutorial 当我“生成html”时,我不会在索引页上看到“教程”。然后我在index.rst所在的目录中创建了tutorial.rst。我再次“生成html”,并收到以下错误消息: 目录树包含对不存在文档的引用 如何修复此问题?也许可以尝试以下方法: .. toctree::

我刚刚使用Sphinx创建了文档,这就是我的问题: 最初,Toc tree指令中的值为空,然后我在下面添加了“tutorial”,如下所示:

.. toctree::
   :maxdepth: 2
    tutorial
当我“生成html”时,我不会在索引页上看到“教程”。然后我在index.rst所在的目录中创建了tutorial.rst。我再次“生成html”,并收到以下错误消息:

目录树包含对不存在文档的引用

如何修复此问题?

也许可以尝试以下方法:

.. toctree::
   :maxdepth: 2

   tutorial <tutorial>

..
。。目录树::
:maxdepth:2
辅导的
..
假设tutorial.rst文件位于与index.rst文件相同级别的“source”目录中


注意:换行符在目录树选项和页面列表之间很重要。

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

这很有效。官方文件()有错吗?