斯芬克斯文档给我关于目录树引用的警告

Question

Contents:

.. toctree::
   :maxdepth: 2

   foo.rst
   bar.rst

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

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

我正在尝试使用sphinx-build . doc来构建它，它会给我警告：

^{pr2}$

原因是什么？提前谢谢。在

Answer 1

Sphinx不需要在toctree指令中使用.rst扩展名。假设toctree在index.rst中，而bar.rst在同一目录中，请尝试将toctree指令中的foo.rst和{}分别替换为foo和{}。在

否则，请确保bar.rst在正确的目录中（而不是在父目录或子目录中）。在

Answer 2

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