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_DIRpointe 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 dansdocumentation/img/. - Les captures Stripe (
stripe-*.png) sont faites à la main : le script ne les régénère pas.