Bonjour Grav 2.0 !

installation réussie...

Félicitations ! Vous avez installé le paquet de base Grav 2.0, qui fournit une page simple et le nouveau thème par défaut Quark 2 pour bien démarrer, construit sur Blades CSS (le successeur activement maintenu de Pico CSS), Font Awesome 7 et un système typographique raffiné avec apparence claire/sombre/auto.

Warning

Si vous voyez une erreur 404 en cliquant sur Typography dans le menu, veuillez consulter le guide de dépannage.

Tout savoir sur Grav

  • Découvrez Grav en consultant notre site dédié Learn Grav.
  • Téléchargez des plugins, des thèmes et des paquets skeleton de Grav depuis la page Grav Downloads.
  • Suivez le blog de développement de Grav pour rester au courant des dernières nouveautés de l'univers Grav.
  • Parcourez le code source sur GitHub et ouvrez-y des tickets ou des pull requests.

Tip

Si vous souhaitez une installation de base plus complète, consultez les paquets Skeleton disponibles dans les téléchargements — plusieurs ont déjà été mis à jour pour Grav 2.0.

Modifier cette page

Pour modifier cette page, rendez-vous dans le dossier où vous avez installé Grav, puis ouvrez user/pages/01.home. Ouvrez default.md dans votre éditeur de choix. Vous y verrez le contenu de cette page écrit au format Markdown.

Créer une nouvelle page

Créer une nouvelle page est très simple avec Grav. Suivez ces étapes :

  1. Rendez-vous dans votre dossier de pages — user/pages/ — et créez un nouveau dossier. Dans cet exemple, nous utiliserons un ordre par défaut explicite et appellerons le dossier 03.mapage.

  2. Lancez votre éditeur de texte et collez le contenu d'exemple suivant :

    ---
    title: Ma nouvelle page
    ---
    # Ma nouvelle page !
    
    Ceci est le corps de **ma nouvelle page** et je peux facilement utiliser la syntaxe _Markdown_ ici.
  3. Enregistrez ce fichier dans user/pages/03.mapage/ sous le nom default.md. Cela indique à Grav d'afficher la page avec le modèle default de Quark 2.

  4. Rechargez votre navigateur pour voir votre nouvelle page apparaître dans le menu.

Note

La page apparaîtra automatiquement dans le menu après l'élément Typography. Si vous souhaitez un autre libellé, ajoutez menu: Ma page entre les tirets de l'en-tête (front matter) — c'est le bloc d'en-tête YAML, où toutes les options propres à chaque page sont configurées.

Nouveautés de Grav 2.0

Grav 2.0 est la plus grosse version de l'histoire du projet : un cœur modernisé, une administration reconstruite, un nouveau thème par défaut et une pile de dépendances mise à jour. L'essentiel de ce que vous connaissez fonctionne toujours, mais tout ce qui se trouve dessous a été affûté.

  • PHP 8.3+ comme version minimale, avec un cœur modernisé et un typage strict en interne.
  • Pile Symfony 7 + Twig 3, qui apporte les dernières améliorations du framework et un support à long terme.
  • Quark 2 comme thème par défaut — Blades CSS, Font Awesome 7, mode auto/clair/sombre avec persistance via localStorage, polices Cal Sans + Inter hébergées localement et un système de design raffiné inspiré de Cal.com.
  • Admin 2.0 — une interface SPA entièrement pilotée par API, nettement plus rapide, plus réactive et découplée du rendu des pages. La navigation, l'enregistrement des formulaires et les opérations sur les médias ne déclenchent plus de rechargement complet.
  • API REST publique — les mêmes points d'accès qui alimentent Admin 2.0 sont disponibles pour vos propres outils et intégrations.
  • Alertes GitHub Markdown — l'ancien plugin markdown-notices a été remplacé par github-markdown-alerts, avec la syntaxe familière > [!NOTE] / [!TIP] / [!IMPORTANT] / [!WARNING] / [!CAUTION].
  • Cache et pipeline d'assets affinés — invalidation plus propre, démarrages à froid plus rapides et empreintes de dépendances plus intelligentes.
  • Paramètres de sécurité renforcés par défaut — en-têtes CSP resserrés, gestion moderne des sessions et assainissement des entrées amélioré dans les plugins du cœur.
  • Meilleure ergonomie pour les développeurs — indications de type plus strictes, signatures d'événements plus claires et chemins de dépréciation plus lisibles.

Important

Passer de Grav 1.x à 2.0 nécessite une migration. Suivez le guide pas à pas sur getgrav.org/migrate-to-2 — il couvre les vérifications préalables, la migration elle-même et ce qu'il faut contrôler ensuite.