brechtm
commented
1 year ago There is no support for embedding files in the generated PDF. At least not yet, but it's not on the planning either.
You can link to files on a website, but that might not be appropriate for all use cases. And that is unfortunately not straightforward to configure. I happen to have run into this requirement recently: linking to a sample PDF document from the showcase section of the rinohtype manual. This works because in this case it's possible to predict the URL of where this sample PDF will be hosted. The following may be of limited use to you, but practically I implemented this by means of the extlinks directive. This is the relevant code:
- extlinks setup in conf.py
- example use of the showcase role in showcase.rst
- because the file isn't being referenced in a traditional manner, I need to copy the sample PDF to the HTML build directory myself
The download role would be a good candidate for representing files to be embedded in a PDF. I haven't looked into whether that's even possible, and I'm not a fan of how the HTML backend implements support for this role.
marklees-seab
techauthoruk
I'm not sure this is possible (!), but when I generate my Sphinx content, I often have links to other documents (pdf mainly). In the HTML output, this is fine - the pdf files are in the
_staticdirectory, and all the links work fine.However...when I create a pdf version (rinohtype or LaTeX - same thing applies), the links to the pdf document don't work because its looking for a directory that doesn't exist. How can this be worked around?
I can manually edit the rinohtype output in Acrobat and embed the linked pdfs, but is there an easier and more graceful way of doing this? Its ok to edit in Acrobat with a small document. but it becomes very problematic on multi-page Sphinx source with many linked pdf files.
Is there a way around this? Open to suggestions!