- TeX 60.3%
- Python 30.2%
- JavaScript 5.5%
- HTML 2.7%
- CSS 1.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| books | ||
| collections | ||
| discovery | ||
| docs | ||
| scripts | ||
| site | ||
| tools/fieldscan | ||
| .gitignore | ||
| formatio_idearum_interlinearis.aux | ||
| formatio_idearum_interlinearis.log | ||
| formatio_idearum_interlinearis.out | ||
| formatio_idearum_interlinearis.pdf | ||
| formatio_idearum_interlinearis.tex | ||
| Formatio_idearum_per_densas_coertiones.json | ||
| Formatio_idearum_per_densas_coertiones.mp3 | ||
| Formatio_idearum_per_densas_coertiones.srt | ||
| Formatio_idearum_per_densas_coertiones.tsv | ||
| Formatio_idearum_per_densas_coertiones.txt | ||
| Formatio_idearum_per_densas_coertiones.vtt | ||
| index.html | ||
| LICENSE | ||
| README.md | ||
| scriptorium-infographic.png | ||
| structural_ideas.pdf | ||
| structural_ideas.tex | ||
Scriptorium
A durable, metadata-driven public catalogue for Flyxion works and executable Book Machines.
Current public surfaces
- Formatio idearum interlinearis
- Formatio idearum per densas coertiones — Audio Overview
Catalogue infrastructure
Repository layout is data-first:
books/— per-work metadata, covers, and publication artifactstools/— per-tool metadata and optional static browser applicationscollections/— subject taxonomyscripts/— validation/build/catalogue toolingsite/— static assets and templatesdist/— generated website outputdocs/publishing_model.md— publishing workflow and schemadocs/work-edition-artifact-architecture.md— Work ↔ Tool architecture with Work → Edition → Artifact publication structure
Build and validate
From /home/runner/work/scriptorium/scriptorium:
python scripts/validate.py
python scripts/build.py
This generates a static catalogue where Library and Tools pages derive from metadata records rather than hand-coded pages.
Discovery-first intake
Before manually adding new records under books/, run archaeology discovery from the profile README and repository corpus:
python scripts/discover.py
This generates review-ready candidate datasets in /home/runner/work/scriptorium/scriptorium/discovery/output/ without publishing them.
Publishing a New Work
From /home/runner/work/scriptorium/scriptorium:
python scripts/add-book.py /path/to/book --id book-slug
python scripts/validate.py
python scripts/build.py
After add-book.py, update the generated books/<work-id>/book.json and books/<work-id>/description.md as needed, then rerun validate/build.
Adding a New Tool (Book Machine)
Create a metadata-driven tool folder:
tools/
<tool-id>/
tool.json
description.md
app/ # optional static browser app assets
Minimum tool.json fields:
idtitletype(simulator,explorer,calculator,visualizer,experiment)status(experimental,prototype,stable,archived)platform(web,desktop,cli,notebook,other)descriptiontopics(non-empty list)entrypoint(absolute path under/tools/<tool-id>/)
Optional relationship/provenance fields:
related_works(many-to-many links intobooks/)inspired_by(bibliographic/provenance records, not Scriptorium-owned Works)
Then run:
python scripts/validate.py
python scripts/build.py
Generated pages include /tools/ and /tools/<tool-id>/.
