How to Download HTML file to share

[KMac0615]

Hello. I am trying to use jupyter book to generate a single HTML file to share with my team. I am working in JupyterHub and can build the file just fine using jb build my_file.ipynb. When I click on the generated HMTL file, it opens in my browser and everything is rendered fine. However, I am trying to download the HTML file from JupyterHub to share. When I download and open the file in a browser, nothing is rendered correctly. None of my graphs show up, I just see "_images/my_file.png". I see paragraph symbols after my section headers. It is not showing up at all like it does when I open it from JupyterHub.

Side note, I cannot share this report through GitHub, or any other version control, as it contains sensitive information so this is not allowed by my company. I am looking for a better way of generating a report from an ipynb than having to save my graphs as images and embed them into a markdown cell in my notebook. Jupyter book seemed like a good answer to this issue so any help on being able to download and share the generated HTML files is greatly appreciated! Thank you.

[choldgraf]

ah - that's because it's not generating a single HTML file, it is generating a collection of files (AKA a website). Generating a single HTML file is more difficult because you'd have to embed all of the assets needed to make it up (CSS files, JS files, images, etc), and right now this isn't supported. So to share a notebook as a single file, your best bet is to use a PDF output via HTML, or to just share the notebook directly. I think it'd be great to support single-HTML building but I'm not quite sure how to accomplish it...

[akhmerov]

Perhaps it's possible to combine a singlehtml builder with other tools that inline HTML resources. A quick search finds a couple of browser extensions and some npm packages, like this one.

[chrisjsewell]

yep good point thanks

[KMac0615]

Thanks all for the quick response! I appreciate the guidance.

[choldgraf]

ah it would be fantastic if we could get a pattern working like what @mmcky and @akhmerov describe. A lot of people would benefit from having a single HTML file to share with others

[choldgraf]

I opened up jupyter-book/jupyter-book#1046 to track this enhancement