/self¶

Sphinx is the backbone of this blog. Don’t ask me why I originally chose it instead of the million other static-website-generators out there. It works fine. I made a Sphinx extension just for this blog and that handles the features I’ve added like tags and the archive.

I’ll write more about it at some point.

Todo¶

resample all images to be smaller in the main text
make images clickable to open in full size
add an RSS feed
add webmentions
fix markdown checkboxes to render as checked/unchecked icons in html. (looks good now)
make the source link work for more files, not just ipynb. (now also works for markdown)
create yearly archive of all posts
make dark and light mode css look good
make every post show links to a few other recent posts
make the archive link on each blog post anchored to the right place in the archive list. (works and also highlights it. looks good. i didn’t make it do that)
add tag description to each tag page.
write something instead of just playing with the blogging software

Features of this blog¶

Dark/Light theme¶

I think they both look great 😊 I took heavy inspiration from other blogs that I liked. The switch between light and dark is a CSS media query. No fancy personalized javascript widget or anything like that.

Archive¶

The archive shows a list of all blog posts in order of newest at the top. The links in the list are fancy blog post links with a picture and description and tags.

Tags¶

Tags are working fine but I’m not completely sure how I should use them. I have a few tags now that I think are useful but I don’t want to have a bunch of very specific tags with just one or two posts in them. I also added a small description of what the tag is on each tag page.

Source¶

There is a link at the top of every post to the ipynb/md source of that post. Unsure if it’s useful. The ipynb sources are huge since they include a base64 string of all images. The markdown sources look nice.

Fancy blog post links¶

This is probably the single biggest change I made to the blog software I use. It’s mostly Sphinx and nbsphinx but I changed it a bit to display the links differently and with more information (tags, date, description). I think it looks really good.

Favicon¶

[3]: