Aller au contenu principal

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.

CheminContientMenu 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.ymlAccueil, rendez-vous habituel, liens, chiffres, galerieRéglages du site
src/data/partenaires.ymlPartenaires et avantages membresRéglages du site
public/medias/Images et PDF : affiches, logos, galerie, documentsChamps image et fichier

2. Le code du site, réservé aux développeurs​

CheminRôle
src/content.config.tsSchémas des contenus, validés au build
src/lib/site.tsLecture et validation des réglages, formats de date, url()
src/lib/rendez-vous.tsProchain 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.astroEn-tête, menu, pied de page, balises SEO
src/components/Cartes, en-têtes, blocs date…
src/styles/global.cssCouleurs, typographies, composants communs

3. La construction et la publication​

CheminRôle
.gitlab-ci.ymlBuild et publication sur GitLab Pages (Hébergement)
astro.config.mjsConfiguration 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.mjsImport ponctuel de l'ancien WordPress (Import WordPress)
Où modifier quoi ?
  • Changer un texte, une date ou une image → le CMS, jamais le code.
  • Ajouter un champ à une fiche → src/content.config.ts et public/admin/config.yml, toujours les deux.
  • Changer l'apparence → src/styles/global.css, puis les composants.

Les pages générées​

URLFichierContenu
/src/pages/index.astroProchain 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].astroFiche détaillée
/rendez-vous/<fiche>.icssrc/pages/rendez-vous/[id].ics.tsFichier agenda (fuseau America/Toronto)
/actualites/…src/pages/actualites/Liste et détail
/association/, /activites/…src/pages/[page].astroUne page par fichier de src/content/pages/
/partenaires/, /devenir-membre/, /404.htmlsrc/pages/*.astroPages 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 :

  1. Le prochain rendez-vous (accueil et page Rendez-vous) ;
  2. 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).