Manuel — gérer le contenu via le CMS

Ce manuel explique comment publier des pages éditoriales (mentions légales, page accessibilité, à propos, articles) via le module CMS de l'application, sans toucher à la documentation technique ni au code.

Le CMS s'administre depuis l'espace d'administration de l'application, dans la section CMS. L'accès dépend de votre rôle (voir ci-dessous).

Rôles et permissions

Le CMS repose sur un circuit de validation à trois rôles. Chaque rôle débloque un ensemble d'actions.

Ce découpage sépare la rédaction, la relecture et la mise en ligne : aucun contenu ne devient public sans une action explicite d'un administrateur.

Créer une page

1. Ouvrir CMS → Contenu → Nouveau.
2. Renseigner les champs :
   • Titre — affiché dans l'en-tête de la page publique.
   • Slug — segment d'URL public de la page. Généré automatiquement depuis le titre, mais modifiable.
   • Type — page (page unique et permanente) ou article (contenu pouvant apparaître dans un flux).
   • Contenu — éditeur Markdown avec prévisualisation (bouton Aperçu).
   • Tags — sélection parmi les tags existants ou création à la volée.
3. Enregistrer en brouillon : le contenu est sauvegardé mais n'est pas encore visible publiquement.

Syntaxe du contenu

L'éditeur accepte du Markdown standard (titres, listes, liens, tableaux, mise en forme). Les bonnes pratiques d'accessibilité s'appliquent : structure de titres cohérente, textes de lien explicites, textes alternatifs sur les images.

Pour insérer une image déjà hébergée dans le CMS :

![Texte alternatif décrivant l'image](chemin-média-fourni-par-le-cms)

L'identifiant ou le chemin de l'image est fourni par le CMS après l'upload (voir section suivante).

Insérer une image

1. Ouvrir CMS → Images → Uploader.
2. Choisir un fichier dans un format image courant (JPEG, PNG, WebP, SVG).
3. Après l'upload, copier l'identifiant (ou le chemin) affiché.
4. Dans le contenu Markdown, référencer l'image avec un texte alternatif :

![Texte alternatif](identifiant-média)

Bonne pratique de sécurité : les fichiers média sont stockés en dehors de la racine web publique et servis par l'application via un point d'accès dédié. Ils ne sont donc pas exposés par une URL brute prévisible, ce qui laisse le contrôle des accès à l'application.

Cycle de vie d'un contenu

Un contenu progresse à travers quatre états :

brouillon  →  en relecture  →  publié
                           ↘  archivé

Ce circuit garantit qu'un contenu passe par une relecture avant sa mise en ligne, et que seule l'administration peut le rendre public.

Publier une page

Seul un administrateur CMS peut publier.

1. Ouvrir la page en état en relecture.
2. Vérifier le rendu via l'Aperçu.
3. Cliquer sur Publier : la page devient immédiatement accessible publiquement.
4. La date de publication est enregistrée automatiquement.

Archiver ou supprimer

• Archiver : la page passe en état archivé, disparaît du site public mais reste conservée en base. L'opération est réversible.
• Supprimer : suppression définitive et irréversible.

Recommandation : les pages légales (mentions légales, accessibilité) ont un slug permanent attendu par les visiteurs et les liens externes. Ne pas les supprimer ; les archiver si elles doivent être remplacées, afin de préserver l'URL.

Gérer les tags

Ouvrir CMS → Tags.

• Créer un tag (nom + slug).
• Le slug du tag sert à un éventuel affichage par tag, s'il est activé.
• Supprimer un tag ne supprime pas les contenus qui lui étaient associés : seul le lien de classement disparaît.

Bonnes pratiques de gouvernance

• Un contenu = un responsable clair. L'éditeur rédige, le relecteur valide, l'administrateur publie. Ne pas court-circuiter le circuit, même pour une correction mineure.
• Ne jamais publier sans aperçu. Vérifier systématiquement le rendu avant la mise en ligne.
• Préserver les slugs des pages légales. Archiver plutôt que supprimer pour ne pas casser les liens.
• Renseigner les textes alternatifs. Toute image insérée doit porter une description pour l'accessibilité.