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

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

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

Section 1
*********

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

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

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

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

Я пробовал использовать директиву include :

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

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

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

6
задан mzjn 22 February 2012 в 17:16
поделиться