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
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 :
npm run dev, puis ouvrirhttp://localhost:4321/admin/index.htmldans Chrome ou Edge (l'API d'accès aux fichiers n'existe pas dans Firefox).- Choisir Travailler avec un dépôt local et sélectionner le dossier
francogenie. - 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 »).
| Type | Pour | Exemple |
|---|---|---|
feat | Une nouvelle fonctionnalité du site | feat(rendez-vous): export .ics |
fix | Une correction de bug | fix(cms): adresse GitLab Pages du site |
style | L'apparence seulement (CSS) | style: menu sur une ligne jusqu'à 1240 px |
refactor | Du code réorganisé, sans changement visible | refactor: extrait premierJour() |
docs | Le README ou les commentaires | docs: procédure de domaine |
ci | .gitlab-ci.yml | ci: job verifier sur les MR |
chore | Dépendances, outillage | chore: Astro 7.1 |
contenu | Une fiche ou un réglage (produit par le CMS) | contenu: ajoute rendez-vous « 2026-12-02-… » |
medias | Une 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, heures17: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 (jobverifier) ; on ne fusionne que si elle est verte.