在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

但是它发出的警告是,section1rst中的标签在section1.rst中是重复的(不是这样,标签只在子文档中).

或者,是否有可能更改TOC指令中的层次结构？

Answer 1

我正在回答我自己的问题(羞耻!)因为我终于理解了我的错误.

该TOC,内容指令表可用于多个倍.这将导致我正在寻找的层次结构.

我希望这对那些像我一样认为只能有一个TOC的人有所帮助.