我有一个 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::
零件。