Frontmatter

Le frontmatter est le bloc YAML entre --- en tête de chaque page. Ces champs sont définis et validés par le schéma de Starlight (voir Collections de contenu).

Champ	Type	Défaut	Rôle
title	texte	obligatoire	Titre de la page (h1, onglet du navigateur, menu)
description	texte	—	Résumé ; utilisé par les moteurs de recherche et les aperçus de liens
template	doc | splash	doc	splash : page pleine largeur sans barre latérale (ex. l’accueil)
hero	objet	—	Bannière d’accroche (titre, slogan, image, boutons) ; surtout avec splash
sidebar.order	nombre	—	Position dans un groupe autogénéré
sidebar.label	texte	title	Texte affiché dans le menu
sidebar.hidden	booléen	false	Masque la page du menu (elle reste accessible)
sidebar.badge	texte ou objet	—	Étiquette à côté de l’entrée du menu
tableOfContents	false ou objet	activée	Table des matières de droite ; false pour la masquer, ou niveaux de titres à inclure
prev / next	false, texte ou objet	auto	Liens de pagination en bas de page
lastUpdated	date ou booléen	—	Date de dernière mise à jour affichée
editUrl	URL ou booléen	true	Lien « Modifier cette page » (si editLink est configuré)
banner	{ content: '…' }	—	Bandeau d’annonce en haut de la page (HTML autorisé)
head	liste	—	Balises supplémentaires dans le <head> HTML
pagefind	booléen	true	false exclut la page de la recherche
draft	booléen	false	Brouillon : visible en dev, exclu du build

Champs propres à ce site

Deux champs ont été ajoutés au schéma de Starlight, dans src/content.config.ts :

Champ	Type	Rôle
fichier	texte	Nom du fichier saisi dans Decap CMS à la création (en anglais). Sans effet sur le site.
fiche	objet	Fiche des pages de la section CMS : site, github, licence, modele, bitbucket. Affichée en tête de page.

Exemple complet

---
title: Installer le produit
description: Procédure d'installation pas à pas.
sidebar:
  order: 2
  label: Installation
  badge: Nouveau
tableOfContents:
  minHeadingLevel: 2
  maxHeadingLevel: 3
lastUpdated: 2026-10-03
banner:
  content: Cette procédure concerne la version 3.
draft: false
---

Référence officielle : starlight.astro.build/fr/reference/frontmatter.