Hacker News new | past | comments | ask | show | jobs | submit login

A small suggestion.

Since Jupyter Notebook can be used for both programming and documentation, why don't you use Jupyter Notebook itself as the source of your document?

It is actually very easy to setup a Jupyter Notebook driven .ipynb -> .html publishing pipeline with github + a local Jupyter instance

Here is a toy example (for my own github page)



The convert script is here (also a Jupyter Notebook)


You got the ideas.

BTW, to make the system fully replicable, I use docker for the local Jupyter instance, which can be launched via the Makefile


Here is the custom Dockerfile:


Guidelines | FAQ | Support | API | Security | Lists | Bookmarklet | Legal | Apply to YC | Contact