Описание тега toctree

.. toctree:: - это директива инструмента создания документов Python Sphinx, используемая для соединения файлов документации, других toctrees и оглавлений.

Этот тег служит для различения вопросов, относящихся к специализированному Сфинксу. .. toctree::директива из других таблиц содержания (ToC), которые могут сосуществовать или создаваться в том же контексте. Например, директива reST ToC или LaTex ToC среди других, и в этом случае следует использовать общую таблицу содержимого.

Кроме того, этот тег служит для фильтрации вопросов, которые - хотя и содержат в тексте слово "toctree"- не относятся к самой директиве.

Этот тег может быть автономным, но его следует использовать вместе с родительским тегом python-sphinx.

Официальная документация по .. toctree:: директива.