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'

可能是什么原因？提前致谢.

解决方法:

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

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