Dzielenie dokumentu źródłowego w Sphinx (tj. Hierarchia plików zarządzających)

Question

Jaki jest właściwy sposób podziału dokumentu źródłowego w Sphinx?

Mam dużego pliku, nazwijmy to file1.rst, którego struktura jest tak:

Section 1 
********* 

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

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

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

Każdy podrozdział jest bardzo długi, a plik źródłowy stała się niewykonalna. Chciałbym umieścić każdą z podsekcji w innym pliku źródłowym.

Próbowałem z dyrektywą include:

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

Ale to wydawanie ostrzeżeń, że etykiety w subsection1.rst są duplikowane w section1.rst (nieprawda, etykieta jest tylko w podgrupie dokumentu).

Czy istnieje możliwość zmiany hierarchii w dyrektywie OWO?

Answer 1

Odpowiadam na moje własne pytanie (wstyd!), Ponieważ w końcu zrozumiałem, co robię źle.

TOC, dyrektywa spisu treści może być używana wiele razy razy. Spowoduje to uzyskanie hierarchicznej struktury, której szukałem.

Mam nadzieję, że może to być pomocne dla tych, którzy podobnie jak ja sądzili, że może istnieć tylko jeden spis treści.