Publication

Voici un tour d’horizon complet – mais digeste – de tout ce qu’il faut régler autour de vos pages Learn2 dans Grav, du front‑matter d’une page jusqu’aux réglages globaux du site. Lisez‑le d’une traite pour avoir la carte, puis revenez chapitres par chapitres quand vous passez à l’action ; je vous ai mis les indications d’interface (onglets Admin) et les bouts de YAML correspondants, afin que vous puissiez travailler indifféremment depuis l’Admin ou dans les fichiers.

1. Anatomie d’une page Grav (ce qui va dans user/pages/NN.titre/)

Élément Rôle Où le régler
01.‑titre/ (dossier) Position dans le menu + slug d’URL Arborescence du disque ou champ Folder Name (onglet Options)
page.md Contenu + front‑matter Éditeur Markdown (onglet Content)
images/ etc. Médias appelés par la page Gestionnaire de fichiers ou FTP

Astuce Learn2 : les sections latérales (“chapters”) sont générées par l’ordre numérique des dossiers (01., 02., 03…) ; aucun plugin n’est nécessaire.

2. Onglet Content – le front‑matter de base

title: Mon Super Chapitre
menu: Chapitre 1        # libellé dans la sidebar Learn2
visible: true           # sinon la page est cachée de la nav
date: 2025-07-21        # sert au tri et aux métadonnées
taxonomy:
  category: [doc]
  tag: [apprendre, grav]
  • Title : balise <h1> et titre SEO si vous ne le surchargez pas ailleurs.
  • Menu : label court ; laissez vide pour reprendre title.
  • Visible : pratique pour brouillonner sans perturber la navigation.
  • Taxonomy : alimente les plugins TaxonomyList et RelatedPages.

3. Onglet Options – structure, redirections, fichiers

Réglage Utilisation courante
Parent Page Changer la hiérarchie sans déplacer le dossier.
Folder Name Renommer le dossier ; préfixez de NN. pour l’ordre.
Order by / Manual Ordering Choisir un tri autre que le préfixe numérique (par date, titre…).
Route / Redirect Créer une URL canonique propre OU rediriger cette page vers une autre.
Unset Slug Laisser Grav générer le slug depuis le titre.

⚙️ Good practice : gardez toujours le préfixe numérique pour Learn2 ; vous éviterez les surprises si vous changez d’ordre plus tard.

4. Onglet Advanced – template & processing

Champ Que faire
Template default pour une page classique, chapter ou item si Learn2 les propose pour sections spécialisées.
Page Caching / Twig / Markdown Laissez par défaut sauf besoin spécifique (ex. désactiver Twig si vous mettez du code {% %} qui ne doit PAS être interprété).
Never Cache Oui pour une page de recherche ou de formulaire.
Content > Process Shortcodes À activer si vous utilisez le plugin Shortcode Core.

5. Onglet Security – contrôle d’accès

access:
  site.login: true          # connexion obligatoire
  admin.super: false
  admin.login: true
  • Cochez Login Required si la page ne doit être visible qu’aux membres.
  • Attribuez des groupes ou des rôles précis (plugin Login + Admin).

6. Onglet SEO – métadonnées et aperçu Google

Réglage Conseils
Override Title Entre 50‑60 car. max. – incluez un mot‑clé et le nom du site.
Override Description 150‑160 car. – mention explicite de la valeur ajoutée.
Facebook / Twitter cards Renseignez‑les si ce chapitre est partagé fréquemment.

Direct YAML :

header:
  meta:
    canonical: https://monsite.be/chemin/page
    description: >-
      Le pitch de la page…

7. Section Publishing (en haut de vos captures)

Basculateur Effet
Published Active/désactive l’affichage public.
Date / Published Date La première sert au tri ; la seconde remplace la date système (utile pour republier).
Unpublished Date Programme la dépublication automatique.
Metadata Ajoutez n’importe quel <meta name="…"> supplémentaire.

8. Taxonomies & listing automatique

  • category : gros chapitres (doc, tuto, release‑notes…).
  • tag : thèmes transversaux.
  • Activez le plugin TaxonomyList pour générer un nuage de tags ou une liste de catégories.

9. Sitemap (plugin sitemap de base)

Champ Par défaut Quand le changer
Ignore false Cochez pour cacher la page aux moteurs.
Last Modified auto Surchargez si vous mettez à jour sans toucher au fichier MD.
Change Frequency global never pour mentions légales, hourly pour un feed.
Priority global(1) Baissez à 0.3 pour une page peu importante.

10. External Links plugin (sécurité + UX)

  • Filter external links : ajoute rel="noopener" et target="_blank" pour empêcher une page externe malveillante de récupérer l’objet window.opener.
  • Mode Active / Passive : Active scanne tout le HTML, Passive attend un shortcode.
  • rel="nofollow" : cochez‑le si le site pointe massivement vers des ressources externes que vous ne cautionnez pas.

11. Configuration globale du site (fichier user/config/)

  1. system.yaml : cache, Gzip, images responsive, timezone (Europe/Brussels).
  2. site.yaml : nom du site, auteur, og\:image par défaut, désignation de la page d’accueil.
  3. plugins/ : un fichier YAML par plugin – documentez‑vous via la page du plugin sur getgrav.org et activez seulement ce qui est utile (évite de surcharger).

Plugins indispensables en doc Learn2 :

Plugin Raison
Breadcrumbs Chemin hiérarchique en haut.
GitSync Sauvegarde & versionnement GitHub automatiques.
Flex Objects Pour des listes structurées (FAQ, glossaire).
Shortcode Core Alertes, onglets, notices dans vos fiches.
Backup Manager Dump ZIP automatisé, configurable.

12. Personnaliser le thème Learn2

  1. user/themes/learn2/ – ne touchez pas aux fichiers du core ; créez plutôt user/themes/my-learn2/ qui hérite de Learn2 :

    streams:
 schemes:
   theme:
     type: ReadOnlyStream
     prefixes:
       '':
         - user/themes/my-learn2
         - user/themes/learn2
  2. Ajoutez un custom.css pour quelques tweaks (logo, couleurs).
  3. Surchargez les Twig via le même nom de fichier (ex. partials/sidebar.html.twig) dans votre sous‑thème.

13. Workflow conseillé « sans prise de tête »

Étape Outil Commande/Action
Créer/modifier une page Admin GUI OU éditeur local + Git git commit -m "Nouvelle fiche"
Prévisualiser http://localhost:8000 (php -S localhost:8000 system/router.php) -
Déployer Git push + hook sur le serveur OU plugin GitSync -
Nettoyer CLI : bin/grav clear-cache -
Sauvegarde Plugin Backup Manager (Daily + Before Upgrade) -

14. Checklist « A → Z » avant publication

  1. Structure OK : numérotation cohérente, slugs définitifs.
  2. Menu & breadcrumbs vérifiés.
  3. SEO : titres, descriptions, canonical.
  4. Images : poids optimisé, alt text renseigné.
  5. Liens internes : utilisez page.find('/chemin').url pour éviter les 404.
  6. Accès : pages privées protégées par login si nécessaire.
  7. Sauvegarde : testez la restauration d’un ZIP.
  8. Cache vidé, sitemap régénéré.

Et maintenant ?

  • Passez page par page : ouvrez l’onglet, reportez‑vous à la section du guide ci‑dessus.
  • Quand vous vous sentez bloqué sur un réglage précis, relancez‑moi ; on zoomera ensemble, capture d’écran à l’appui.
  • Enfin, pensez à activer le mode Maintenance le temps que le squelette prenne forme ; la première impression compte toujours !

Bonne construction — et au plaisir de débuguer la suite avec vous !

C'est ça ouais

On vient à peine de se remettre de Jekyll

Ouais, et encore

Pfff

C'est fini oui ? on s'remet !

⬆️