February 20, 2019

Logging books in TiddlyWiki

For the past several years I’ve maintained a text file listing all of the books that I’ve read. The simple text format makes it easy to, for example, quickly see that I read 27 books in 2017 by doing something like…

grep "2017-" books.md | wc -l

This is neat, but otherwise not terribly useful. Given my recent fascination with TiddlyWiki, I figured I’d try logging my books there.

I started by recreating my original list in a single tiddler but other than having them in my wiki it didn’t offer any advantages.

What I ended up doing was to create a template” tiddler for books. The template looks like this…

Book templateBook template

I then created a button for easily adding a new Book tiddler. The Add a book” button is rendered using the following macro…

Add book macroAdd book macro

It looks like this in the wiki…

Book buttonBook button

New Book tiddlers created with the Add a Book button are automatically tagged with Book” and include fields for startdate, enddate, and goodreads. Those fields are used by the template so that each book tiddler is rendered showing dates and a link to Goodreads.

To include the template in a tiddler, I add the following…

This transcludes the custom view template like this…


Including that templates ensures that all book tiddlers contain at least the Notes” section at the end. And they’re formatted consistently.

Storing the start/enddates in custom fields allows them to be used in other ways. Next up will be to show the enddate right in the list of books.

Here is the result

This makes me want to go back and add all of my books as individual tiddlers, but that may be a while.

books tiddlywiki

Previous post
Do We Write Differently on a Screen? Tim Parks, The New Yorker: Write it and expect a response in hours. In minutes. You write the first chapter of a book and send it at once to four
Next post
Why’dya do it, Steve? MacJournal: Still the best notebook for MacOS I will not download the MacJournal v7 beta. I will not download the MacJournal