Sovereign 8s.is mirror of standardgalactic/scriptorium
  • TeX 60.3%
  • Python 30.2%
  • JavaScript 5.5%
  • HTML 2.7%
  • CSS 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-08-12 11:31:16 -03:00
books Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
collections Implement metadata-driven publishing catalogue foundation 2026-08-12 12:52:06 +00:00
discovery Add discovery pipeline and curation workflow scaffolding 2026-08-12 13:26:12 +00:00
docs Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
scripts Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
site Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
tools/fieldscan Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
.gitignore Implement metadata-driven publishing catalogue foundation 2026-08-12 12:52:06 +00:00
formatio_idearum_interlinearis.aux Deploying Page 2026-05-05 22:33:08 -03:00
formatio_idearum_interlinearis.log Deploying Page 2026-05-05 22:33:08 -03:00
formatio_idearum_interlinearis.out Deploying Page 2026-05-05 22:33:08 -03:00
formatio_idearum_interlinearis.pdf Deploying Page 2026-05-05 22:33:08 -03:00
formatio_idearum_interlinearis.tex Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.json Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.mp3 Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.srt Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.tsv Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.txt Deploying Page 2026-05-05 22:33:08 -03:00
Formatio_idearum_per_densas_coertiones.vtt Deploying Page 2026-05-05 22:33:08 -03:00
index.html Deploying Page 2026-05-05 22:33:08 -03:00
LICENSE Initial commit 2026-05-05 21:39:13 -03:00
README.md Implement core Tools layer, metadata, and FieldScan 2026-08-12 14:27:04 +00:00
scriptorium-infographic.png Project Overview 2026-08-12 11:22:31 -03:00
structural_ideas.pdf Deploying Page 2026-05-05 22:33:08 -03:00
structural_ideas.tex Deploying Page 2026-05-05 22:33:08 -03:00

Scriptorium

A durable, metadata-driven public catalogue for Flyxion works and executable Book Machines.

Current public surfaces

Catalogue infrastructure

Repository layout is data-first:

  • books/ — per-work metadata, covers, and publication artifacts
  • tools/ — per-tool metadata and optional static browser applications
  • collections/ — subject taxonomy
  • scripts/ — validation/build/catalogue tooling
  • site/ — static assets and templates
  • dist/ — generated website output
  • docs/publishing_model.md — publishing workflow and schema
  • docs/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:

  • id
  • title
  • type (simulator, explorer, calculator, visualizer, experiment)
  • status (experimental, prototype, stable, archived)
  • platform (web, desktop, cli, notebook, other)
  • description
  • topics (non-empty list)
  • entrypoint (absolute path under /tools/<tool-id>/)

Optional relationship/provenance fields:

  • related_works (many-to-many links into books/)
  • 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>/.