Principe #

Cette procédure permet de prévisualiser votre clone local et toutes les modifications que vous y apportez dans votre navigateur, avant d'en demander la fusion finale au dépôt principal. La prévisualisation est disponible sous l'adresse http://localhost:8080/fr.

Exécuter Eleventy pour construire le site #

Rendez-vous dans votre dossier cartes.gouv.fr-documentation que vous avez cloné sur votre ordinateur précédemment et faites clic droit > Git Bash Here (Si vous venez d'installer le projet alors l'invite de commande doit déjà être ouverte au bon endroit).

Lancez la commande suivante :

Eleventy est le logiciel utilisé pour construire le site. Il transforme les fichiers markdown ou nunjucks du dossier content en pages html à l'aide des gabarits du dossier _includes. Ensuite Pagefind indexe le contenu de ces pages pour que le moteur de recherche du site soit fonctionnel.

À l'issu de cette commande, le dossier _site est rempli ou modifié avec un contenu HTML, visualisable dans un navigateur.

Lancez la commande suivante :

Cette commande rend le site disponible à l'adresse http://localhost:8080/fr/ et reste active, à l'écoute des changements que vous effectuez dans le projet. Normalement cette commande lance automatiquement la commande npm run build.

Le site est ainsi maintenu à jour en même temps que vous modifiez des fichiers. Mais les contenus modifiés ne sont pas indexés pour la recherche et il peut arriver que certaines modifications ne soient pas immédiatement prises en compte. Dans ce cas, arrêtez le site (Ctrl+C dans l'invite de commande git) et relancez les 2 commandes précédentes : npm run build puis npm start.

---

Votre site local est à l'écoute ! Rendez-vous page suivante pour commencer à faire des modifications.

---