Architecture
Organisation du dépôt du site
Le dépôt francogenie/francogenie se lit en trois couches : ce que les bénévoles modifient, le code
qui le met en forme, et ce qui le construit et le publie.
1. Le contenu, modifié par le CMS
Ces fichiers changent à chaque enregistrement dans l'espace bénévoles. On peut aussi les corriger à la main, mais ils doivent rester conformes aux schémas, sinon le build échoue.
| Chemin | Contient | Menu du CMS |
|---|---|---|
src/content/rendez-vous/ | Une fiche .md par rencontre (frontmatter YAML + texte) | Rencontres du mois |
src/content/actualites/ | Une fiche .md par actualité | Actualités |
src/content/pages/ | Pages de présentation : association, activités… | Pages du site |
src/data/site.yml | Accueil, rendez-vous habituel, liens, chiffres, galerie | Réglages du site |
src/data/partenaires.yml | Partenaires et avantages membres | Réglages du site |
public/medias/ | Images et PDF : affiches, logos, galerie, documents | Champs image et fichier |
2. Le code du site, réservé aux développeurs
| Chemin | Rôle |
|---|---|
src/content.config.ts | Schémas des contenus, validés au build |
src/lib/site.ts | Lecture et validation des réglages, formats de date, url() |
src/lib/rendez-vous.ts | Prochain 6@8, valeurs par défaut, calcul du premier mercredi |
src/pages/ | Les routes : accueil, rendez-vous, actualités, [page], fichiers .ics… |
src/layouts/Base.astro | En-tête, menu, pied de page, balises SEO |
src/components/ | Cartes, en-têtes, blocs date… |
src/styles/global.css | Couleurs, typographies, composants communs |
3. La construction et la publication
| Chemin | Rôle |
|---|---|
.gitlab-ci.yml | Build et publication sur GitLab Pages (Hébergement) |
astro.config.mjs | Configuration d'Astro ; SITE_URL et BASE_PATH lus dans l'environnement |
public/admin/ | Sveltia CMS : index.html (version épinglée) et config.yml (CMS) |
scripts/import-wordpress.mjs | Import ponctuel de l'ancien WordPress (Import WordPress) |
- Changer un texte, une date ou une image → le CMS, jamais le code.
- Ajouter un champ à une fiche →
src/content.config.tsetpublic/admin/config.yml, toujours les deux. - Changer l'apparence →
src/styles/global.css, puis les composants.
Les pages générées
| URL | Fichier | Contenu |
|---|---|---|
/ | src/pages/index.astro | Prochain 6@8, déroulement, derniers rendez-vous, offre, chiffres, galerie, partenaires |
/rendez-vous/ | src/pages/rendez-vous/index.astro | À venir + archives par saison, recherche et filtre par type (JavaScript côté navigateur) |
/rendez-vous/<fiche>/ | src/pages/rendez-vous/[id].astro | Fiche détaillée |
/rendez-vous/<fiche>.ics | src/pages/rendez-vous/[id].ics.ts | Fichier agenda (fuseau America/Toronto) |
/actualites/… | src/pages/actualites/ | Liste et détail |
/association/, /activites/… | src/pages/[page].astro | Une page par fichier de src/content/pages/ |
/partenaires/, /devenir-membre/, /404.html | src/pages/*.astro | Pages fixes |
/admin/ | public/admin/ | Le CMS, copié tel quel |
Ce qui est calculé, et quand
Le site est statique : tout est calculé au build. Deux choses dépendent pourtant de la date du jour :
- Le prochain rendez-vous (accueil et page Rendez-vous) ;
- Le passage aux archives et la disparition du bouton d'inscription.
Elles sont gérées deux fois : au build, et à nouveau dans le navigateur du visiteur par un petit script (date du jour à Montréal). Ainsi le site reste juste même s'il n'a pas été reconstruit depuis plusieurs jours. Un pipeline programmé chaque nuit (voir Hébergement) remet aussi le HTML d'origine à jour.
Dépendances
Volontairement minimales : astro, yaml, deux polices (@fontsource-variable/inter,
@fontsource-variable/space-grotesk). En développement seulement : sharp et turndown pour le script
d'import WordPress. Aucun service tiers n'est chargé par les pages (pas d'analytics, pas de police
Google) ; seuls les liens sortants pointent vers Yapla, LinkedIn et YouTube (vidéo en youtube-nocookie).