title:   Écrire les titres et sous-titres
about:   Comment écrire les titres et les sous-titres pour Tyto - Littérateur
date:    2024-01-07
tags:    format .tyto,écrire,rédaction,titres,table des matières
authors: echolib
logo:    @logos/tyto_titles_toc.png


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


# Titre 1 : id="toc_1"
#1 Les titres
((
   En HTML, les 6 titres et sous-titres sont écrits avec les balises {` <h1> `}
   à {` <h6> `}. Toutefois, :`Tyto`: crée le squelette du site HTML, en
   mettant le titre principal de l'article dans la balise {` <h1> `} - elle-même
   dans la balise {` <article> `}. De ce fait, le contenu rédactionnel dipose
   de 5 titres et sous-titres.
))
((
   Tous les titres ont la même classe CSS : celle dans la configuration du
   domaine ("tyto" par défaut). Chacun des titres a également l'identifiant CSS
   incrémentée par ordre d'apparition. Le 1er titre aura donc {` id="toc_1" `},
   le 4ème titre, {` id="toc_4" `}...
   
))

# Titre 2 : id="toc_2"
#2 Les marqueurs
{{
   #1 Titre <h2>
   #2 Titre <h3>
   #3 Titre <h4>
   #4 Titre <h5>
   #5 Titre <h6>
}}


# Titre 3 : id="toc_3"
#1 La table des matières
((
   Il est possible, très facilement, de créer une table des matière
   automatiquement grâce au marqueur {` ! TOC `}, à mettre, de préférence au
   début du contenu rédactionnel. Cette *`table des matières`*, (comme celles
   que vous pouvez observer dans la majorité des pages de cette documentation),
   est composée avec tous les titres et sous-titres, et permet de créer des
   liens vers leurs ancres.
))