关于toctree引用的警告

Question

Contents:

.. toctree::
   :maxdepth: 2

   foo.rst
   bar.rst

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

我试图使用sphinx-build . doc构建它，它给了我警告：

(警告/2)树引用未知文档u‘’bar‘

可能是什么原因？

Answer 1

狮身人面像不需要toctree指令中的.rst扩展。假设toctree位于类似于index.rst和bar.rst的目录中，那么尝试将toctree指令中的foo.rst和bar.rst分别替换为foo和bar。

否则，确保bar.rst位于正确的目录中(而不是在父目录或子目录中)。

Answer 2

我也收到了这个错误。对我来说，是压痕造成的。"toctree“缩进了3个空格字符，而我用4个空格字符列出了rst文件。为了解决这个问题，我们需要有相同的缩进级别。