title:   Écrire les métadonnées indispensables
about:   Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur
date:    2024-01-06
tags:    format .tyto,écrire,métadonnées,entête
authors: echolib
logo:    @logos/tyto_5_metas.png


! LOGO
-------------------------------------------------------------------------------
! TOC

#1 Les 5 marqueurs obligatoires
((
   Ces marqueurs et leurs métadonnées sont indispensables. :`Tyto`: en a besoin,
   afin de les reprendre, notamment dans les balises HTML {` <meta> `}. Chacun
   de ces marqueur doit être *`écrit sur une seule ligne`*. Leur ordre est
   aléatoire. Vous pouvez indenter leurs contenus pour une meilleure
   lisibilité. Comme toutes métadonnées d'entête, elles doivent être
   écrites au dessus du séparateur {` ----- `}. Vous pouvez également utiliser
   des commentaires (la ligne comence par {` # `})
))


#2 Configurer les marqueurs
{{
   # Marqueur:   Contenus
   
   title:   Le titre de l'article
   about:   La description de l'article
   date:    La date de l'article (AAAA-MM-JJ)
   tags:    étiquette,mots clés,
   authors: Auteur 1,Auteur 2
}}


#3 Le titre de l'article
((
   Le titre de l'article est utilisé en tant que balise {` <h1> `} dans la
   balise {` <article> `} de la page HTML. Il est également utilisé en tant que
   {` title="" `} dans l'onglet de la barre de menu (si le fichier est nommé
   [` index.tyto`], et son dossier source ajouté dans le fichier du module
   "navbar.raw").
))


#3 La date de l'article
((
   La date doit être valide et respecter le format {`AAAA-MM-JJ`} ; exemple :
   {`2024-02-29`}. Dans les pages HTML du site, si ce dernier est configuré
   en langue "fr", les dates sont modifiées pour respecter le format
   d'affichage "JJ/MM/AAAA" dans la page HTML.
))


#3 Les étiquettes de l'article
((
   Elles sont séparées par une virgule. Il est inutile d'ajouter un espace
   après. Dans la page HTML de l'article, la balise HTML
   {` <meta name="keywords" `}, contient aussi les étiquettes fournies dans la
   configuration du domaine (section [DOMAIN], clé "tags"). Il est donc inutile
   de les réécrire.
))