python - 关于 toctree 引用的警告

Question

Contents:

.. toctree::
   :maxdepth: 2

   foo.rst
   bar.rst

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

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

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

(WARNING/2) toctree references unknown document u'bar'

可能是什么原因？

Answer 1

Sphinx 不需要.rsttoctree 指令中的扩展名。假设 toctree 位于类似的目录中index.rst并且bar.rst位于同一目录中，请尝试分别用foo.rstand替换bar.rst您的 toctree 指令中的fooand bar。

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

Answer 2

我也遇到了这个错误。对我来说，这是由于缩进。“目录树”由 3 个空格字符缩进，而我用 4 个空格字符列出了第一个文件。为了解决这个问题，我们需要有相同的缩进级别。