不同文件的标题不匹配

Question

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

.. toctree::
   :maxdepth: 3

   one
   two

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

one.rst

####
Part
####

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

Section
=======

two.rst：

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

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

两个文件的格式都相同，我希望使用以下结构结束

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

但是，狮身人面像给了我

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

之所以分割文件，是因为它们相当大，我想将它们保持较小，以便可以轻松地对其进行编辑。如何在不同的文件中获得相同的标题样式（具有相同的上划线/下划线字符）？

Answer 1

我相信您想要的是include directive。例如，在1.rst中，您将放置

####
Part
#### 

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

Section
=======

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

这将包括2.rst，但是您需要在当前文件中包含许多其他文件，并继续当前的结构布局。另外，将index.rst更改为仅1.rst。

.. toctree::
   :maxdepth: 3

   1.rst
   part2.rst
   part3.rst