Sphinx Latex pdf 在小节页面上包含子目录树

djh*_*ese 5 latex pdflatex python-sphinx toctree

我有一个 sphinx 文档项目,用于生成文档的HTML ( make html) 和 PDF ( ) 版本。make latexpdf我使用子目录来组织一些页面。我的目录结构是这样的:

source/
    index.rst
    page1.rst
    subsection1/
        index.rst
        subpage1.rst
Run Code Online (Sandbox Code Playgroud)

我在两个 index.rst 文件中都指定了一个目录树:

# index.rst
.. toctree::

    page1
    subsection1/index

# subsection1/index.rst
.. toctree::

    subpage1
Run Code Online (Sandbox Code Playgroud)

当我生成 HTML 时,该subsection1/index页面具有目录列表,其中包含指向相应页面的链接。当我生成乳胶 PDF 时,它会忽略子目录树并且不打印任何内容,但我希望它与 HTML 相同。

我对乳胶没有太多经验,而且我在网上找不到任何关于这方面的信息,所以我觉得我错过了一些明显的东西。我已经研究过.. contents::.. include::但当然这不会产生我想要的 HTML,我希望我不需要有大量的.. only::部件。