CMS : Sveltia
Sveltia CMS est une application JavaScript servie avec le site
(public/admin/). Elle n'a pas de serveur : elle parle directement à l'API GitLab au nom de la
personne connectée, et chaque enregistrement devient un commit sur main.
Fichiers
| Fichier | Rôle |
|---|---|
public/admin/index.html | Charge Sveltia depuis unpkg, version épinglée (@sveltia/cms@0.256.1) |
public/admin/config.yml | Backend, collections, champs du formulaire, dossiers des médias |
Les blocs importants de config.yml :
backend:
name: gitlab
repo: francogenie/francogenie # chemin du projet GitLab (groupe/projet)
branch: main
auth_type: pkce # pas de secret : flux OAuth PKCE
app_id: 4e17395c… # « Application ID » OAuth (public, pas un secret)
site_url: https://new.francogenie.ca/
media_libraries:
default:
config:
transformations: # images réduites et converties avant l'envoi
raster_image: { format: webp, quality: 80, width: 1600, height: 1600 }
Si le projet change de groupe ou de nom, mettre à jour backend.repo. GitLab redirige git
vers la nouvelle adresse, mais pas forcément les appels d'API du CMS.
L'application OAuth
La connexion « Se connecter avec GitLab » utilise une application OAuth GitLab :
- Confidentielle : non (indispensable avec PKCE, sinon erreur
invalid_client) ; - Portée :
api; - URI de redirection : une par ligne, l'adresse exacte de l'espace bénévoles avec le
/final :https://new.francogenie.ca/admin/https://francogenie-ee7668.gitlab.io/admin/
Elle se crée dans les paramètres d'un utilisateur (gitlab.com/-/user_settings/applications) ou,
mieux, du groupe francogenie (Paramètres → Applications), pour qu'elle ne dépende pas d'un compte
personnel. Si on la recrée, reporter le nouvel Application ID dans config.yml.
Droits des bénévoles
Le CMS écrit avec les droits de la personne connectée. Elle doit pouvoir pousser sur main :
voir Accès et sécurité.
Dépannage
| Symptôme | Cause probable | Correction |
|---|---|---|
invalid_client après « Se connecter avec GitLab » | Application OAuth confidentielle, ou app_id erroné | Décocher Confidentiel (ou recréer l'application), vérifier app_id |
| Page GitLab « The redirect URI included is not valid » | URI de redirection absente ou sans / final | Ajouter l'adresse exacte de /admin/ dans l'application |
| Connexion OK mais enregistrement refusé (403) | Le compte ne peut pas pousser sur main | Voir Accès et sécurité |
| « Projet introuvable » / liste vide | backend.repo faux, ou la personne n'est pas membre | Corriger repo, ajouter le membre |
| Enregistré mais site inchangé | Le build a échoué (donnée invalide) | Projet → Compilation → Pipelines : lire le job en échec |
Mettre à jour Sveltia
- Regarder les versions publiées.
- Changer le numéro dans
public/admin/index.html. - Tester en mode local : ouverture, édition d'une fiche, envoi d'une image.
- Commit
chore(cms): Sveltia x.y.z.
La version est épinglée pour qu'une nouveauté de Sveltia ne change pas l'outil des bénévoles sans prévenir.