私はドキュメントを書くために sphinx 1.3.4¹ をmake html使用しており、「ドキュメントを読む」テーマ² を使用しています。
このドキュメントの index.rst に、Lv 1 から Lv3 までの見出しを持つファイル chaper1.rst を含めると、結果のナビゲーション サイドバーに lv 1 という見出しが表示されます。この見出しをクリックすると、折りたたまれて見出し lv2 -lv3 が表示されます。大丈夫です。
chapter1 をいくつかのファイルに分割すると、index.rst で使用できchaper1/*、結果の html ドキュメントにすべてのファイルが含まれます。しかし、各ファイルの見出し (最初のlv2のファイルも含む) は、中央のナビゲーション サイドバーの折りたたみで個別の章として表示されます。章の見出しが折りたたまれることはもうありません。:-/
章ごとに複数のファイルを使用して、左側にきれいなナビゲーションを作成するにはどうすればよいですか?
ティア！
編集 rtd-theme バージョン 0.1.9 のバックポートを行いました - 変更はありません。ということで、スフィンクスの問題のようです。複数のファイルを 1 つの章に適切に含めるにはどうすればよいですか?
[1] https://packages.debian.org/jessie-backports/python3-sphinx
[2] https://packages.debian.org/jessie/python3-sphinx-rtd-theme