Sphinx'te bölme kaynak belgesi (ör. Dosya hiyerarşisini yönetme)

Question

Sphinx'te bir kaynak belgeyi bölmenin doğru yolu nedir?

Ben büyük bir dosya var, en file1.rst diyelim, yapısı şu şekildedir:

Section 1 
********* 

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

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

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

Her alt bölüme çok uzun ve kaynak dosya yönetilemez hale gelmiştir. Her bir alt bölümü farklı bir kaynak dosyaya koymak istiyorum.

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

Ama section1.rst çoğaltılır subsection1.rst içinde etiketler (doğru değil, etiket sadece alt belgede ise) uyarılar veren ediyor:

Ben include yönergesi ile çalıştı.

Alternatif olarak, hiyerarşiyi TOK yönergesinde değiştirme olasılığı var mıdır?

Answer 1

Kendi sorumu (utanç!) Yanıtlıyorum çünkü nihayet yanlış gittiğimi anladım.

İçindekiler yönergesi tablosunun TOC'si, çoklu kez kullanılabilir. Bu, aradığım hiyerarşik yapıyla sonuçlanır.

Umarım bu, benim gibi sadece bir TOC olabileceğini düşünenler için yardımcı olabilir.