This commit is contained in:
Dandaedre 2026-08-27 20:37:21 +02:00
parent 586cd9da8f
commit ec78f6dee5
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
3 changed files with 82 additions and 2 deletions

3
.gitmodules vendored Normal file
View File

@ -0,0 +1,3 @@
[submodule "ravenous_typst"]
path = ravenous_typst
url = git@git.dandaedre.com:Ravenous/ravenous_typst.git

View File

@ -1,3 +1,79 @@
# ravenous_roll20
# Ravenous — feuille Roll20
Roll20 character sheet & macros
Feuille de personnage Roll20 générée depuis les données du livre
[`ravenous_typst`](ravenous_typst). Le résultat reprend la palette parchemin,
or et sang du livre et fournit :
- les caractéristiques et statistiques dérivées de Ravenous ;
- toutes les compétences générales officielles, les compétences maison et leurs modificateurs ;
- les attaques et défenses sous forme de sections répétables et de jets Roll20 ;
- les potions, nourritures et effets temporaires en texte libre, publiables dans
le chat ;
- l'ajout individuel des techniques d'école depuis les TSV du livre, avec
traduction du balisage Typst et bouton d'activation dans le chat.
## Construction locale
Initialiser le sous-module une première fois :
```sh
git submodule update --init --recursive
```
Puis construire avec `uv` (aucun `pip` global n'est utilisé) :
```sh
./scripts/build.sh
```
Le script crée `.venv/` et produit dans `build/` :
- `ravenous.html`, `ravenous.css` et `translation.json`, à charger dans
l'éditeur de feuille personnalisée Roll20 ;
- `sheet.json`, comme base pour une future soumission au dépôt communautaire
Roll20 (une capture `ravenous.png` devra alors être ajoutée) ;
- `build-info.json`, qui indique le nombre d'écoles, techniques et compétences
importées ainsi que l'empreinte du contenu.
La limite des tiers d'école vient directement de
`ravenous_typst/data/config/build.yaml` : seuls les tiers strictement inférieurs
à `build.max_tier_exclusive` sont proposés par la feuille.
Pour vérifier qu'un build versionné correspond aux sources :
```sh
./scripts/build.sh --check
```
## Mise à jour depuis le livre
```sh
git submodule update --remote ravenous_typst
./scripts/build.sh
```
Les compétences proviennent de
`ravenous_typst/data/src/character_sheet.yaml` et les techniques de
`ravenous_typst/data/src/schools/*.tsv`. Les transformations sont dans
`tools/build.py`; le HTML et le CSS maintenus à la main restent dans `src/`.
Il n'est donc pas nécessaire de recopier les données lors d'une mise à jour du
livre.
## CI et publication
GitHub Actions reconstruit la feuille, exécute les tests, vérifie que `build/`
est à jour, puis publie le dossier comme artefact `ravenous-roll20-sheet`.
Le dossier peut être servi tel quel sous
`https://books.dandaedre.com/ravenous_sheet/`; les fichiers de la feuille
n'exigent actuellement aucun asset externe au site.
## Notes Roll20
Dans une partie utilisant une feuille personnalisée, copiez le contenu des
trois fichiers HTML, CSS et traduction dans les panneaux correspondants. La
feuille cible le mode CSE actuel : laissez **Legacy Sanitization désactivé**.
La police Google distante est facultative ; sans accès réseau, les polices de
secours Georgia/serif sont utilisées et toute la mise en page reste active. La
prévisualisation intégrée de Roll20 ne simule pas complètement les sheet
workers ni les sections répétables : validez les imports et les jets dans le
bac à sable de feuille ou dans une partie de test.

1
ravenous_typst Submodule

@ -0,0 +1 @@
Subproject commit 3b6d2f746be8c5b78c42e2cb32d153eb8a74d5c0