Balises techniques

Cette page regroupe les balises qui affectent le traitement technique du document et son rendu selon les formats de sortie. Ces balises sont généralement utilisées dans des cas spécifiques et ne sont pas couramment employées dans le corps du texte.

root

Balise racine qui effectue des traitements globaux sur le contenu :

• Normalisation des caractères
• Gestion des notes de bas de page
• Application des attributs de positionnement (first/inter/last/unique)

Warning

Cette balise est généralement utilisée automatiquement par le système et ne devrait pas être utilisée directement dans le contenu.

Attributs

Aucun attribut particulier.

Usage

Cette balise est utilisée automatiquement par le système.

switch-by-output

Permet de fournir différentes versions d'un contenu selon le format de sortie (HTML, EPUB, PDF) et sa variante.

Attributs

Pour chaque bloc de contenu alternatif :

output-target

Le format de sortie ciblé. Valeurs possibles : "html", "epubxhtml", "tex".

switch-by-output{◊div[#:output-target "html"]{...}}

output-variant

La variante de sortie ciblée (optionnel). La valeur dépend de la configuration du projet.

switch-by-output{◊div[#:output-target "tex" #:output-variant "print"]{...}}

Usage

pollen

◊switch-by-output{
  ◊div[#:output-target "html"]{
    Version HTML avec des liens cliquables.
  }
  ◊div[#:output-target "tex"]{
    Version PDF avec des notes de bas de page.
  }
  ◊div{
    Version par défaut si aucune autre ne correspond.
  }
}

htmlepubxhtmltex

<div>
  Version HTML avec des liens cliquables.
</div>

<div>
  Version par défaut si aucune autre ne correspond.
</div>

{Version PDF avec des notes de bas de page.\par}

Conseil

Vous pouvez utiliser cette balise pour optimiser le contenu selon le format de sortie. Par exemple :

• Utiliser des liens cliquables en HTML/EPUB
• Ajouter des notes de bas de page en PDF
• Adapter la mise en page selon le support