RTDで生成された私の `pdf`は、見出しの内容にすべての記事を載せています。なぜですか？

Question

私はちょうど最近（昨日）、スフィンクスを使い始めて、projectのドキュメントを読んでいます。

今まで私はHTMLのドキュメントに満足していますが、pdfバージョンには目次見出し内のインデックスに表示されるすべての記事が含まれています。また、ドキュメントのコンテンツ/インデックスは、単に2つのリンクで構成されています。

助けてください。

ドキュメントはhttp://todx.rtfd.ioで、pdfはhereです。

Answer 1

PDFを生成する際には、スフィンクスは常に指示文が置かれている場所の.. toctree::ディレクティブで参照されるコンテンツを追加します。 これに対し、HTMLを生成する場合、スフィンクスはコンテンツの後にのファイルにtoctreeを入れています。

この側面では、PDFの生成とHTMLの生成には一貫性がありません。

したがって、の目次の前にインデックスページのすべてのコンテンツを配置する必要があります。

インラインで最も重要なセクションの概要を提供する場合は、referencesのリストを使用できます。次に、hiddenプロパティを使用してtoctreeを非表示にすることができます（例：

Contents 
-------- 

- :ref:`quickstart` 
- :ref:`userguide` 

Features 
-------- 

- Fast 
- Simple 
- Inituitive 
- Easy to Use 
- Offline 
- Open Source 

.. toctree:: 
    :hidden: 

    quickstart 
    userguide