4

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

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

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

# index.rst
.. toctree::

    page1
    subsection1/index

# subsection1/index.rst
.. toctree::

    subpage1

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

我对乳胶没有很多经验,而且我在网上找不到任何关于这个的东西,所以我觉得我错过了一些明显的东西。我已经研究过了.. contents::.. include::但当然这并不能产生我想要的 HTML,我希望我不必有很多.. only::零件。

4

0 回答 0