6

次のような子ドキュメントを含む 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」のエントリがページ リンクを生成しないようにする方法はありますか?

4

1 に答える 1