1つの部分のSphinxチャプターを別々のファイルに分割する方法は？

Question

素晴らしいSphinxツールを使用してドキュメントを作成しています。同じパートの章を別々のファイルに分けることで、コードベースをモジュラー形式に保ちようとしています。

.. toctree:: 
    :maxdepth: 2 

    test1 
    test2 

：彼らはこのような index.rstに含まれている

********* 
Chapter 2 
********* 

Section 2 
========= 
Test Content 2. 

：

###### 
Part 1 
###### 

********* 
Chapter 1 
********* 

Section 1 
========= 
Test Content 1. 

とtest2.rst：私は2つのファイル、test1.rstを使用してこれを実行しようとしました（See here for definitions of 'chapter' and 'part'.）

しかし、ビルド時に、C第2章は第1部の中に入れ子になっていません。これはなぜですか？下の例のように、それらを単一のファイルに追加するスクリプトを作成しなくても、これを行う方法はありますか？

例：

###### 
Part 1 
###### 

********* 
Chapter 1 
********* 

Section 1 
========= 
Test Content 1. 

********* 
Chapter 2 
********* 

Section 2 
========= 
Test Content 2. 

Answer 1

includeディレクティブは、あなたが探しているものであるように思えます。インクルードされたファイルの内容は解析され、ディレクティブのポイントに含まれます。

test1.rst：http://docutils.sourceforge.net/docs/ref/rst/directives.html#include：

###### 
Part 1 
###### 

********* 
Chapter 1 
********* 

Section 1 
========= 
Test Content 1. 

.. include:: test2.rst