不同文件的标题不匹配

Question

我在Sphinx中有一个非常基本的设置。 TOC如下：

.. toctree::
   :maxdepth: 3

   one
   two

文件一和二看起来像这样：

one.rst

####
Part
####

*******
Chapter
*******

Section
=======

two.rst：

***************
Another Chapter
***************

Another Section
===============

两个文件都有相同的格式，我想最终得到以下结构

Part
|- Chapter
  |- Section
|- Another Chapter
  |- Another Section

然而，Sphinx给了我

Part
|- Chapter
  |- Section
Another Chapter
|- Another Section

我分割文件的原因是它们相当大，我想保持它们很小，以便我可以轻松编辑它们。如何获得相同的标题样式（使用相同的上划线/下划线字符）但在不同的文件中？

Answer 1

我相信你想要的是include directive。例如，在第一次，你将把

####
Part
#### 

*******
Chapter
*******  

Section
=======

.. include:: 2.rst
.. include:: 3.rst
.. include:: 4.rst

这将包括您在当前文件中所需的第一个和多个其他文件，并继续当前的结构布局。另外，将index.rst更改为第一个。

.. toctree::
   :maxdepth: 3

   1.rst
   part2.rst
   part3.rst