Recently, I have been thinking more and more about collecting all the bits and bobs,the tools and the snippets of code I have assembled over the years, and to put it all into a single document. I have seen other people putting their lecture material online in the form of a jupyter book, for example Ryan Abernathy’s Earth and Environmental Data Science or Brian Rose’s Climate Laboratory.

What I like about jupyter books, in particular, is that you can integrate your code snippets and the output will be automatically rendered as HTML content. A nice little side effect of it is that you will know whether your code works or not. A little bit like unit testing in software development.

jupyter {book} feature list:

What I haven’t figured out, yet, is how to integrate the HTML content into Jekyll, a framework that GitHub Pages uses for turning Markdown files into a website (like this one). I would like to have that content on a subdomain.

Wait and see.