Sphinx latex pdf包括子部分页面上的子toctree

时间:2016-12-04 05:03:18

标签: latex python-sphinx pdflatex

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

source/
    index.rst
    page1.rst
    subsection1/
        index.rst
        subpage1.rst

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

# index.rst
.. toctree::

    page1
    subsection1/index

# subsection1/index.rst
.. toctree::

    subpage1

当我生成HTML时,subsection1/index页面包含TOC列表,其中包含指向相应页面的链接。当我生成乳胶PDF时,它忽略了子toctrees并且没有打印任何东西,但我希望它与HTML相同。

我没有很多乳胶经验,而且我在网上找不到任何关于此事的信息,所以我觉得我错过了一些明显的东西。我已经查看了.. contents::.. include::,但当然这并不会产生我想要的HTML,我希望我不必拥有大量的.. only::部分。

0 个答案:

没有答案