Repository navigation
Colophon 0.2.0
Added
- Clickable statistics: a click on a number (the cards, a month, the topics of a year, the bars of the detailed
breakdowns) opens the list of its books under it. The authors breakdown shows "3 of 5" and lists all books of the
author. - A better "What to read next" (
Colophon/recommend.js, tested in Node): smoothed averages, a penalty for abandoned
books, a block "Continue a series", links between notes as a reason, a small bonus for books that waited long, three
fiction and three non-fiction picks with at most one book per author, a monthly rotation, filters, and the buttons
"Add to queue" and "Not now". "Not now" writes the new optional propertysnoozed_until. - Settings for your own statuses, formats and categories in
Colophon/config.json(statuses,formats,
categories). Labels per language fall back to English, then to the key. Custom statuses have akindthat decides
their behaviour. Mistakes in the file are reported on the page and by the checks. Without the new sections nothing
changes. node tools/build-localized.mjs --config <file> --out <folder>generates the Library base, template and statistics
note for anotherconfig.json.- Reading time on the book page: days from start to finish for a finished book ("Same day" for a one-day read), days so far for a book in progress. The statistics use the same
readingDaysfunction. install.mjs, a dependency-free installer (Node 20+) in the release archive: plan by default,--applyto write, no
overwriting without--force, safe to repeat, never touches.obsidian.npm run build:releasebuilds the
reproducible archive (docs/INSTALL.mdis included).import-goodreads.mjs: imports a Goodreads CSV export as book notes (dry run by default, no dependencies, no network;
recognises books bygoodreads_id, so a second run creates nothing). Shelves become categories only through a map file.
Try it on a copy of your vault first.- A shared validation of one book note (
tools/note-validation.mjs) used by the example vault check and the importer tests. tools/generate-synthetic-library.mjs: a seeded generator of synthetic libraries for performance and layout checks.- Node tests for the settings logic and the generator (
npm test).
Fixed
- A long series or author name on the book page wraps instead of running off a narrow screen (seen in German).
- The "Edit properties" and "Read again" buttons use the muted text color, which keeps a readable contrast on the themes
that were checked. - Month labels of the statistics chart fit a narrow screen in Japanese (month numbers are used where the language has no
one-character month name).
Changed
- The lists of statuses, formats and categories now come from one place (
Colophon/model.jsandconfig.json) in the
views, the form, the Library generator and the example vault check.
Install: unpack the archive and run node install.mjs <vault> (see INSTALL.md). Checksum in the .sha256 file.