如何解决如何避免:hidden:源文件被添加为Sphinx pdflatex生成的pdf文件中的书签
使用Sphinx文档生成器(带有pdflatex),我正在创建 pdf文件,并使用label
和ref
标记将链接添加到某些内部文件中,如下所示:
.. _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。专栏就像一个小节,但没有组成目录。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。