在我的文档项目中,我打算同时使用 HTML 和 pdf 文档。由于我的项目变得相当笨重,我已经开始将一些数据/信息存储在标记为的单独文件中,:orphan:
以便于管理toctree
。
在 HTML 环境中,我可以使用orphan
已在 HTML 环境中创建并放置:ref:
在调用文件中的链接来调用 ed 文件的内容。到目前为止,它运行得相当好。
但是,在生成的.pdf
文件中(使用 Sphinx make latexpdf
),链接未激活(显示为纯文本),可能是因为调用的文件被标记为:orphan:
s?如果我将:orphan:
ed 文件包含在 a 中:hidden:
toctree
(在index
文件中),则指向:orphan:
被激活(变为点击能够),但他们随后包括在.pdf
文件的中toctree
。
如何防止orphan
文件出现在.pdf
文件中toctree
?
环境:
Tex Live 2023
macOS 10.12.6
Sphinx v7.2.6
Python 3.9