Aller au contenu

Balises de corps

Cette page regroupe les balises qui affectent l'apparence et la présentation du texte dans le corps du document. Ces balises peuvent être utilisées pour mettre en valeur certains éléments, modifier la tonalité du texte, ou créer des effets visuels particuliers.

avec-insistance

Le personnage ou la narration insiste sur quelque chose, un détail, une expression.

Attributs

Aucun attribut particulier.

Usage

pollen
◊avec-insistance{Texte.}

<avec-insistance>Texte.</avec-insistance>

<avec-insistance>Texte.</avec-insistance>

\emph{Texte.}

bruyant

Un bruit. Contient par exemple des onomatopées comme « boum », « bang », ou une petite phrase « Fracas de la casserole qui tombe ».

Différences avec v-cri

◊bruyant ne s'utilise que dans le cadre de narration. Si vous souhaitez noter qu'un personnage parle fort, il convient d'utiliser v-cri.

Conseil de NemuLumeN

Encadrez chaque bruit d’un caractère étoile pour s’assurer que le bruit est visuellement hors de la narration. Par exemple :

pollen
◊bruyant{*Boum !* *Bang !*}

Attributs

Aucun attribut particulier.

Usage

pollen
◊bruyant{*Boum !* *Bang !*}

<corps-bruyant>*Boum !* *Bang !*</corps-bruyant>

<corps-bruyant>*Boum !* *Bang !*</corps-bruyant>

{\LARGE{\strut *Boum !* *Bang !*\strut}}

citation

Indique que le texte balisé est une citation, un texte repris. Par exemple, un personnage qui imite un autre, ou qui se remémore d'une réplique d'un film. Il est généralement attendu que le personnage reprend le ton qui avait été utilisé originellement, ou qu'il en fasse une interprétation approchante, possiblement caricaturale.

Implémentation incomplète

L'implémentation actuelle ne respecte pas les choix typographiques globaux en matière de guillemets. Pour le moment, les guillemets français sont utilisés systématiquement.

Différences avec cite

Il ne faut pas confondre citation et cite. cite décrite un nom de marque ou un titre de livre, et est analogue à la balise HTML du même nom.

Attributs

Aucun attribut particulier.

Usage

pollen
Ceux-ci rivalisent de créativité pour attirer l'œil du chaland, avec leurs
étals montés telles des sculptures et surmontés d'étiquettes
◊citation{Prix imbattable !} et ◊citation{Vu à la TV !}.

Ceux-ci rivalisent de créativité pour attirer l'œil du chaland, avec leurs
étals montés telles des sculptures et surmontés d'étiquettes
<corps-citation>« Prix imbattable ! »</corps-citation> et
<corps-citation>« Vu à la TV ! »</corps-citation>.

Ceux-ci rivalisent de créativité pour attirer l'œil du chaland, avec leurs
étals montés telles des sculptures et surmontés d'étiquettes
<corps-citation>« Prix imbattable ! »</corps-citation> et
<corps-citation>« Vu à la TV ! »</corps-citation>.

Ceux-ci rivalisent de créativité pour attirer l'œil du chaland, avec leurs
étals montés telles des sculptures et surmontés d'étiquettes
« Prix imbattable ! » et « Vu à la TV ! ».

cite

Cite une référence, comme un nom d'une œuvre, une marque. Cette balise est analogue à la balise HTML du même nom.

Différences avec citation

Il ne faut pas confondre cite et citation. citation définit un texte extrait d'un autre, par exemple un personnage qui en imite un autre, ou qui lit un extrait d'un document textuel.

Attributs

Aucun attribut particulier.

Usage

pollen
C'est amusant ; dès que je pense aux tonbass, cela me rappelle chaque fois
ces sessions irraisonnées de ◊cite{Tonbass Ultimate} qu'on faisait
avec Frère Fidel…

C'est amusant ; dès que je pense aux tonbass, cela me rappelle chaque fois
ces sessions irraisonnées de <cite>Tonbass Ultimate</cite> qu'on faisait
avec Frère Fidel…

C'est amusant ; dès que je pense aux tonbass, cela me rappelle chaque fois
ces sessions irraisonnées de <cite>Tonbass Ultimate</cite> qu'on faisait
avec Frère Fidel…

C'est amusant ; dès que je pense aux tonbass, cela me rappelle chaque fois
ces sessions irraisonnées de \emph{Tonbass Ultimate} qu'on faisait
avec Frère Fidel…

cursive

Transforme le texte en écriture cursive (utilise Comic Sans MS par défaut sur Windows).

Attributs

Aucun attribut particulier.

Usage

pollen
Un texte en ◊cursive{écriture cursive}.

Un texte en <corps-cursive>écriture cursive</corps-cursive>.

Un texte en <corps-cursive>écriture cursive</corps-cursive>.

Un texte en {\textcomic{écriture cursive}}.

em

Met en emphase le texte (généralement en italique).

Attributs

Aucun attribut particulier.

Usage

pollen
Un texte avec de l'◊em{emphase}.

Un texte avec de l'<em>emphase</em>.

Un texte avec de l'<span style="font-style: italic;">emphase</span>.

Un texte avec de l'\emph{emphase}.

emoji

Permet d'insérer des émojis dans le texte avec une police adaptée.

Attributs

Aucun attribut particulier.

Usage

pollen
Un texte avec un ◊emoji{😊} souriant.

Un texte avec un <corps-emoji>😊</corps-emoji> souriant.

Un texte avec un <corps-emoji>😊</corps-emoji> souriant.

Un texte avec un {\textemoji{😊}} souriant.

empty-line

Ajoute une ligne vide dans le texte. Utile pour créer des espaces verticaux entre les paragraphes.

Attributs

Aucun attribut particulier.

Usage

pollen
Un premier paragraphe.
◊empty-line{}
Un second paragraphe.

Un premier paragraphe.
<empty-line></empty-line>
Un second paragraphe.

Un premier paragraphe.
<empty-line></empty-line>
Un second paragraphe.

Un premier paragraphe.
\strut \par
Un second paragraphe.

en-murmurant

Indique que le texte est murmuré, chuchoté. Cette balise est généralement utilisée dans un contexte de dialogue. Le texte sera affiché dans une taille plus petite pour suggérer visuellement le murmure.

Attributs

Aucun attribut particulier.

Usage

pollen
◊p-dial[#:qui "Alice"]{◊v{◊en-murmurant{Ne faites pas de bruit...}}}

<p-dial p-dial-pos="unique" qui="Alice">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "<en-murmurant>Ne faites pas de bruit...</en-murmurant>"
  </corps-voix>
</p-dial>

<p-dial p-dial-pos="unique" qui="Alice">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "<en-murmurant>Ne faites pas de bruit...</en-murmurant>"
  </corps-voix>
</p-dial>

{\footnotesize{\strut Ne faites pas de bruit...\strut}}

Conseil

En HTML et EPUB, l'apparence du texte murmuré est contrôlée par les styles CSS. En LaTeX, le texte est automatiquement affiché dans une taille plus petite.

graphie-incertaine

Utilisée pour marquer des mots dont l'orthographe est incertaine. Le texte sera souligné de manière ondulée.

Attributs

Aucun attribut particulier.

Usage

pollen
Je ne suis pas sûr de l'orthographe du mot ◊graphie-incertaine{hippopotame}.

Je ne suis pas sûr de l'orthographe du mot <graphie-incertaine>hippopotame</graphie-incertaine>.

Je ne suis pas sûr de l'orthographe du mot <graphie-incertaine>hippopotame</graphie-incertaine>.

Je ne suis pas sûr de l'orthographe du mot \uwave{hippopotame}.

incise

Utilisée pour les incises dans le texte. Ajoute automatiquement des tirets cadratins (—) autour du texte.

Attributs

Aucun attribut particulier.

Usage

pollen
◊incise{pensa-t-elle en souriant}

<corps-incise>— pensa-t-elle en souriant —</corps-incise>

<corps-incise>— pensa-t-elle en souriant —</corps-incise>

<corps-incise>— pensa-t-elle en souriant —</corps-incise>

incorrect

Utilisée pour marquer du texte comme incorrect ou barré. Utile pour montrer des corrections ou des erreurs intentionnelles.

Attributs

Aucun attribut particulier.

Usage

pollen
Elle écrivit : « Je ◊incorrect{déteste} aime les mathématiques. »

Elle écrivit : « Je <corps-incorrect>déteste</corps-incorrect> aime les mathématiques. »

Elle écrivit : « Je <corps-incorrect>déteste</corps-incorrect> aime les mathématiques. »

Elle écrivit : « Je \sout{déteste} aime les mathématiques. »

langue-étrangère

Utilisée pour marquer du texte dans une langue étrangère. Le texte sera affiché en italique pour le distinguer visuellement.

Attributs

Aucun attribut particulier.

Usage

pollen
Elle murmura doucement : ◊langue-étrangère{I love you}.

Elle murmura doucement : <langue-étrangère>I love you</langue-étrangère>.

Elle murmura doucement : <langue-étrangère>I love you</langue-étrangère>.

Elle murmura doucement : \emph{I love you}.

manuscrit

Utilisée pour simuler du texte écrit à la main. La police utilisée imite l'écriture manuscrite.

Attributs

Aucun attribut particulier.

Usage

pollen
Sur le papier était écrit : ◊manuscrit{Rendez-vous à minuit}.

Sur le papier était écrit : <corps-manuscrit>Rendez-vous à minuit</corps-manuscrit>.

Sur le papier était écrit : <corps-manuscrit>Rendez-vous à minuit</corps-manuscrit>.

Sur le papier était écrit : \handwritten{Rendez-vous à minuit}.

marque

Utilisée pour encapsuler des marques commerciales, qu'elles soient fictives ou réelles. Le texte sera mis en italique.

Attributs

Aucun attribut particulier.

Usage

pollen
Elle but une canette de ◊marque{Toto-Cola™}.

Elle but une canette de <corps-marque>Toto-Cola™</corps-marque>.

Elle but une canette de <corps-marque>Toto-Cola™</corps-marque>.

Elle but une canette de \emph{Toto-Cola™}.

note-bdp-contenu et note-bdp-sujet

Utilisées pour créer des notes de bas de page. note-bdp-sujet marque l'emplacement de la référence dans le texte, tandis que note-bdp-contenu contient le texte de la note.

Attributs

Pour note-bdp-contenu

id-note

Identifiant unique de la note (obligatoire). Cet identifiant doit correspondre à celui utilisé dans la balise note-bdp-sujet associée.

note-bdp-contenu[#:id-note "1"]
class

Classes CSS additionnelles. Utilisez "pleine-largeur" pour une note en fin de document plutôt qu'en bas de page.

note-bdp-contenu[#:class "pleine-largeur"]

Pour note-bdp-sujet

id-note

Identifiant unique de la note (obligatoire). Doit correspondre à celui du contenu associé dans note-bdp-contenu.

note-bdp-sujet[#:id-note "1"]
class

Classes CSS additionnelles. Utilisez "footnote" pour une note de bas de page standard.

note-bdp-sujet[#:class "footnote"]

Usage

pollen
Le texte principal◊note-bdp-sujet[#:id-note "1" #:class "footnote"]{} contient une référence.

◊note-bdp-contenu[#:id-note "1" #:class "pleine-largeur"]{Voici le contenu de la note de bas de page.}

Le texte principal<note-bdp-sujet id="note1" class="footnote">
  <id-note><a href="#ref1">1</a></id-note>
</note-bdp-sujet> contient une référence.

<note-bdp-contenu id="ref1" class="pleine-largeur">
  <id-note><a href="#note1">1.</a></id-note>
  Voici le contenu de la note de bas de page.
</note-bdp-contenu>

Le texte principal<note-bdp-sujet class="footnote">
  <a id="note1" href="#ref1" epub:type="noteref" role="doc-noteref"><id-note>1</id-note></a>
</note-bdp-sujet> contient une référence.

<aside id="ref1" class="pleine-largeur" epub:type="footnote" role="doc-footnote">
  <id-note><a href="#note1">1.</a></id-note>
  Voici le contenu de la note de bas de page.
</aside>

Le texte principal\footnotemark[1] contient une référence.

\endnotetext[1]{Voici le contenu de la note de bas de page.}

strong

Met le texte en gras.

Attributs

Aucun attribut particulier.

Usage

pollen
Un texte avec une partie en ◊strong{gras}.

Un texte avec une partie en <strong>gras</strong>.

Un texte avec une partie en <strong>gras</strong>.

Un texte avec une partie en \textbf{gras}.

sub

Met le texte en indice.

Attributs

Aucun attribut particulier.

Usage

pollen
H◊sub{2}O

H<sub>2</sub>O

H<sub>2</sub>O

H$_{\text{2}}$O

sup

Met le texte en exposant.

Attributs

Aucun attribut particulier.

Usage

pollen
E = mc◊sup{2}

E = mc<sup>2</sup>

E = mc<sup>2</sup>

E = mc$^{\text{2}}$

table

Permet de créer des tableaux. Supporte les tableaux responsifs avec la classe "simple-responsive".

Attributs

class

Classes CSS pour le tableau. Utilisez "simple-responsive" pour un tableau adaptatif sur mobile.

table[#:class "simple-responsive"]

La classe "simple-responsive" transforme le tableau en une vue adaptée aux mobiles : - Sur desktop, affichage classique en colonnes - Sur mobile, chaque cellule est précédée de son en-tête - Pour Kindle, une mise en page spéciale est appliquée pour contourner les bugs du convertisseur

Usage

pollen
◊table[#:class "simple-responsive"]{
  ◊thead{
    ◊tr{
      ◊th{Nom}
      ◊th{Âge}
      ◊th{Ville}
    }
  }
  ◊tbody{
    ◊tr{
      ◊td{Alice}
      ◊td{25}
      ◊td{Paris}
    }
    ◊tr{
      ◊td{Bob}
      ◊td{30}
      ◊td{Lyon}
    }
  }
}

<table class="simple-responsive">
  <thead>
    <tr>
      <th>Nom</th>
      <th>Âge</th>
      <th>Ville</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td data-field-name="Nom"><cell-content>Alice</cell-content></td>
      <td data-field-name="Âge"><cell-content>25</cell-content></td>
      <td data-field-name="Ville"><cell-content>Paris</cell-content></td>
    </tr>
    <tr>
      <td data-field-name="Nom"><cell-content>Bob</cell-content></td>
      <td data-field-name="Âge"><cell-content>30</cell-content></td>
      <td data-field-name="Ville"><cell-content>Lyon</cell-content></td>
    </tr>
  </tbody>
</table>

<div class="table simple-responsive">
  <div class="tbody">
    <div class="tr">
      <div class="head-and-value">
        <div class="head">Nom</div>
        <div class="td">Alice</div>
      </div>
      <div class="head-and-value">
        <div class="head">Âge</div>
        <div class="td">25</div>
      </div>
      <div class="head-and-value">
        <div class="head">Ville</div>
        <div class="td">Paris</div>
      </div>
    </div>
    <div class="tr">
      <div class="head-and-value">
        <div class="head">Nom</div>
        <div class="td">Bob</div>
      </div>
      <div class="head-and-value">
        <div class="head">Âge</div>
        <div class="td">30</div>
      </div>
      <div class="head-and-value">
        <div class="head">Ville</div>
        <div class="td">Lyon</div>
      </div>
    </div>
  </div>
</div>

Non supporté en format PDF. Utilisez directement la syntaxe LaTeX pour les tableaux.

Compatibilité PDF/LaTeX : utiliser switch-by-output pour les tableaux

Par défaut, la balise table n’est pas supportée en export PDF/LaTeX. Pour inclure un tableau qui fonctionne dans tous les formats (HTML, EPUB, PDF), il faut utiliser la balise switch-by-output pour fournir une version HTML/EPUB et une version LaTeX.

Voici un exemple complet :

pollen
◊switch-by-output{
  ◊div[#:output-target "tex"]{
    \begin{tabular}{|l|c|l|}
    \hline
    Nom & Âge & Ville \\
    \hline
    Alice & 25 & Paris \\
    Bob & 30 & Lyon \\
    \hline
    \end{tabular}
  }
  ◊table[#:class "simple-responsive"]{
    ◊thead{
      ◊tr{
        ◊th{Nom}
        ◊th{Âge}
        ◊th{Ville}
      }
    }
    ◊tbody{
      ◊tr{
        ◊td{Alice}
        ◊td{25}
        ◊td{Paris}
      }
      ◊tr{
        ◊td{Bob}
        ◊td{30}
        ◊td{Lyon}
      }
    }
  }
}
  • En HTML/EPUB, c’est la version table qui sera utilisée (tableau responsive).
  • En PDF/LaTeX, c’est la version tabular qui sera utilisée (tableau classique LaTeX).

Cela garantit un rendu correct dans tous les formats, sans erreur à l’export PDF.

Note sur les tableaux responsifs

La classe "simple-responsive" transforme le tableau en une vue adaptée aux mobiles : - Sur desktop, affichage classique en colonnes - Sur mobile, chaque cellule est précédée de son en-tête - Pour Kindle, une mise en page spéciale est appliquée pour contourner les bugs du convertisseur

small-caps

Transforme le texte en petites capitales.

Attributs

Aucun attribut particulier.

Usage

pollen
Texte en ◊small-caps{en petites capitales}.

Texte en <small-caps>petites capitales</small-caps>.

Texte en <small-caps>petites capitales</small-caps>.

Texte en {\scshape petites capitales}.

special-chars

Utilisée pour normaliser les caractères spéciaux dans le texte. Cette balise applique une fonction de normalisation qui assure la compatibilité des caractères spéciaux avec différents formats de sortie.

Attributs

Aucun attribut particulier.

Usage

pollen
◊special-chars{Texte avec des caractères spéciaux — œ, æ, « » …}

<special-chars>Texte avec des caractères spéciaux — œ, æ, « » …</special-chars>

<special-chars>Texte avec des caractères spéciaux — œ, æ, « » …</special-chars>

Texte avec des caractères spéciaux --- \oe{}, \ae{}, \guillemotleft{} \guillemotright{} \ldots{}

Conseil

Utilisez cette balise lorsque vous avez des caractères spéciaux qui pourraient poser des problèmes de compatibilité, particulièrement pour la sortie LaTeX.

pi-perso

Utilisée pour mettre en évidence des éléments personnalisés dans le texte. Le texte sera affiché en italique.

Attributs

Aucun attribut particulier.

Usage

pollen
◊pi-perso{Texte personnalisé}

<pi-perso>Texte personnalisé</pi-perso>

<pi-perso>Texte personnalisé</pi-perso>

\emph{Texte personnalisé}

pi-titre

Utilisée pour mettre en évidence des titres personnalisés. Le texte sera affiché en italique.

Attributs

Aucun attribut particulier.

Usage

pollen
◊pi-titre{Titre personnalisé}

<pi-titre>Titre personnalisé</pi-titre>

<pi-titre>Titre personnalisé</pi-titre>

\emph{Titre personnalisé}