descriptionA static site for tracking the books I've read
last changeSat, 4 Dec 2021 09:20:48 +0000 (09:20 +0000)
readme

books.alexwlchan.net

This is the source code for https://books.alexwlchan.net, a site I use to track the books I've read. This repo contains both the scripts that build the site, and the source data used by the scripts.

How it works

Each book is a text file, with a bit of metadata at the top, and Markdown text in the body. Here's an example:


book:
  title: Trans Like Me
  author: C. N. Lester
  publication_year: 2017
  cover_image: trans-like-me.jpg
  cover_desc: >
    The words “trans like me” in lowercased, large letters, set on a slightly off-white background.
    The words “trans” and “me” are in red; the word “like” is in black.
  isbn13: 9780349008608

review:
  date_read: 2020-01-27
  rating: 5
  format: paperback
---

I put off reading this for ages, but I’m glad I finally got to reading it.

When I run the build script, it reads all these files, and turns them into a set of HTML files. I upload a copy of those HTML files to my web server, where they're served by nginx.

Why...?

shortlog
41 hours ago Alex ChanAdd an entry for "Cosmogramma" development
41 hours ago Alex ChanFix a bug in the tint colour code
3 days ago Alex Chanmore aggressive caching and lazy imports
3 days ago Alex Chando the sync manually rather than shelling out to rsync
3 days ago Alex ChanThrow a caching layer in front of the Markdown parsing
3 days ago Alex Chanfix a css issue on narrow screens
3 days ago Alex Chanremove a script I never use
4 days ago Alex Chanspeed up deploys
4 days ago Alex ChanAdd an entry for "The Box in the Woods"
4 days ago Alex Chandefer a bunch of expensive imports
4 days ago Alex Chanuse the hex strings for colours
4 days ago Alex ChanOnly fetch the templates when we use them
4 days ago Alex ChanStart putting the tint colour in the book metadata
4 days ago Alex Chanmore idiomatic use of pathlib.Path.exists()
4 days ago Alex Chanonly render pages that have changed
4 days ago Alex Chanrun black over the render_html script
...
heads
41 hours ago development
2 months ago to-jekyll