ravenous_typst/docs/builds/master
Dandaedre cae9da04c8
Build Successful The Ravenous rulebook, changelog, player books, master handbook, and balance reports were built successfully.
Ravenous/ravenous_typst/pipeline/head This commit looks good Details
Sub readmes
2026-08-25 20:24:25 +02:00
..
README.md Sub readmes 2026-08-25 20:24:25 +02:00

README.md

Building the master documents

Back to the project README

Master handbook

Build the complete master handbook:

typst compile master_handbook.typ master_handbook.pdf

To work on one creature without rendering every bestiary entry, pass its database ID through creature_id:

typst compile --input creature_id=3 master_handbook.typ creature-3.pdf

The master handbook automatically enables its master-only glossary entries. An unknown ID, or an ID not visible to the master, produces an explicit error.

For a persistent local selection, set build.creature_id in data/config/build.yaml. Keep it empty to render every master-visible creature:

build:
  creature_id: "3"

Test trusted database markup and glossary evaluation for every creature, or for one selected entry, with:

tools/check_creature_eval.sh
tools/check_creature_eval.sh 3

Master screen

Build the four-panel portrait reference screen with:

typst compile master_screen.typ master_screen.pdf

Its summaries are declared beside the rules they describe and imported by both the standalone PDF and the master-screen chapter of the complete book. Disable that chapter through the normal disabled_chapters configuration. The player-handbook preset excludes it by default.

Protected CI artifacts

CI compiles plaintext versions of both documents, protects them with qpdf and MASTER_PASSWORD, deletes the plaintext intermediates, and publishes only the encrypted master-facing artifacts.