# Building the player documents [Back to the project README](../../../README.md) ## Player handbook Build the player-facing edition with its predefined chapter exclusions: ```sh typst compile --input preset=player-handbook player_handbook.typ player-handbook.pdf ``` Select any theme from `setup/theme/themes.typ` with the `theme` input: ```sh 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: ```sh 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: ```sh 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: ```sh 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: ```sh typst compile --input preset=player-handbook cookbook.typ cookbook.pdf ``` The cookbook also accepts the shared `theme` input: ```sh typst compile --input preset=player-handbook --input theme=steel \ cookbook.typ cookbook-steel.pdf ```