メインのTOCツリーからスフィンクスサブセクションを隠す

Question

RSTファイルに存在するサブセクションの1つ（またはすべて）をメインのTOCツリーから隠すことはできますか？

は私はもう少し説明してみましょう：

file.rst 子供/

Children Title 
============== 

.. toctree:: 

    Label of Grandchildren 1 
    Label of Grandchildren 2 


Subsection 1 
------------ 

Subsection 2 
------------ 

Subsection 3 
------------ 

これらのファイル

:doc:`Label <path/to/rst/file>` 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

.. toctree:: 

    Label <path/to/rst/file> 
    Label <path/to/rst/file> 

    Label of Children TOCTree <path/to/rst/children/file> 

index.rst、後に構築された、となりますメインTOCツリー内：

• レーベル
• レーベル
• 子供
  • 孫のラベル孫の1枚の
  • ラベル2
  • サブセクション1
  • 款
  • サブセクション3
のレーベル

私は、TOCTreesだけを保持して、私が望むように多くの、そして深く、サブセクションを隠したいと思います。例：孫2

しかし、ハイパーリンクがに関連付けられている場合の孫の子供 の

• ラベル
• ラベル
• ラベル
  • ラベルは1
  • ラベル子供のラベルをクリックすると、サブセクションは通常通り表示されます。

Answer 1

「朱書き」ディレクティブは、あなたが望むものを達成することができる：

http://sphinx-doc.org/markup/para.html#directive-rubric

それは全く同じようにセクションタイトルを生成しませんが、少なくとも彼らはTOC

に表示されません。

Answer 2

あなたはTOCがどれだけ深く設定するtoctreeのmaxdepthパラメータを使用することができます。

.. toctree:: 
    :maxdepth: 2 

Answer 3

これはAWH連れて行ってくれました把握することができましたが、ついにそれを得たと思います。 "トリック"は、tocを含む親の最初と、そのセクションを含む子の最初の両方にディレクティブを設定する必要があるということです。

私にとっては、親の最初のtocに:maxdepth:1と:titlesonly:を追加し、次に子供のtocに:titlesonly:を追加しました。これは完全に機能します。これにより、TOCに表示されない、適切にレンダリングされた子で階層的なサブセクションの書式設定ができるようになります。

Answer 4

サブセクション1などで****************に変更してみてください。また、あなた

.. toctree:: 
    :maxdepth: 2 

    Label <path/to/rst/file> 
    Label <path/to/rst/file> 

.. toctree:: 
    :maxdepth: 1 
    Label of Children TOCTree <path/to/rst/children/file>