如何避免：隐藏：源文件被添加为 Sphinx pdflatex 生成的 pdf 文件中的书签

Question

使用 Sphinx 文档生成器（带有 pdflatex），我正在创建 pdf 文件，并使用 label 和 ref 标记添加了一些内部文件的链接，如下所示：

在被调用文件（xyz.rst）中

.. _called-file-label:

在调用文件中（abc.rst）我正在添加对label 的引用，如下所示：

:ref:`Get Info <called-file-label>`

通过上述安排，我可以使用 pdflatex 生成 pdf 文件。但是，我发现被调用的文件也被添加到了 pdf 文件的书签部分，感觉有点笨拙。

我知道我需要在 .. toctree:: 部分中添加两个源文件，以便超链接出现在 pdf 文件中（我已使用 :hidden: 指令添加了 调用文件 以防止文件不会出现在 html 文档的 ToC 树中）。

我的问题是：我需要做什么才能使调用的文件 (xyz.rst) 不在 书签部分 strong>生成的 pdf 文件？

Answer 1

如果.. _called-file-label: 之后的标签是节：

.. _called-file-label:

Foo Bar
======

那么，章节标题“Foo Bar”将始终成为 PDF 中的书签。

toctree的:hidden:选项不是隐藏文档，而是在toctree的地方不显示ToC。 IE。它是隐藏目录树，而不是它的文档。隐藏目录树中的文档仍将在 HTML 侧边栏、PDF 书签等中可见。

您似乎需要rubric directive。 Rubric 就像一个部分，但不构成目录。