如何避免：隐藏：源文件被添加为Sphinx PDF生成的pdf文件中的书签 [英] How to avoid :hidden: source file from getting added as bookmarks in Sphinx pdflatex generated pdf file

问题描述

使用Sphinx文档生成器(使用pdflatex)，我正在创建pdf文件，并使用label和ref这样的标记添加了指向一些内部文件的链接：

在被调用文件(xyz.rst)

.. _called-file-label:

在调用文件(abc.rst)中，我添加了对label的引用，如下所示：

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

通过上面的安排，我能够使用pdflatex生成pdf文件。然而，我发现被调用的文件也被添加到pdf文件的书签部分，这让感觉有点笨拙。

我知道我需要添加.. toctree::部分中的两个源文件才能使超链接出现在pdf文件中(我已经添加了调用的文件Using:hidden:指令，以防止该文件显示在html文档的目录树中)。

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

推荐答案

If After.. _called-file-label:Label is Section：

.. _called-file-label:

Foo Bar
======

然后，分区标题将始终成为PDF中的书签。

toctree的:hidden:选项不是隐藏文档，而是在toctree所在位置不显示TOC。即它要隐藏toctree，而不是它的文档。隐藏目录树中的文档仍将在HTML侧边栏、PDF书签等中可见。

看起来您需要rubric directive。题目类似于一个节，但不构成目录。

这篇关于如何避免：隐藏：源文件被添加为Sphinx PDF生成的pdf文件中的书签的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！