datatheque

Hugo Docs

Start Jupyter

workon venv_notebooks
jupyter notebook notebooks

Convert Notebook to HTML

jupyter nbconvert --to html --template basic notebook.ipynb

Start Hugo

-D to include drafts

hugo server -D

Create a new Post

hugo new posts/new-post.md

Add Notebook to Post

Insert the following in the content of your post (after the front matter)

{{< readfile file="notebooks/notebook.html" >}}

Generate Site

Don't forget to toggle draft to false in front matter to make post public

hugo

Publish

Hugo publishes the site to the docs directory and Github is set up to serve the site there. Once the docs directory has been committed, pushing to Github will publish the site.