include - 不同文件的标题不匹配

Question

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

.. toctree::
   :maxdepth: 3

   one
   two

文件一和二如下所示：

第一个

####
Part
####

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

Section
=======

二.第一：

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

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

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

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

然而，斯芬克斯给了我

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

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

score 3 · Accepted Answer

我相信你想要的是include 指令。例如在 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

1 回答 1