Python sphinx 我通过RTD生成的“pdf”将所有文章的内容都放在标题“内容”中，为什么？

我最近（昨天）才开始使用sphinx，并阅读了我的电脑文档

到目前为止，我对Html文档很满意，但pdf版本包含了目录标题中索引中出现的所有文章。文档原始内容/索引仅由两个链接组成

请帮忙

---

文档位于，pdf位于。

生成pdf时，Sphinx始终添加通过

引用的内容。。toctree:：

指令，该指令的确切位置。 相反，在生成HTML时，Sphinx将内容放在包含

目录树的文件之后

在这方面，PDF生成和HTML生成完全不一致

因此，您应该将索引页的所有内容放在目录之前

如果您想提供最重要的内联部分的概述，可以使用列表。然后，您可能希望使用
hidden
属性隐藏
目录树
，例如：

Contents
--------

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

Features
--------

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

.. toctree::
   :hidden:

   quickstart
   userguide