diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..cf9be23 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "ravenous_typst"] + path = ravenous_typst + url = git@git.dandaedre.com:Ravenous/ravenous_typst.git diff --git a/README.md b/README.md index 140d40c..4688be2 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,79 @@ -# ravenous_roll20 +# Ravenous — feuille Roll20 -Roll20 character sheet & macros \ No newline at end of file +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. diff --git a/ravenous_typst b/ravenous_typst new file mode 160000 index 0000000..3b6d2f7 --- /dev/null +++ b/ravenous_typst @@ -0,0 +1 @@ +Subproject commit 3b6d2f746be8c5b78c42e2cb32d153eb8a74d5c0