Aller au contenu

Régénérer la documentation

Cette documentation est un site MkDocs Material : sources dans documentation/, configuration dans mkdocs.yml.

Prévisualiser et construire

Sans rien installer (avec uv) :

make docs-serve   # http://127.0.0.1:8000, rechargement automatique
make docs-build   # site statique dans site-docs/
make docs-deploy  # publie sur https://doc.ivr2028.rubidiumweb.fr

Captures d'écran

Les captures sont générées par un script Playwright à partir de la stack locale avec les données de démo (make up, make seed).

PLAYWRIGHT_DIR=/chemin/vers/node_modules/playwright node documentation/scripts/captures.mjs
node documentation/scripts/captures.mjs edit-    # seulement les captures "edit-..."
  • Playwright n'est pas une dépendance du projet : PLAYWRIGHT_DIR pointe vers une installation existante. Le navigateur utilisé est Google Chrome.
  • Le script se connecte avec les comptes de démo (jeton Directus injecté dans le navigateur), en 1440 × 900 (et 390 px pour la capture mobile).
  • La liste des écrans est en tête du script (SHOTS) ; les images sont écrites dans documentation/img/.
  • Les captures Stripe (stripe-*.png) sont faites à la main : le script ne les régénère pas.