Frontmatter
Les champs qu’une page peut porter au-delà du titre et de la description, et les deux que la compilation remplit.
Content ne stocke que ce que déclare le schéma d’une collection : voici donc la liste complète — un champ non déclaré est écarté silencieusement, avant même que la barre latérale ou la recherche le voie.
Ce que vous écrivez
| Champ | Type | Ce qu’il fait |
|---|---|---|
title | string | Rendu comme le <h1> de la page, et son titre SEO et social |
description | string | Le résumé — barre latérale, cartes, image OG, llms.txt |
icon | string | Affiché à côté de l’entrée dans la barre latérale, la rangée et les cartes |
navigation | boolean | false masque la page dans la navigation |
layout | string | landing rend la page sans la mise en page documentaire |
redirectFrom | string[] | Anciennes URL de cette page — voir Déplacer une page |
date | string | La date de cette page, pour le flux |
title et description sont les deux dont la compilation signale l’absence.
Aucun ne casse une page, et tous deux dégradent silencieusement le sommaire, la
carte sociale et llms.txt.
title est rendu comme titre. Un titre # en début de fichier est le deuxième
<h1> de la page.
Ce que la compilation remplit
| Champ | Rempli par | Contient |
|---|---|---|
lastUpdated | le module git-meta | Le dernier commit ayant touché le fichier |
contributors | le module git-meta | Nom, nombre de commits et pseudo, par auteur |
rawbody | le schéma de la collection | Le Markdown tel qu’écrit |
sitemap | l’intégration sitemap | Ce qui met la page dans /sitemap.xml |
En écrire un à la main ne sert à rien : la compilation les écrase. Les deux
champs git ont besoin d’un historique réel, une source distante a donc besoin de
history: true — voir la référence des sources.
Le nom du fichier porte deux choses de plus
- Un préfixe numérique ordonne l’arborescence et disparaît de l’URL :
3.guides/2.deploy.mdest servi sur/guides/deploy. Réordonner ne déplace jamais une URL. .draft.mdest un brouillon. Il est servi dans le serveur de développement et absent de la compilation. Il n’y a pas dedraft: true, car le contenu d’une collection est déclaré avant qu’un fichier ait été lu — voir Collections.