02 — Maîtriser pages, Markdown, YAML et l'administration
Créer et organiser des pages, comprendre le frontmatter YAML et relier les fichiers Markdown au back-office.
Avant de commencer
- Avoir terminé le module 01 ou disposer d'un Grav 2 fonctionnel.
Créer une page à la main
Une page Grav vit dans user/pages/. Le nom du fichier .md indique généralement le template Twig utilisé.
Un fichier default.md sera normalement rendu avec default.html.twig.
user/pages/01.accueil/default.md- Je sais où créer une nouvelle page.
Écrire du contenu et du frontmatter
Le bloc YAML placé entre --- contient les métadonnées. Le reste du fichier est le contenu Markdown.
YAML dépend de l'indentation : utilise des espaces, jamais des tabulations.
---
title: Accueil
visible: true
taxonomy:
category: vitrine
---
# Bienvenue
Contenu de la page.- Le titre et le contenu s'affichent.
Comprendre l'ordre des dossiers
Les préfixes 01., 02., 03. servent à ordonner les pages et ne sont pas destinés à apparaître dans l'URL.
user/pages/
├── 01.accueil/
├── 02.services/
├── 03.a-propos/
└── 04.contact/- Je comprends pourquoi les dossiers sont souvent numérotés.
Modifier la même page depuis l'admin
Modifie une page dans Admin Next puis regarde le fichier correspondant. L'objectif est de comprendre que le back-office manipule les mêmes contenus du site.
C'est ce qui rend les diffs Git particulièrement lisibles pour beaucoup de modifications éditoriales.
- Je retrouve dans le fichier une modification faite depuis l'administration.
Faire l'exercice de base
Crée Accueil, Services, À propos et Contact avec un titre, un paragraphe et au moins un lien interne.
Ne touche pas encore au design : maîtrise d'abord le modèle de contenu.
- Les quatre pages existent.
- Je peux les modifier depuis l'admin et les fichiers.
🧯 Erreurs fréquentes
Une page n'utilise pas le template attendu
Cause probable : Nom du fichier .md ou header template différent
Correctif : Vérifier le nom du fichier et la valeur template dans le frontmatter.
Erreur après une modification YAML
Cause probable : Indentation ou syntaxe YAML invalide
Correctif : Remplacer les tabulations par des espaces et réintroduire les clés une par une.
Sources de vérification
Ces liens servent à recontrôler le tuto quand l'outil ou l'hébergeur évolue.
Historique de la fiche
L'historique détaillé reste aussi disponible dans Git.