L'en-tête des contenus (YAML frontmatter)#
Les sites statiques basés sur du contenu en Markdown (ou autre syntaxe flat comme rst ou autre) ont recours à un en-tête en YAML, appelé aussi YAML front-matter, qui contient des métadonnées sur la page voire carrément des instructions spécifiques à son rendu (template à utiliser, activation/désactivation de fonctionnalités...).
Le site Geotribu tire également profit de ce mécanisme.
Syntaxe#
L'en-tête est défini en haut de la page par un ensemble de clés/valeurs encadré par ---
. Chaque élément a un rôle ou une réutilisation :
title
: utilisé dans le menu de navigation de gauche, le RSS et le SEO (référencement). Cela autorise par exemple un titre différent que celui affiché dans l'articleauthors
: liste des contributeurs réutilisée dans les meta-tags de la page et le SEO (via schema.org)categories
: contient la typologie du contenu permettant des comportements adaptés. Pour l'instant c'est utilisé pour définir le schéma JSON-LD à utiliser, mais c'est prévu dans le RSS aussi,date
: date de création publique de l'article, correspondant à la date de première publication. Utilisée dans le RSS, le SEO et certains moteurs d'affichage.description
: SEO, recherche interne du site, meta-tag, RSSimage
: RSS et partage des articles dans les réseaux sociaux (c'est ce qui fait qu'on a un jouli rendu quand on partage dans Twitter ou LinkedIn par exemple)tags
: pour l'instant ça ne sert à rien mais c'est prévu pour permettre un classement des contenus par mots-clés.
Exemple#
Exemple pour la GeoRDP de Noël 2020 :
1 2 3 4 5 6 7 8 9 |
|
Dernière mise à jour: 5 janvier 2021
Contributions à cette page :