How To Avoid :hidden: Source File From Getting Added As Bookmarks In Sphinx Pdflatex Generated Pdf File

Using Sphinx documentation generator (with pdflatex), I am creating pdf files and have added links to some of the internal files using label and ref markups like this: In the calle

Solution 1:

If after .. _called-file-label: label is section:

.. _called-file-label:

Foo Bar
======

Then, the section title "Foo Bar" will always become a bookmark in PDF.

The :hidden: option of toctree is not to hide documents, but to don't show ToC on the place with toctree. I.e. it is to hide toctree, not its documents. Documents in hidden toctree will still be visible in HTML sidebars, PDF bookmarks, etc.

It looks like you need rubric directive. Rubric is like a section, but doesn't make up the table of contents.