python - 关于 toctree 引用的警告

Contents:

.. toctree::
   :maxdepth: 2

   foo.rst
   bar.rst

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

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

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



可能是什么原因？

最佳答案

Sphinx 不需要 toctree 指令中的 .rst 扩展。假设 toctree 位于 index.rst 和 bar.rst 位于同一目录中，请尝试分别用 foo.rst 和 bar.rst 替换 toctree 指令中的 foo 和 bar。

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

关于python - 关于 toctree 引用的警告，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/4433267/