warr.in

Most of the personal static content I want to put on the Internet. Built with Pelican.

Development

Install and use pre-commit git hooks.

Install the requirements:

pip install -r requirements.txt

List and use the PyInvoke commands:

inv --list

Theme

I'd like to just inherit the simple theme, but they don't wrap everything in block so I can't customize as much as I want. This means that some settings in the docs won't work because I removed the places the variables are read.

All non-blogpost files (including index.html) will be generated from the page.html template. All blogpost files will be generated from the article.html template. This means we don't need an index.html template.

Design Graveyard

Embed Jupyter Notebooks

It'd be neat to use a plugin to embed Jupyter Notebooks in blog posts. The main problem is that making the Notebook CSS play well with our site CSS wasn't straightforward, and while I could use some hacks I didn't want to depend on a static nbconvert version (nbconvert chooses the CSS version). I can revisit this if there's more documentation and stability around Jupyter Notebook CSS classes.

Alternatively, I could convert to Markdown and then style the input/output cells myself. I didn't want do that.