Opuscula

Recreational and semi-formal writings by K. Ritsuka, published at opuscula.ritsuka.moe.

This repository contains the complete standalone Opuscula site: sources, compiled documents, publication notes, and web pages. Each writing occupies one directory, while the repository root supplies the collection catalogue and shared site assets.

The catalogue and publication pages come from shared Eta templates. A writing has one record in src/data/writings.json; that record produces both its catalogue entry and its publication page, so their structure stays consistent as the collection grows.

Building

The site generator requires Node.js 20 or later. Install its pinned dependency once:

npm ci

Then build every document and regenerate every web page:

make

Useful narrower commands are:

npm run build                         # regenerate web pages only
npm run check                         # fail if generated pages are stale
make -C euler-derangement-cloze       # build one writing
make -C euler-derangement-cloze clean # clean one writing

The root Makefile automatically discovers writing directories that contain a Makefile. Individual documents use latexmk -xelatex; see each writing's README for its exact commands and prerequisites.

Adding a writing

1. Create a URL-safe directory for the writing and give it a Makefile.
2. Add one record, in numerical order, to src/data/writings.json. Its slug must match the directory name.
3. Run make. The generator checks that referenced PDFs and LaTeX sources exist, then regenerates the root catalogue and every publication page.
4. Review and commit the source, documents, and generated HTML together.

Edit src/data/site.json for collection-wide prose, and edit the files under src/templates for shared structure. The root index.html and each writing's index.html are generated files and should not be edited directly.

GitHub Pages serves the committed output without a server-side build. The .nojekyll and CNAME files select static publishing and the opuscula.ritsuka.moe custom domain.