документация sphinx, дающая мне предупреждение о ссылках на 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 не нуждается в расширении .rst в директиве toctree.Предполагая, что toctree находится в чем-то вроде index.rst, а bar.rst находится в одном каталоге, попробуйте заменить foo.rst и bar.rst в вашей директиве toctree на foo и bar соответственно.

В противном случае, убедитесь, что bar.rst находится в правильном каталоге (а не в родительском или подкаталоге).

Answer 2

Я тоже получаю эту ошибку.Для меня это было связано с отступом.«Toctree» было отступлено 3 пробелами, тогда как я перечислил первые файлы 4 пробелами.Чтобы решить эту проблему, мы должны иметь одинаковый уровень отступа.