Frontmatter¶
Les propriétés de la note remplissent la couverture, l'en-tête courant, la page de références et les métadonnées du PDF. Toutes les clés sont facultatives, et les clés françaises et anglaises sont comprises indifféremment.
---
titre: Bilan de la migration du site # couverture + en-tête (par défaut : le nom de la note)
client: ACME Corp # sous le titre, dans l'en-tête
sous_titre: Équipe infrastructure # sous le titre de couverture
acronyme: INFRA # en grand, sous le sous-titre
auteur: Camille Martin # métadonnées du PDF
logo: logos/acme.png # logo de couverture (chemin du coffre ou [[lien]])
modele: Rapport # impose un modèle, sans passer par le choix
profil: Client # version restreinte exportée par défaut
sections: [cover, toc, body] # remplace les sections du modèle pour cette note
tlp: AMBER # marquage Traffic Light Protocol facultatif
versions: # tableau « Statut du document »
- version: "1.0"
date: "08/06/2026"
etat: "Création du document"
contacts: # tableau « Contacts »
- nom: "Camille Martin"
poste: "Cheffe de projet"
courriel: "camille.martin@exemple.fr"
destinataires: # tableau « Destinataires » (facultatif)
- nom: "Jean Dupont"
societe: "ACME Corp" # ou `poste:`, qui est prioritaire
courriel: "jean.dupont@exemple.fr"
audience: internal # exclut toute la note des versions restreintes
---
Clés¶
| Clé | Équivalent anglais | Sert à |
|---|---|---|
titre |
title |
Titre de couverture, en-tête, titre du PDF, {{title}} dans les noms de fichier |
client |
client |
En-tête, {{client}} dans les noms de fichier |
sous_titre |
subtitle |
Sous le titre de couverture |
acronyme |
acronym |
Texte en grand sous le sous-titre |
auteur |
author |
Métadonnées du PDF |
logo |
logo |
Logo de couverture, à la place de celui du modèle |
modele |
template |
Modèle à utiliser, par nom ou identifiant |
profil |
profile |
Profil d'export utilisé par l'export normal |
sections |
— | cover, references, tlp, toc, body, dans l'ordre |
tlp |
tlp |
RED, AMBER+STRICT, AMBER, GREEN, CLEAR (WHITE est lu comme CLEAR) |
versions |
versions |
Tableau d'état du document : version, date, etat (status) |
contacts |
contacts |
Tableau des contacts : nom (name), poste (role), courriel (email) |
destinataires |
recipients |
Tableau des destinataires : nom, societe (company) ou poste, courriel |
audience |
audience |
Restreint toute la note — voir Export confidentiel |
Comportements utiles¶
- Destinataires : le tableau n'apparaît que si la note nomme au moins un destinataire, ou si le modèle l'active. Une entrée dont tous les champs sont vides est ignorée : le bloc inséré par Insérer le frontmatter de rapport n'a donc aucun effet tant que vous ne le remplissez pas.
- TLP : sans clé
tlp, rien n'est imprimé — sauf si le modèle inclut la page Rappel TLP, auquel cas le rapport est marquéTLP:CLEAR. Une valeur non reconnue (tlp: rouge) déclenche un avertissement au lieu d'être appliquée en silence. - Logo : un
logo:introuvable déclenche un avertissement plutôt que de revenir sans rien dire au logo du modèle. - Les champs du frontmatter imprimés sur la couverture et la page de références ne sont pas filtrés par les profils d'export : n'y mettez pas d'informations confidentielles.