d10_cs_generator/README.md

127 lines
6.5 KiB
Markdown

# Système D10 — feuilles Roll20
Ce dépôt génère deux feuilles de personnage Roll20 : **base** et **cyberpunk**.
Les compétences fixes sont dans `data/base_skills.yaml` et
`data/cyberpunk_skills.yaml`. Les champs et variantes sont dans
`data/sheet_model.yaml`, les couleurs dans `data/themes.yaml`, et le style
commun dans `templates/sheet.css`. `tools/build.py` produit les fichiers à
charger dans Roll20.
Le dossier `model_ravenous_roll20/` est une référence locale fournie par
l'utilisateur; il est ignoré par Git et n'entre pas dans la génération D10.
Les deux scripts Mod historiques sont conservés dans [`scripts/`](scripts/).
## Construire
```sh
python -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python tools/build.py --variant base --theme parchment
.venv/bin/python tools/build.py --variant cyberpunk --theme night
.venv/bin/python tools/build.py --list-themes
```
Chaque build crée `sheet.html`, `sheet.css`, `translation.json`, `sheet.json`
et `build-info.json` dans `build/<variante>/<thème>/`. Le build cyberpunk copie
aussi les deux images originales de `assets/`. Il est possible de
choisir un autre répertoire avec `--output-dir`. Charger le HTML, le CSS et
la traduction dans les onglets correspondants de l'éditeur de feuille
personnalisée Roll20. `sheet.json` est un manifeste; `build-info.json` contient
la variante, le thème, le nombre de compétences et une empreinte du résultat.
Les sections **01 Caractéristiques** et **02 Ressources** restent visibles.
La variante base a deux onglets principaux, **Compétences** et **Combat**.
Dans Compétences, quatre sous-onglets séparent **Combat et combat libre**,
**Compétences libres**, **Magie** et **Équipement**. Les lignes répétables
gardent leurs noms d'attributs et de section. La variante cyberpunk conserve
les onglets **Compétences**, **Combat** et **Autres**. Ses compétences fixes ont
trois sous-onglets issus des sections du catalogue YAML : **Physique**,
**Intellectuelles** et **Social**. Les champs répétables restent dans **Autres**.
Le choix principal est stocké dans `d10_tab`, celui des sous-onglets base dans
`d10_skill_tab` et celui des catégories cyberpunk dans `d10_category_tab`.
Les personnages qui avaient enregistré `core` ou, pour la variante base,
`other` affichent **Compétences** jusqu'au prochain clic. L'en-tête reste visible.
La variante cyberpunk propose un sélecteur de thème dans l'en-tête. Il conserve
le choix dans `d10_theme_choice` et applique immédiatement la palette via
`d10_theme`. Les 18 palettes du dossier local `styles/themes/` ont été
adaptées aux cinq couleurs de la feuille et copiées dans `data/themes.yaml`;
le build ne dépend pas de ce dossier. `parchment` et `night` restent disponibles.
`--theme` choisit le thème initial; tous les thèmes modifient seulement les
couleurs et la visibilité de la silhouette, sans modifier les champs ni les jets.
Dans la variante cyberpunk, 02 affiche aussi deux cartes côte à côte :
**Santé** (PV de la tête, du torse et des membres) et **Armure** (protection,
intégrité et intégrité maximale aux mêmes localisations). Les cases sont
posées sur les images originales `robotman_health_r.png` et
`robotman_armor_r.png`. Les attributs de localisation existants gardent leurs
noms; les nouveaux maxima portent le suffixe `_maximum`. Sur un écran étroit,
les cartes se placent l'une sous l'autre. Les champs numériques masquent les
flèches de réglage des navigateurs Firefox et Chromium.
Pour l'aperçu local, le HTML référence les images copiées à côté de
`sheet.html`. Dans Roll20, héberger ces deux PNG à une adresse HTTPS publique,
puis reconstruire avec `--asset-base-url` pointant vers leur dossier :
```sh
.venv/bin/python tools/build.py --variant cyberpunk --theme parchment \
--asset-base-url https://example.org/d10/assets
```
Le HTML généré référence alors les deux URL complètes. Charger ce HTML dans
l'éditeur Roll20 avec le CSS et la traduction.
## Publication Jenkins
L'agent Jenkins doit disposer de Python 3 avec `venv`. Le test JavaScript des
onglets s'exécute si Node.js est présent; son absence ne bloque pas la
publication. Le `Jenkinsfile` exécute les tests Python, construit les deux
variantes dans les 20
thèmes et archive tous les résultats sous `RPG/d10_character_sheet/`. Le
dossier `RPG/d10_character_sheet/assets/` contient les deux PNG originaux. Les
fichiers HTML, CSS et JSON de chaque build sont dans
`RPG/d10_character_sheet/<variante>/<thème>/`. La commande locale équivalente
est :
```sh
.venv/bin/python tools/publish_builds.py
D10_BUILD_ROOT=RPG/d10_character_sheet node tests/test_tabs.mjs
```
Jenkins expose ces fichiers comme artifacts du job. Après avoir obtenu une URL
HTTPS publique et stable pour le dossier `assets/`, reconstruire les feuilles
cyberpunk avec `--asset-base-url` afin que les images fonctionnent dans Roll20.
## Vérifier
```sh
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python tools/build.py --variant base --theme parchment --check
.venv/bin/python tools/build.py --variant cyberpunk --theme night --check
node tests/test_tabs.mjs
```
Le test Node utilise les builds `base/parchment` et `cyberpunk/parchment`;
construire ces deux variantes avant de l'exécuter. `--check` compare les
fichiers existants aux sources sans les réécrire. Les tests vérifient la
génération, les références d'attribut et les actions des onglets, mais ne
simulent pas l'affichage, le parseur de dés ou la sauvegarde de Roll20.
Le Custom Sheet Sandbox doit encore servir à valider les interactions et la
persistance des valeurs; les points précis sont dans [`TASKS.md`](TASKS.md).
## Sources et compatibilité
Le modèle de base reprend les attributs principaux de l'ancienne feuille
`feuille_sysd10.html`; les compétences cyberpunk viennent de la branche
`origin/cyberpunk-latest`, vérifiée contre `origin/cyberpunk`. Les anciennes
sources sont conservées dans l'historique Git, pas dans la génération.
Les noms des caractéristiques, ressources et de plusieurs champs de combat
ont été gardés quand cela était possible. Les sections répétables reconstruites
sous un autre nom ne migrent pas automatiquement.
La feuille historique utilisait aussi les macros `!crit` et des calculs de
combat complexes. Le nouveau build utilise un seuil moins un dé et un roll
template; il n'appelle pas ces macros. Les scripts historiques sous
`scripts/` restent disponibles séparément, sans validation avec la nouvelle
feuille. Les fonctionnalités avancées non modélisées ne doivent pas être
supposées compatibles.