4.0 KiB
Développer et publier Ravenous Roll20
Ce guide regroupe les commandes avancées retirées du README. Les contrats de
comportement et d'architecture restent respectivement dans
FEATURES.md et ARCHITECTURE.md.
Construction
Prérequis : Git, Python 3.11 ou plus récent et uv. Depuis la racine :
git submodule update --init --recursive
./scripts/build.sh
Le build écrit la feuille, les métadonnées et les fixtures déterministes dans
build/. Il lit notamment ravenous_typst/data/src/character_sheet.yaml, les
écoles TSV, les origines YAML, les glossaires et
ravenous_typst/data/config/build.yaml. Les modèles maintenus à la main sont
dans src/; ne modifiez pas directement build/.
Thèmes
Les palettes viennent de ravenous_typst/setup/theme/themes.typ. Le thème
initial vient de document.color_scheme dans la configuration du livre.
./scripts/build.sh --list-themes
./scripts/build.sh --theme-ui steel --output-dir build-steel
./scripts/build.sh --theme-ui steel --output-dir build-steel --check
Tous les thèmes restent sélectionnables par personnage, quel que soit le thème initial du bundle.
Vérification complète
./scripts/build.sh
uv run python -m unittest discover -s tests -v
node tests/test_worker.mjs
node tests/test_mod_import.mjs
node tests/test_character_io.mjs
node tests/test_craft_import.mjs
node tests/test_effects_import.mjs
node tests/test_shared_effects.mjs
uv run python -m unittest discover -s craft_web/tests -v
uv run python -m unittest discover -s effects_web/tests -v
./scripts/run-python-coverage.sh
./scripts/build.sh --check
uv run python craft_web/tools/build.py --check
uv run python effects_web/tools/build.py --check
La couverture mesure les générateurs Python, écrit des fichiers ignorés dans
coverage/ et impose le seuil de lignes de 85 % défini dans .coveragerc.
./scripts/test-worker-container.sh peut exécuter le test du worker dans un
conteneur Podman isolé après le build. Aucun de ces tests ne remplace une
validation dans Roll20.
Mettre à jour les données du livre
git submodule update --remote ravenous_typst
./scripts/build.sh
Contrôlez le diff du sous-module et les descriptions traduites avant de valider la mise à jour. La limite des tiers d'école et les trigrammes proviennent de la configuration épinglée ; ne les recopiez pas dans les modèles.
CI, badges et publication
Jenkins initialise les sous-modules, prépare uv et SQLite, construit les trois
livrables, exécute les tests, impose la couverture, archive les résultats et
vérifie les builds déterministes.
Les badges version.svg, test.svg et coverage.svg sont finalisés même après
un échec, archivés seuls avec empreintes et publiés uniquement depuis main
dans /mnt/assets/coverage/Ravenous/ravenous_roll20/main/. Ils sont servis à :
https://assets.dandaedre.com/coverage/Ravenous/ravenous_roll20/main/version.svg;https://assets.dandaedre.com/coverage/Ravenous/ravenous_roll20/main/test.svg;https://assets.dandaedre.com/coverage/Ravenous/ravenous_roll20/main/coverage.svg.
Le moteur SVG est copié depuis agent-tasks à la révision
fb9d8f7d16f100c2d1377f23394a2302eac9ab18. Le serveur d'actifs devrait monter
les fichiers en lecture seule, désactiver le listing, appliquer une CSP
restrictive aux SVG et revalider rapidement ces URL mutables.
Les branches de publication des trois produits sont :
mainetmaster: noms de production ;candlelight: suffixe_candlelight;lighthouse: suffixe_lighthouse;- les autres branches : construction et archivage sans déploiement.
Les cibles de production sont :
/mnt/assets/ravenous_roll20/ravenous_sheet/;/mnt/assets/ravenous_roll20/ravenous_craft/;/mnt/assets/ravenous_roll20/ravenous_effects/.
Chaque aide de déploiement vérifie une liste blanche et utilise rsync --delete
uniquement dans le sous-dossier du produit. Les détails de flux et de sécurité
sont dans ARCHITECTURE.md.