#python-sphinx #pdflatex
#python-sphinx #pdflatex
Вопрос:
Используя генератор документации Sphinx (с pdflatex), я создаю PDF-файлы и добавил ссылки на некоторые внутренние файлы, используя label и ref разметки, подобные этой:
В вызываемом файле (xyz.rst)
.. _called-file-label:
В вызывающем файле (abc.rst) я добавляю ссылку на label вот так:
:ref:`Get Info <called-file-label>`
При вышеупомянутом расположении я могу сгенерировать PDF-файл с помощью pdflatex. Однако я обнаружил, что вызываемый файл также добавляется в раздел закладок PDF-файла, который кажется несколько неуклюжим.
Я понимаю, что мне нужно добавить оба исходных файла в .. toctree:: раздел, чтобы гиперссылка появилась в pdf-файле (я добавил вызываемый файл, используя :hidden: директиву, чтобы предотвратить отображение файла в дереве оглавления html-документа).
Мой вопрос таков: что мне нужно сделать, чтобы вызванный файл (xyz.rst) не фигурировал в разделе закладок сгенерированного PDF-файла?
Комментарии:
1. Я бы не пытался что-то скрыть в документе PDF. Используйте что-то вроде добавления / appendix section вместо скрытия элементов из закладок.
Ответ №1:
Если после .. _called-file-label: метки находится раздел:
.. _called-file-label:
Foo Bar
======
Тогда заголовок раздела «Foo Bar» всегда будет закладкой в PDF.
:hidden: Вариант toctree заключается не в том, чтобы скрывать документы, а в том, чтобы не показывать ToC в месте с toctree . Т.е. это скрыть toctree, а не его документы. Документы в скрытом toctree по-прежнему будут видны в боковых панелях HTML, закладках PDF и т.д.
Похоже, вам нужна директива categorication. Рубрика похожа на раздел, но не составляет оглавление.