ravenous_typst/docs/builds/player
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 player documents

Back to the project README

Player handbook

Build the player-facing edition with its predefined chapter exclusions:

typst compile --input preset=player-handbook player_handbook.typ player-handbook.pdf

Select any theme from setup/theme/themes.typ with the theme input:

typst compile --input preset=player-handbook --input theme=steel \
  player_handbook.typ player-handbook-steel.pdf

Sections can be toggled with comma-separated chapter IDs. chapters is an allow-list; disabled_chapters removes entries from it, or from the default set when no allow-list is supplied:

typst compile --input preset=player-handbook \
  --input chapters=title,origins,schools,rules \
  --input disabled_chapters=rules \
  player_handbook.typ player-handbook-classes.pdf

origin-lore and origin-artwork control the lore quotations and images inside origins. The player preset hides origin-lore by default:

typst compile --input disabled_chapters=origin-artwork \
  player_handbook.typ player-handbook-without-origin-art.pdf

When using the chapters allow-list, include origin-artwork alongside origins to retain images. The preset can also be combined with independent origin and school selectors:

typst compile \
  --input preset=player-handbook \
  --input origin=dragon_1 \
  --input school=artilleur \
  player_handbook.typ dragon-1-artilleur-handbook.pdf

origin and school default to an empty string, which includes every entry. Origins identify individual YAML variants such as dragon_1, dragon_2, or guivre_1. Invalid identifiers fail compilation with an explicit error.

Persistent settings live in data/config/build.yaml. Edit build.disabled_chapters, or add an entry under presets, for a reusable edition. Chapter IDs are the names passed to chapter-enabled in main.typ.

Cookbook

Build the standalone collection of crafting recipes with the player preset:

typst compile --input preset=player-handbook cookbook.typ cookbook.pdf

The cookbook also accepts the shared theme input:

typst compile --input preset=player-handbook --input theme=steel \
  cookbook.typ cookbook-steel.pdf