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 不需要 toctree 指令中的 .rst 扩展名。假设目录树位于 index.rst 之类的目录中，而 bar.rst 位于同一目录中，请尝试替换 foo.rst 和 bar.rst 在你的 toctree 指令中分别带有 foo 和 bar。

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