Print link targets in PDFs?

[jkfindeisen]

It depends on what the auto-created PDF is used for. If it is used electronically the default configuration is fine (links are clickable). If a printed manual is desired it's better to print the link targets. There are two options: right after in the text or as footnote.

See http://www.sphinx-doc.org/en/1.5.1/config.html#latex-options for configuration of latex output of sphinx (which does the pdf).

For example change latex_show_urls = False to latex_show_urls = 'footnote' in conf.py.

The auto-created pdf are at http://readthedocs.org/projects/imspectordocs/downloads/pdf/latest/.

[jkfindeisen]

Another small hint. PDFs look different (and better) when created locally ("make.bat latex" then using miktex for example) than with readthedocs. For example one has line wrapes in code sections with this method but not with readthedeocs created pdfs.