劃分獅身人面像TOC成小節與小標題

Question

我有一個獅身人面像主控文檔，其中包括子文件如下：

.. 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.rst」）。

有沒有其他方法？

另外，有沒有辦法抑制「part1.rst」的條目生成頁面鏈接？

Answer 1

一種選擇是，像這樣做：

.. toctree:: 
    :maxdepth: 2 
    :numbered: 

    doc1 
    doc2 
    doc3 

Subheading 
----------- 

.. toctree:: 
    :maxdepth: 2 
    :numbered: 

    doc4 
    doc5 
    doc6