Référence des balises

Lorsque vous écrivez un livre avec Fabrilivre, vous aurez surement à utiliser des balises dans le texte source. Ces balises permettent d’attribuer au texte une intention. Il est essentiel de bien baliser le texte afin de faciliter l’automatisation de la plupart des tâches de mise en page.

Dans Fabrilivre, les balises sont écrites dans le langage Pollen.

Balises de métadonnées vs de contenu

Il existe deux types de balises :

• contenu : Elles forment la grande majorité des balises en nombre. Elles manipulent l’apparence d’un texte, son placement.
• métadonnées : Elles servent à définir le titre du chapitre, son numéro de révision, etc. Elles sont généralement placées en tête du fichier source. Elles sont écrites un peu différemment (avec des parenthèses) et ne sont pas faites pour écrire directement dans le corps de page.

Anatomie d’une balise de contenu

Une balise de contenu est composée de trois éléments : d’un nom, d’attributs, et d’un contenu. Celles et ceux qui connaissent le HTML seront familiers avec ce concept.

Exemple de balise de contenu :

pollen

◊balise-xyz[#:attribut-1 "Toto" #:attribut-2 "Tata"]{Salut ! J’espère que tu vas bien !}

Décomposons l’exemple :

• ◊ : Marque le début de la balise.
• balise-xyz : Nom de la balise.

• [#:attribut-1 "Toto" #:attribut-2 "Tata"] : Liste d’attributs (dans cet exemple, il y a deux attributs dans la liste) :

  • [ : Ouvre la liste d’attributs.
  • #:attribut-1 : Nom de l’attribut.
  • "Toto" : Valeur de l’attribut.
  • ] : Ferme la liste d’attributs. D’autres attributs peuvent être ajoutés avant ce crochet fermant, en faisant une succession de noms et de valeurs d’attribut.

• {Salut ! J’espère que tu vas bien !}: Le contenu de la balise, entre les accolades.

Les balises sont imbricables. Voici un exemple plus concret (extrait de Tel un Nuage Bravant le Souffle, NemuLumeN) :

pollen

◊p-dial[#:qui "Félicie"]{
    ◊v{S’il faut porter ça pour ◊avec-insistance{faire des ravages}, je passe mon tour !}
}

1. Il s’agit d’une ligne de dialogue.
2. Félicie est le personnage concerné par cette ligne de dialogue.
3. Félicie parle (v pour voix).
4. avec-insistance souligne une insistance dans le ton employé par Félicie.

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 :

pollen

◊(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.

pollen

◊(define-meta title "Le début d’une aventure")
◊(define-meta révision "3")

Vous trouverez la liste complète des balises de métadonnées dans balises/metadonnees.