include - 異なるファイルの見出しが一致しません

Question

私はSphinxで非常に基本的なセットアップをしています。TOC は次のとおりです。

.. toctree::
   :maxdepth: 3

   one
   two

ファイル 1 と 2 は次のようになります。

1つ目

####
Part
####

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

Section
=======

2 つ目:

***************
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