Bouilde
This commit is contained in:
parent
586cd9da8f
commit
ec78f6dee5
|
|
@ -0,0 +1,3 @@
|
|||
[submodule "ravenous_typst"]
|
||||
path = ravenous_typst
|
||||
url = git@git.dandaedre.com:Ravenous/ravenous_typst.git
|
||||
80
README.md
80
README.md
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -0,0 +1 @@
|
|||
Subproject commit 3b6d2f746be8c5b78c42e2cb32d153eb8a74d5c0
|
||||
Loading…
Reference in New Issue