tyto-litterateur/website_doc/article/metas_obligatoires.tyto

64 lines
2.2 KiB
Plaintext

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.
))