Add a changelog & live tests
Build Successful The Ravenous rulebook, player handbook, master handbook, and balance reports were built successfully.
Ravenous/ravenous_typst/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-08-25 01:54:59 +02:00
parent ca9db3c2c7
commit 872d2e76a9
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
6 changed files with 285 additions and 2 deletions

19
changelog.typ Normal file
View File

@ -0,0 +1,19 @@
// Standalone changelog build. Keep this wrapper deliberately independent from
// the full book model, which appends the complete project glossary.
#import "/setup/setup.typ": build-config, ravenous, theme, theme-var
// Theme selection (warm, steel, fangdrael, bw, high-contrast, yon-sen, ...):
// typst compile --input theme=steel changelog.typ changelog.pdf
#let changelog-theme = build-config.theme
#set document(title: "Journal des modifications — Ravenous", author: ravenous.copyright)
#set page(
paper: "a4",
margin: (top: 1.8cm, bottom: 1.8cm, left: 2.3cm, right: 2.3cm),
numbering: "1",
)
#set text(font: theme-var("font"), size: 10.5pt, lang: "fr", fill: theme.ink)
#set par(justify: true, leading: 0.7em, first-line-indent: 0em, spacing: 0.65em)
#show strong: it => text(weight: "bold", fill: theme.emphasis, it)
#include "chapters/changelog.typ"

127
chapters/changelog.typ Normal file
View File

@ -0,0 +1,127 @@
// A deliberately compact, data-driven overview of notable content changes.
#import "/setup/setup.typ": theme, theme-var
#let entries = yaml("/data/config/changelog.yaml").filter(
entry => entry.at("display", default: true),
)
#let category-order = ("new rule", "rework", "balance", "bugfix")
#let category-labels = (
"new rule": "Nouvelles règles",
rework: "Refontes",
balance: "Équilibrage",
bugfix: "Corrections",
)
#let category-colors = (
"new rule": theme.heading,
rework: theme.gold,
balance: theme.heading-accent,
bugfix: theme.dark-gold,
)
#let revisions = entries.map(entry => entry.revision).dedup().sorted().rev()
#let participant-pill(name, accent) = box(
inset: (x: 0.45em, y: 0.16em),
radius: 999pt,
fill: accent.lighten(86%),
stroke: 0.4pt + accent.lighten(45%),
text(size: 7.2pt, weight: "medium", fill: accent.darken(8%), name),
)
#let change-entry(entry) = {
let accent = category-colors.at(entry.category)
let participants = entry.at("participants", default: ())
block(
width: 100%,
breakable: false,
inset: (left: 0.7em, top: 0.2em, bottom: 0.2em),
)[
#grid(
columns: (0.85em, 1fr),
column-gutter: 0.25em,
align: (center, top),
text(size: 8.5pt, weight: "bold", fill: accent)[●],
[
#text(size: 9.25pt)[#eval(entry.description, mode: "markup")]
#if participants.len() > 0 {
h(0.35em)
for (index, participant) in participants.enumerate() {
if index > 0 { h(0.18em) }
participant-pill(participant, accent)
}
}
],
)
]
}
#pagebreak(weak: true)
#align(center)[
#text(size: 25pt, weight: "bold", fill: theme.heading)[Journal des modifications]
#v(0.25em)
#text(size: 8.5pt, tracking: 0.08em, fill: theme.heading-accent)[
LES ÉVOLUTIONS ESSENTIELLES DE RAVENOUS
]
#v(0.4em)
#box(width: 3.4cm, height: 0.7pt, fill: theme.heading-accent)
]
#v(0.8em)
#block(
inset: 0.7em,
radius: 5pt,
fill: theme.parchment-accent,
stroke: 0.5pt + theme.border,
)[
#set par(first-line-indent: 0em, justify: false)
#text(size: 9pt, fill: theme.muted-ink)[
Ce journal résume les changements qui modifient sensiblement la lecture ou le jeu.
Les simples reports depuis l’ancienne version TeX et les corrections typographiques
isolées n’y sont volontairement pas détaillés.
]
]
#for revision in revisions {
block(above: 1em, below: 0.4em)[
#grid(
columns: (auto, 1fr),
column-gutter: 0.8em,
align: horizon,
box(
inset: (x: 0.8em, y: 0.35em),
radius: 999pt,
fill: theme.heading,
)[#text(size: 11pt, weight: "bold", fill: white)[#revision]],
line(length: 100%, stroke: 0.7pt + theme.border),
)
]
for category in category-order {
let changes = entries.filter(entry => (
entry.revision == revision and entry.category == category
))
if changes.len() > 0 {
block(above: 1.05em, below: 0.45em)[
#text(
size: 9.5pt,
weight: "bold",
fill: category-colors.at(category),
smallcaps(category-labels.at(category)),
)
#v(0.18em)
#line(
length: 100%,
stroke: 0.55pt + category-colors.at(category).lighten(38%),
)
]
for entry in changes {
change-entry(entry)
v(0.16em)
}
}
}
}

View File

@ -0,0 +1,97 @@
#import "/setup/prelude.typ": *
#import "/setup/setup.typ": theme
= Pistes de test en conditions réelles
#set text(size: 10pt)
#set par(leading: 0.68em, spacing: 0.7em)
#ravhelp[
Cette section rassemble des règles *expérimentales*. Avant la chasse, le
@maitredejeu annonce les critères retenus, les gains correspondants et les
limites de progression. Une fois la partie commencée, ce contrat ne change
plus.
]
== Comprendre la proie
À la fin de la chasse, l'équipe produit un court compte rendu : comportement
observé, mécaniques comprises, signes annonciateurs et réponses efficaces. La
récompense dépend de ce que les joueurs sont capables d'expliquer et d'étayer,
pas de la qualité littéraire du texte ni de ce que leurs personnages étaient
censés savoir.
#table(
columns: (0.65fr, 3.5fr, 1.1fr, 1.25fr),
inset: (x: 5pt, y: 5pt),
align: (center, left, center, center),
fill: (_, y) => if y == 0 {
theme.parchment.lighten(55%)
} else if calc.odd(y) {
theme.parchment.lighten(78%)
} else {
theme.parchment.lighten(92%)
},
stroke: none,
table.header([*Score*], [*Critère vérifiable*], [*Bonus d'XP*], [*Récompense*]),
[—], [Aucun compte rendu, ou seulement des impressions sans observation vérifiable.], [0], [—],
[★], [Identifier correctement une mécanique et citer un fait observé pendant la chasse.], [+1], [★],
[★★], [Décrire au moins deux mécaniques avec, pour chacune, son déclencheur, son effet et une réponse possible.], [+2], [★★],
[★★★], [Expliquer la boucle principale de la créature, ses signes annonciateurs et au moins une faiblesse ou stratégie fiable, avec des observations à l'appui.], [+3], [★★★],
)
Le score est collectif : chaque chasseur reçoit le même bonus d'expérience.
Une information découverte avant le combat compte si les joueurs expliquent
comment elle a été obtenue. Une supposition juste mais sans observation ne
compte pas ; une observation exacte reste valable même si la conclusion tirée
était imparfaite.
== Écoute, restitution et bestiaire
Favoriser l'écoute pendant la chasse et la restitution après celle-ci doit
permettre aux joueurs de construire une connaissance commune. Le
@maitredejeu conserve leurs observations utiles — habitudes, déclencheurs,
variantes régionales, contres et erreurs fréquentes — afin d'enrichir le
bestiaire de la campagne.
Le compte rendu ne doit pas devenir un interrogatoire. Le groupe peut confronter
ses souvenirs et corriger sa réponse avant sa remise. Après l'attribution du
score, le @maitredejeu indique précisément quels critères ont été remplis ou
manqués, sans négocier rétroactivement le barème.
== Contrat de progression
Avant chaque chasse susceptible de provoquer une évolution, noter explicitement :
- le gain de sang de base, ses bonus possibles et son maximum ;
- le gain d'expérience de base, le bonus de compréhension et le maximum total ;
- les conditions permettant ou interdisant le passage au tiers suivant ;
- la part du sang immédiatement dépensable et les éventuels coûts réduits ;
- les récompenses ★, ★★ et ★★★ réellement disponibles pour cette chasse.
#let blank = box(
width: 1.25em,
height: 0.8em,
stroke: (bottom: 0.5pt + theme.muted-ink),
)
#block(
inset: 0.8em,
radius: 4pt,
fill: theme.parchment-accent,
stroke: 0.5pt + theme.border,
)[
#set par(first-line-indent: 0em)
*Fiche de contrat —* Sang : base #blank / bonus #blank / maximum #blank ·
XP : base #blank / compréhension #blank / maximum #blank · Évolution
autorisée : oui / non, si #blank · Récompenses ★ : #blank · ★★ : #blank ·
★★★ : #blank
]
Ces valeurs sont annoncées avant la chasse. Les critères peuvent être remplis
ou non, mais ni leur interprétation ni leur récompense ne sont laissées à une
négociation de fin de partie.
// Restore the main handbook's body settings for content following this include.
#set text(size: 11pt)
#set par(leading: 0.75em, spacing: 0.9em)

View File

@ -0,0 +1,32 @@
- revision: v0.0.2
category: new rule
participants: [Dandaedre]
description: "Ajout d’un véritable *cycle de combat* : économie d’actions, initiatives multiples, réactions, interruptions et défenses en profondeur."
- revision: v0.0.2
category: new rule
description: "Ajout du guide de création, de la fiche de personnage, de la FAQ et de l’écran du maître de jeu."
- revision: v0.0.2
category: new rule
description: "Ajout du bestiaire et des règles nécessaires à la gestion des créatures, de leurs actions et de leurs récompenses."
- revision: v0.0.2
category: rework
description: "Refonte de la présentation des origines, des écoles et des glossaires pour rendre les règles plus faciles à consulter."
- revision: v0.0.2
category: rework
description: "Clarification des blessures graves, des altérations, des armes actives et des coûts d’action."
- revision: v0.0.2
category: balance
description: "Rééquilibrage général des techniques et de leur coût, avec une attention particulière portée au *Sangremage* et à l’*Artilleur*."
- revision: v0.0.2
category: balance
description: "Harmonisation des armes, des résistances et des valeurs utilisées par les écoles."
- revision: v0.0.2
category: bugfix
description: "Corrections groupées de formulations, références, incohérences mineures et coquilles dans l’ensemble du livre."

View File

@ -1,5 +1,7 @@
// Master-facing handbook entry point, adapted from the former LaTeX master.
#import "/setup/setup.typ": config_main, disable-warnings, build-config, theme
#import "/setup/setup.typ": (
build-config, chapter-enabled, config_main, disable-warnings, theme,
)
#show: document => config_main(
document,
master-only: true,
@ -44,6 +46,12 @@ postures ou autres mécaniques étape par étape.
#pagebreak()
// Toggle with: --input disabled_chapters=live-tests
#if chapter-enabled("live-tests") {
include "chapters/master_live_tests.typ"
pagebreak()
}
= Bellua
<chap:bellua>

View File

@ -10,7 +10,7 @@
"title", "acknowledgements", "presentation", "geography",
"hunters-and-calamities", "origins", "schools", "crafting", "races",
"rules", "creation", "character_sheet", "experience-gains",
"game-master-help", "bestiary", "master-screen", "faq",
"game-master-help", "bestiary", "master-screen", "faq", "live-tests",
// Content-level switches: validated like chapters without creating headings.
"origin-lore", "origin-artwork",
)