自己を使ってスフィンクスのtoctreeでサイトマップを作成しているようですか？

Question

かなり大きなプロジェクトのFAQを更新しています。質問のインデックスをページ上部に追加したいので、ユーザーが探しているものを見つけやすくなります。

スフィンクスのドキュメントtoctree article州"toctreeディレクティブを含むドキュメントは、特別なエントリ名selfという意味です。これは、toctreeから" sitemap "を生成する場合に便利です。これは私が欲しいものです。問題は、自己が壊れているように見えて、現在の文書のタイトルのみで字幕ではないことです。私は別のドキュメントにあり、FAQを参照しているときに正しく動作します。ドキュメント自体でのみ失敗します。

• よくある質問
  • FAQに他のファイルの結果で

    .. toctree:: 
        :maxdepth: 3 
    
        faq 
    

    を実証するために、

    • 質問1
    • 屈原estion 2
    • 質問3
  • 非明白な行動と
    • FREで

  .. toctree:: 
      :maxdepth: 3 
  
      self 
  

  よくある質問インサイド結果を知るために、他の必要性quict質問した質問

私は、スフィンクスがtoctreeが変換されたときにスフィンクスが字幕を認識しておらず、toctreeをページの下に移動しようとしていた可能性があります。変化なし。あなたが探しているもの

スフィンクスとページ自体にページのインデックスを含める方法上の任意のアイデアが大幅に

Answer 1

をいただければ幸いでcontentsディレクティブです。

質問のリストを構築するためにあなたのページのタイトルの後に次のブロックを挿入します。

.. contents:: 
    :local: 
    :depth: 1 

それが生成されます。

• 質問1
• 質問2
• 質問3