Déployer la documentation
Aperçu sur le PC
node tools/build-site.mjs
node tools/check-site.mjs
node tools/serve-site.mjs
Ouvrir http://127.0.0.1:4173/. Le serveur écoute uniquement sur la boucle locale du PC ; ce lien n’est pas une publication Internet. Arrêter le serveur avec Ctrl+C dans le terminal qui l’a lancé.
Cloudflare Pages — recommandé pour le dépôt privé
Cloudflare Pages peut construire le site depuis le dépôt GitHub privé. Le site publié peut être public indépendamment de la visibilité du dépôt. Le code de génération, les sources Markdown et l’historique Git restent dans GitHub ; seuls les fichiers générés dans site/ sont envoyés au site.
Dans le tableau de bord Cloudflare, créer un projet Pages relié au dépôt Platinium-HQ/NFSU2-Documentation. L’intégration GitHub doit être autorisée par le propriétaire du compte, idéalement pour ce seul dépôt.
| Réglage | Valeur |
|---|---|
| Framework preset | None |
| Production branch | main |
| Root directory | Racine du dépôt |
| Build command | node tools/build-site.mjs && node tools/check-site.mjs |
| Build output directory | site |
| NODE_VERSION | 22 |
Le dépôt contient aussi .node-version et wrangler.toml. Aucun npm install, base de données, secret ou fonction serveur n’est nécessaire pour construire le site. La première publication fournit un domaine pages.dev ; un domaine personnalisé pourra être ajouté séparément.
Les commits suivants de main seront construits et déployés automatiquement si l’intégration Git est activée. Les branches peuvent produire des aperçus distincts selon les réglages du projet Cloudflare.
Documentation officielle : HTML statique et intégration GitHub.
GitHub Pages — alternative
Le workflow .github/workflows/site.yml construit un artefact à chaque modification. Le déploiement est facultatif : workflow_dispatch avec publish=true. Il faut d’abord activer Pages avec GitHub Actions dans les réglages du dépôt et disposer d’un forfait permettant Pages sur dépôt privé. Ne pas confondre visibilité du dépôt et visibilité du site.
État
Le site est généré, vérifié et prévisualisable localement. La création du projet Cloudflare, son autorisation GitHub et son URL de production ne sont pas encore effectuées. Aucun déploiement public n’est annoncé comme terminé.