Skip to content

Colophon 0.2.0

Choose a tag to compare

@0then0 0then0 released this 04 Nov 15:05
· 10 commits to main since this release

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 property snoozed_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 a kind that 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 another config.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 readingDays function.
  • install.mjs, a dependency-free installer (Node 20+) in the release archive: plan by default, --apply to write, no
    overwriting without --force, safe to repeat, never touches .obsidian. npm run build:release builds the
    reproducible archive (docs/INSTALL.md is included).
  • import-goodreads.mjs: imports a Goodreads CSV export as book notes (dry run by default, no dependencies, no network;
    recognises books by goodreads_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.js and config.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.