Aller au contenu principal

Développement local

Prérequis​

  • Node 24 (version indiquée dans .nvmrc, la même que la CI).
  • Git, et un accès SSH ou HTTPS au dépôt francogenie/francogenie.

Lancer le site​

git clone git@gitlab.com:francogenie/francogenie.git
cd francogenie
npm install
npm run dev # http://localhost:4321

Les modifications de fichiers sont visibles immédiatement dans le navigateur.

npm run build # génère dist/, exactement comme la CI
npm run preview # sert dist/ en local
Le build est le test

npm run build valide tout le contenu (schémas dans src/content.config.ts et src/lib/site.ts). Une date invalide, un lien sans https://, une heure mal formée font échouer le build avec un message indiquant le fichier fautif. C'est ce que fait la CI avant de publier.

Utiliser le CMS en local​

Sveltia CMS peut travailler directement sur les fichiers du disque, sans GitLab :

  1. npm run dev, puis ouvrir http://localhost:4321/admin/index.html dans Chrome ou Edge (l'API d'accès aux fichiers n'existe pas dans Firefox).
  2. Choisir Travailler avec un dépôt local et sélectionner le dossier francogenie.
  3. Les enregistrements modifient les fichiers locaux ; il reste à les commiter et pousser.

Pratique pour tester une modification de public/admin/config.yml avant de la publier.

Conventions​

Messages de commit​

Format Conventional Commits : type(portée): description, en français, à l'impératif présent ou au présent (« ajoute », « corrige »).

TypePourExemple
featUne nouvelle fonctionnalité du sitefeat(rendez-vous): export .ics
fixUne correction de bugfix(cms): adresse GitLab Pages du site
styleL'apparence seulement (CSS)style: menu sur une ligne jusqu'à 1240 px
refactorDu code réorganisé, sans changement visiblerefactor: extrait premierJour()
docsLe README ou les commentairesdocs: procédure de domaine
ci.gitlab-ci.ymlci: job verifier sur les MR
choreDépendances, outillagechore: Astro 7.1
contenuUne fiche ou un réglage (produit par le CMS)contenu: ajoute rendez-vous « 2026-12-02-… »
mediasUne image ou un PDF (produit par le CMS)medias: ajoute public/medias/uploads/affiche.webp

Les types contenu et medias ne font pas partie de la spécification : ils sont réglés dans public/admin/config.yml (backend.commit_messages) pour distinguer d'un coup d'œil, dans l'historique, les enregistrements des bénévoles des changements de code.

Fichiers et contenu​

  • Noms de fichiers des fiches : AAAA-MM-JJ-titre-en-minuscules.md, sans accents ni espaces (générés par le CMS). Dates au format ISO 8601 partout (2026-12-02, heures 17:30).
  • Fiches : frontmatter YAML + texte Markdown, validés par les schémas Astro des collections de contenu.
  • Langue : identifiants, commentaires et textes en français, comme le contenu. Pour la typographie (espaces avant : et », majuscules, abréviations comme « 6 à 8 », « 17 h 30 »), la référence est la Vitrine linguistique de l'OQLF.

Branches et merge requests​

  • Petit changement : commit direct sur main (c'est ce que fait le CMS).
  • Changement important : branche type/sujet (ex. feat/sitemap) + merge request. La CI exécute alors le build sans publier (job verifier) ; on ne fusionne que si elle est verte.