sphinx-simplepdf icon indicating copy to clipboard operation
sphinx-simplepdf copied to clipboard

`html_extra_path` to copy the custom file to the simplepdf build root directory

Open sachin-suresh-rapyuta opened this issue 3 years ago • 1 comments

Is there a html_extra_path configuration option in simplepdf?

For example, if I want to copy a custom file, say test.html to the html's build root directory, in conf.py, I can do so by:

html_extra_path = ['user/test.html'] //user/test.html gets copied to build/html

How to achieve this for simplepdf? i.e., to copy user/test.html to /simplepdf

sachin-suresh-rapyuta avatar Jan 31 '23 08:01 sachin-suresh-rapyuta

This is not supported, as Sphinx-SimplePDF needs a single HTML file, which is created by Sphinx.

I don't know if there is a mechanism inside Sphinx, which can merge the Sphinx-SingleHTML output with data from additional HTML files. I would guess not, as this is quite complex and use case specific.

Maybe a better approach would be to use the Sphinx Jinja Template system to define additional HTML content for the later SingleHTML build.

danwos avatar Jan 31 '23 09:01 danwos