Sphinx: Linking to Embedded Binary Files (PDFs)

Question

I\'m using sphinx and RST to generate some tech documentation as HTML and having issues getting a local PDF reference to work as a hyperlin

Answer 1

The solution I came up with was to just add the PDFs to html_static_path and reference the _static output path in the link instead of the docs path where it lives in the source. Now PDFs open up in the browser instead of having to download them to view.

Would be great if there was an sphinx extension / directive to handle this (:download-inline:).

conf.py

html_static_path = ['_static', 'agile-101/docs']

agile-101.rst

.. important:: View the agile course on scrum basics

- View `these slides to dive deeper into Agile Basics <../_static/agile-101.pdf>`_.