Aller au contenu

Métadonnées

Les métadonnées contiennent des informations spéciales qui ne sont pas visibles directement en lecture.

Elles doivent idéalement être mises dans le préambule du chapitre ; c'est-à-dire la première partie du fichier, après #lang pollen et avant le corps du chapitre.

Anatomie d’une balise de métadonnées

Une balise de métadonnées possède une syntaxe plus simple que la balise de contenu.

Exemple de balise de métadonnées :

◊(define-meta nom-métadonnée "valeur de la métadonnée")

Les seules parties à modifier sont :

  • nom-métadonnée,
  • valeur de la métadonnée.
◊(define-meta title "Le début d’une aventure")
◊(define-meta révision "3")

Liste des métadonnées

révision

Numéro de révision du chapitre. Idéalement un chiffre entier, mais ça peut être une chaine de caractère si vous préférez.

Cette métadonnée sert principalement à la personne en charge de l'édition pour s'assurer que la version web téléversée sur l'hébergement web est la bonne. Cette valeur s'affiche dans la barre des options de l'export web.

Il est conseillé de modifier cette valeur à chaque modification de contenu que vous faites.

pollen
◊(define-meta révision "42")
pollen
◊(define-meta révision "1.5.0")
pollen
◊(define-meta révision "v5")

title

Titre du chapitre. Cette valeur sert notamment pour l'export web dans le titre de la page (la balise HTML title) et le nom du chapitre dans la navigation latérale et dans les boutons de chapitre précédent et suivant.

Balise requise.

pollen
◊(define-meta title "Titre du chapitre")