Aller au contenu principal

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​

FichierRôle
public/admin/index.htmlCharge Sveltia depuis unpkg, version épinglée (@sveltia/cms@0.256.1)
public/admin/config.ymlBackend, collections, champs du formulaire, dossiers des médias

Les blocs importants de config.yml :

public/admin/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 }
Projet déplacé = config à mettre à jour

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ômeCause probableCorrection
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 / finalAjouter l'adresse exacte de /admin/ dans l'application
Connexion OK mais enregistrement refusé (403)Le compte ne peut pas pousser sur mainVoir Accès et sécurité
« Projet introuvable » / liste videbackend.repo faux, ou la personne n'est pas membreCorriger 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​

  1. Regarder les versions publiées.
  2. Changer le numéro dans public/admin/index.html.
  3. Tester en mode local : ouverture, édition d'une fiche, envoi d'une image.
  4. 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.