From 0590035a53afbded6351849094f80cd057f6d0ad Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Thu, 20 Aug 2026 16:31:51 +0200 Subject: [PATCH] Adds a prelude --- chapters/artisanat.typ | 4 +--- chapters/craft/armurerie.typ | 3 +-- chapters/craft/traps.typ | 3 +-- chapters/creation.typ | 3 +-- chapters/creation_primaire.typ | 2 +- chapters/experience_gains.typ | 3 +-- chapters/game_master_help.typ | 3 +-- chapters/rules/regles_alteration.typ | 3 +-- chapters/rules/regles_base.typ | 3 +-- chapters/rules/regles_combat.typ | 3 +-- chapters/rules/regles_competences.typ | 3 +-- chapters/rules/regles_damagetype.typ | 3 +-- chapters/rules/regles_fatigue.typ | 3 +-- chapters/rules/regles_predation.typ | 3 +-- chapters/rules/regles_projectiles.typ | 3 +-- chapters/rules/regles_rodeo.typ | 3 +-- chapters/rules/regles_soins.typ | 3 +-- chapters/rules/regles_transcendance.typ | 3 +-- setup/_info.md | 10 ++++++---- setup/prelude.typ | 24 ++++++++++++++++++++++++ 20 files changed, 48 insertions(+), 40 deletions(-) create mode 100644 setup/prelude.typ diff --git a/chapters/artisanat.typ b/chapters/artisanat.typ index 8c42457..c69a63b 100644 --- a/chapters/artisanat.typ +++ b/chapters/artisanat.typ @@ -1,6 +1,4 @@ -#import "/setup/setup.typ": ddlvl, hunbal, macros -#import "/setup/theme/boxes.typ": * -#import "/setup/theme/tables.typ" as st +#import "/setup/prelude.typ": * #let ref(reference) = [Voir @#reference @#reference:name] diff --git a/chapters/craft/armurerie.typ b/chapters/craft/armurerie.typ index e1b63e6..fd80584 100644 --- a/chapters/craft/armurerie.typ +++ b/chapters/craft/armurerie.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": csv-table, ddlvl -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * #import "/setup/core/macros.typ": bigscope, sA, sS, sW #let scope = bigscope diff --git a/chapters/craft/traps.typ b/chapters/craft/traps.typ index ae3652b..d07562c 100644 --- a/chapters/craft/traps.typ +++ b/chapters/craft/traps.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": csv-table, ddlvl, macros, st -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * Les pièges correspondent au besoin primordial des chasseurs de s'accaparer une partie de la dynamique du combat, même si seulement pour un court instant. La préparation de ces derniers bien que difficile et parfois modérément efficace, reste primordiale dans l'arsenal du chasseur. diff --git a/chapters/creation.typ b/chapters/creation.typ index adb9109..53131c9 100644 --- a/chapters/creation.typ +++ b/chapters/creation.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * = Création == Création de personnage diff --git a/chapters/creation_primaire.typ b/chapters/creation_primaire.typ index 0a5fd21..5c8e218 100644 --- a/chapters/creation_primaire.typ +++ b/chapters/creation_primaire.typ @@ -1,4 +1,4 @@ -#import "/setup/setup.typ": ddlvl, hunbal, macros, ravhelp +#import "/setup/prelude.typ": * === Calcul des statistiques ==== Chasseur diff --git a/chapters/experience_gains.typ b/chapters/experience_gains.typ index 755672b..c3be6e6 100644 --- a/chapters/experience_gains.typ +++ b/chapters/experience_gains.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * = Gains d'expérience et Progression == Absorption du sang et gain d'expérience diff --git a/chapters/game_master_help.typ b/chapters/game_master_help.typ index f8dbce4..0e7f695 100644 --- a/chapters/game_master_help.typ +++ b/chapters/game_master_help.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * = Aide au MJ == De la nature des discutions lors d'une partie diff --git a/chapters/rules/regles_alteration.typ b/chapters/rules/regles_alteration.typ index a58582e..868270e 100644 --- a/chapters/rules/regles_alteration.typ +++ b/chapters/rules/regles_alteration.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, kw, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Altération d'état diff --git a/chapters/rules/regles_base.typ b/chapters/rules/regles_base.typ index 1a2ae9e..be7dd9d 100644 --- a/chapters/rules/regles_base.typ +++ b/chapters/rules/regles_base.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Règles de base diff --git a/chapters/rules/regles_combat.typ b/chapters/rules/regles_combat.typ index b32edb0..60e8d65 100644 --- a/chapters/rules/regles_combat.typ +++ b/chapters/rules/regles_combat.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, kw, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Règles en combat diff --git a/chapters/rules/regles_competences.typ b/chapters/rules/regles_competences.typ index b8a13c2..611d647 100644 --- a/chapters/rules/regles_competences.typ +++ b/chapters/rules/regles_competences.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Compétences, équipements, réalisme, rapidité diff --git a/chapters/rules/regles_damagetype.typ b/chapters/rules/regles_damagetype.typ index 33e0fec..63ae497 100644 --- a/chapters/rules/regles_damagetype.typ +++ b/chapters/rules/regles_damagetype.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, kw, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Types de dégâts diff --git a/chapters/rules/regles_fatigue.typ b/chapters/rules/regles_fatigue.typ index 50a0a53..88eb9bd 100644 --- a/chapters/rules/regles_fatigue.typ +++ b/chapters/rules/regles_fatigue.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Fatigue diff --git a/chapters/rules/regles_predation.typ b/chapters/rules/regles_predation.typ index d0d2b1b..23e98dd 100644 --- a/chapters/rules/regles_predation.typ +++ b/chapters/rules/regles_predation.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * #import "@preview/fletcher:0.5.8" as fletcher: diagram, edge, node #let bubble-size = 10mm diff --git a/chapters/rules/regles_projectiles.typ b/chapters/rules/regles_projectiles.typ index 9c71153..db2adec 100644 --- a/chapters/rules/regles_projectiles.typ +++ b/chapters/rules/regles_projectiles.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Dégâts de projectiles improvisés diff --git a/chapters/rules/regles_rodeo.typ b/chapters/rules/regles_rodeo.typ index 8c7589a..5a069fc 100644 --- a/chapters/rules/regles_rodeo.typ +++ b/chapters/rules/regles_rodeo.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, kw, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Saisies, rodéos et chevauchée diff --git a/chapters/rules/regles_soins.typ b/chapters/rules/regles_soins.typ index eed7347..7b243df 100644 --- a/chapters/rules/regles_soins.typ +++ b/chapters/rules/regles_soins.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Soins et médecine Le concept de soins pour les enfants des calamités est un peu particulier, capables de digérer sans broncher des substances qui plieraient de douleur un homme ordinaire, capables de régénérer des membres entiers en quelques semaines de convalescence, le point central de la médecine pour les enfants des calamités devient donc une alimentation abondante, et beaucoup de repos. diff --git a/chapters/rules/regles_transcendance.typ b/chapters/rules/regles_transcendance.typ index a90ebe5..0e701bf 100644 --- a/chapters/rules/regles_transcendance.typ +++ b/chapters/rules/regles_transcendance.typ @@ -1,5 +1,4 @@ -#import "/setup/setup.typ": ddlvl, macros -#import "/setup/theme/boxes.typ": * +#import "/setup/prelude.typ": * == Transcendance diff --git a/setup/_info.md b/setup/_info.md index fcc7e72..a0a3123 100644 --- a/setup/_info.md +++ b/setup/_info.md @@ -1,11 +1,13 @@ This directory contains the Typst modules shared by the rulebook. -- `setup.typ` is the stable public facade used by most chapters. +- `setup.typ` is the stable complete facade and document entry point. +- `prelude.typ` is the curated chapter-authoring surface and can be imported + with `#import "/setup/prelude.typ": *`. - `core/` contains project-wide macros and rule constants. - `generation/` turns external data into Typst content. - `models/` contains document and domain-specific presentation models. - `theme/` contains colors, symbols, tables, boxes, and decorations. -Prefer importing from `setup.typ`. Import an implementation module directly only -for specialized renderers or helpers that are intentionally not part of the -global facade. +Prefer `prelude.typ` while writing ordinary rules and prose. Import from +`setup.typ` or an implementation module explicitly for document configuration, +specialized renderers, warnings, build metadata, or theme internals. diff --git a/setup/prelude.typ b/setup/prelude.typ new file mode 100644 index 0000000..b5fa791 --- /dev/null +++ b/setup/prelude.typ @@ -0,0 +1,24 @@ +// Common chapter-authoring surface. +// +// Keep specialized models, document configuration, warnings, build metadata, +// and theme internals explicit at their call sites. +#import "setup.typ" as setup +#import "theme/boxes.typ" as boxes + +// Rule notation and shared data. +#let ddlvl = setup.ddlvl +#let hunbal = setup.hunbal +#let kw = setup.kw +#let macros = setup.macros +#let symbols = setup.symbols + +// Common prose helpers. +#let ravhelp = setup.ravhelp +#let inline_help = setup.inline_help +#let ravex = boxes.ravex +#let ravtwoex = boxes.ravtwoex +#let ravbox = boxes.ravbox + +// Common table and data-driven content helpers. +#let st = setup.st +#let csv-table = setup.csv-table