Pages are written using reStructuredText, because it is way nicer than raw HTML.
A custom Python builder converts RST to HTML (using pandoc and jinja templating),
which gives me great control over how I write content. For every page there is a
.meta
file providing basic information for the page, where to store it, what
to template to use, etc.
$ poetry shell
$ poetry install
$ make build runserver
Note: despite the Python virtual env, you still need to install a recent version of pandoc because pypandoc is only a wrapper around it.
The sources are committed under docs/
to be deployed through GitHub pages.
The content of this website is licensed under the Creative Commons license, and the source code in this project is licensed under the MIT license.