Разделение исходного документа в Sphinx (т.е. управление иерархией файлов)

Question

Как правильно, если таковые имеются, разделить исходный документ в Sphinx?

У меня большой файл, назовем его file1.rst, структура которого выглядит следующим образом:

Section 1
*********

Subsection 1
============

Subsection 2
============

Subsection 3
============

Каждый подраздел очень длинный, и исходный файл стал неуправляемым.Я хотел бы поместить каждый подраздел в отдельный исходный файл.

Я пытался с директивой include:

Section 1
*********
.. include:: subsection1.rst
.. include:: subsection2.rst
.. include:: subsection3.rst

Но он выдает предупреждения, что метки в subsection1.rst дублируются вsection1.rst (не правда, метка есть только во вложенном документе).

В качестве альтернативы, есть ли возможность изменить иерархию в директиве TOC?

Answer 1

Я отвечаю на свой собственный вопрос (позор!), Потому что я наконец понял, что я ошибаюсь.

Можно использовать директиву оглавления, оглавление множественный раз. Это приведет к иерархической структуре, которую я искал.

Я надеюсь, что это может помочь тем, кто, как и я, думал, что может быть только один TOC.