Я получаю предупреждение:
WARNING: document isn't included in any toctree
для файлов, которые существуют в документе, потому что они явно включены. Поэтому у меня есть индексный файл:
.. toctree::
:maxdepth: 2
pages/0010-foo
pages/0020-bar
В файле 0020-bar.rst я специально включаю несколько других файлов, например:
.. contents:: :local:
.. include:: /pages/reference-architecture/technical-considerations/0070-baz.rst
Но когда я создаю проект, я все равно получаю предупреждение о том, что 0070-baz.rst не находится ни в каком тексте, как в:
/home/nick/Documents/myProject/docs/pages/reference-architecture/technical-considerations/0070-baz.rst:: WARNING: document isn't included in any toctree
Странно то, что я могу видеть содержимое на выходе. Это нормально? Всегда ли это предупреждение появляется для файлов, которые явно включены, а не включены через toctree?
Благодарю!