106 lines
5.6 KiB
Markdown
106 lines
5.6 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.
|
|
|
|
## 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.
|