NFSU2 Documentation

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é.