python-sphinx - 在 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 目录指令可以多次使用。 这将导致我正在寻找的层次结构。

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