次のような子ドキュメントを含む Sphinx マスター ドキュメントがあります。
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
doc3
doc4
doc5
doc6
TOC をパーツまたはサブセクションに分割して、次の行に沿ってレンダリングしたいと思います。
Part 1: Title of Part 1
<doc1 TOC>
<doc2 TOC>
Part 2: Title of Part 2
<doc3 TOC>
<doc4 TOC>
Part 3: Title of Part 3
<doc5 TOC>
<doc6 TOC>
私の現在のアプローチは、TOC に実際のドキュメントをリストする疑似子ドキュメントを作成することです。たとえば、「part1.rst」には次のようになります。
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
次に、マスター文書で:
.. toctree::
:maxdepth: 3
:numbered:
part1
part2
part3
これの問題は、「part1」のリンクをクリックすると、実際のコンテンツのないページ (「part1.rst」) に移動することです。
他のアプローチはありますか?
または、「part1.rst」のエントリがページ リンクを生成しないようにする方法はありますか?