我有一个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::
部分。