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

问题描述

使用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 ）在书签部分中没有显示，我需要做些什么生成的pdf文件的strong> ？

解决方法

如果.. _called-file-label:标签之后是以下部分：

.. _called-file-label:

Foo Bar
======

然后，标题栏“ Foo Bar”将始终成为PDF中的书签。

:hidden:的{​​{1}}选项不是隐藏文档，而是不要在带有toctree的地方显示ToC。即它是隐藏toctree，而不是其文档。隐藏的toctree中的文档仍将在HTML边栏，PDF书签等中可见。

您似乎需要rubric directive。专栏就像一个小节，但没有组成目录。