Aller au contenu

Balises de dialogue

Cette page regroupe les balises utilisées pour formater les dialogues et les voix dans le texte.

p-dial

Ligne de dialogue.

Il est attendu que cette balise contienne au moins une balise v ou une variante v-*. En effet, Fabrilivre se base sur le principe qu'une ligne de dialogue peut être entrecoupée par des incises et autres détails narratifs. Chaque balise v / v-* contient donc la vraie voix du personnage, et ce qui n'est pas dedans constitue une narration standard.

Le respect de ce principe permet de contrĂ´ler l'apparence des dialogues, notamment l'automatisation des guillemets.

Attributs

qui

Le nom du personnage qui parle. Vous devez mettre le vrai nom du personnage, quelle que soit la situation. Cette valeur ne doit donc pas changer dans un mĂŞme livre.

Vous pouvez mettre plusieurs noms, si la ligne de dialogue est dite par plusieurs personnages en même temps. Les noms doivent être séparés par une virgule. Par exemple :

p-dial[#:qui "Félicie,Lierre"]{...}

Un nom ne peut donc pas contenir de virgule, et les caractères spéciaux sont déconseillés.

inconnu

Indique un nom de remplacement quand le nom de l'attribut qui ne devrait pas être dévoilé lors de la lecture de la ligne.

p-dial[#:qui "Félicie" #:inconnu "Inconnue"]{...}

Usage

pollen
◊p-dial[#:qui "Félicie"]{...}
<p-dial p-dial-pos="unique" qui="Félicie">...</p-dial>
<p-dial p-dial-pos="unique" qui="Félicie">...</p-dial>
...

Notes additionnelles

Vous pouvez constater des attributs p-dial-pos dans l'export html. Vous pouvez utiliser cet attribut pour personnaliser d'avantage l'apparence des dialogues. Vous avez trois valeurs :

  • first : première ligne d'une suite de lignes.
  • inter : ligne intermĂ©diaire d'une suite de lignes.
  • last : dernière ligne d'une suite de lignes.
  • unique : ligne de dialogue isolĂ©e.

v

Voix. Contient ce qui est parlé dans une balise p-dial.

Attributs

class="distant"

Indique si la voix est de type distante. Cela peut servir pour signifier qu'une voix est entendue à travers un appareil électronique comme un téléphone, des haut-parleurs.

Cela signifie en général que le personnage qui parle n'est physiquement pas présent.

nombre

Indique le nombre de personnes qui parlent en mĂŞme temps. Ne pas mettre de guillemets autour de la valeur.

p-dial[#:qui "Félicie,Lierre"]{◊v[#:nombre 2]{Bonnes fêtes !}}

Dans la version de base de Fabrilivre, ce nombre contrôle le nombre de guillemets qui encadre un texte parlé. Par exemple, pour un nombre de 3, vous aurez :

“““Ce texte est dit par trois personnages en même temps.”””

Cette valeur est Ă  associer avec l'attribut qui de p-dial. Vous devez avoir le mĂŞme nombre de noms dans l'attribut qui que le nombre dans l'attribut nombre de v.

Usage

pollen
◊p-dial[#:qui "Félicie"]{◊v{Comment faites-vous pour prendre des nouvelles du monde ?}}
<p-dial p-dial-pos="unique" qui="Félicie">
    <corps-voix class="fn-voix">
        <span class="prefix"></span>
        “Comment faites-vous pour prendre des nouvelles du monde ?”
    </corps-voix>
</p-dial>

Les guillemets de cet exemple dépendent du réglage du mode de dialogue.

<p-dial p-dial-pos="unique" qui="Félicie">
    <corps-voix class="fn-voix">
        <span class="prefix"></span>
        “Comment faites-vous pour prendre des nouvelles du monde ?”
    </corps-voix>
</p-dial>

Les guillemets de cet exemple dépendent du réglage du mode de dialogue.

“Comment faites-vous pour prendre des nouvelles du monde ?”

Les guillemets de cet exemple dépendent du réglage du mode de dialogue.

v-action

Utilisée pour indiquer une petite action en pleine ligne de dialogue. Le texte sera encadré de parenthèses. Cette balise doit être utilisée à l'intérieur d'une balise v dans un contexte de p-dial.

Attributs

Aucun attribut particulier.

Usage

pollen
â—Šp-dial[#:qui "Alice"]{
  â—Šv{Je suis d'accord â—Šv-action{hochant vigoureusement la tĂŞte} avec votre proposition. â—Šv-action{se tournant vers Bob} Qu'en pensez-vous ?}
}
<p-dial p-dial-pos="unique" qui="Alice">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "Je suis d'accord <v-action>(hochant vigoureusement la tĂŞte)</v-action> avec votre proposition. <v-action>(se tournant vers Bob)</v-action> Qu'en pensez-vous ?"
  </corps-voix>
</p-dial>
<p-dial p-dial-pos="unique" qui="Alice">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "Je suis d'accord <v-action>(hochant vigoureusement la tĂŞte)</v-action> avec votre proposition. <v-action>(se tournant vers Bob)</v-action> Qu'en pensez-vous ?"
  </corps-voix>
</p-dial>
"Je suis d'accord \textnormal{(hochant vigoureusement la tĂŞte)} avec votre proposition. \textnormal{(se tournant vers Bob)} Qu'en pensez-vous ?"

Conseil

Utilisez v-action pour intégrer des actions brèves qui se produisent pendant que le personnage parle, sans interrompre le flux du dialogue. Pour des actions plus longues ou qui interrompent le dialogue, utilisez plutôt du texte narratif entre les balises v.

Exemple avec narration

â—Šp-dial[#:qui "Alice"]{
  ◊v{Je suis d'accord,} commença-t-elle en hochant vigoureusement la tête, mais elle prit une pause avant de continuer : ◊v{...avec votre proposition.}
}

v-separation

Utilisée pour séparer des paragraphes dans un même bloc de dialogue sans fermer les guillemets. Cette balise ajoute la classe non-closing à la balise corps-voix parente, ce qui empêche la fermeture des guillemets. Elle se traduit par un élément <br class="v-separation"> en HTML/EPUB.

Notation

v-separation est généralement employée avec les barres verticales de délimitation : ◊|v-separation|.

Ă€ propos des retours Ă  la ligne

Si vous souhaitez éviter les sauts de ligne entre les parties séparées, il ne doit pas y avoir d'espaces ni de retours à la ligne entre les balises v. Les balises ◊v{} doivent être enchaînées directement.

Attributs

Aucun attribut particulier.

Usage

pollen
◊p-dial[#:qui "Lierre"]{◊v{Par conviction, je dirais…◊|v-separation|}◊v{Quand je me suis retiré de la Cité Centrale de Lusso, j'ai rencontré un médecin militaire.◊|v-separation|}◊v{J'étais à sa merci, avec mes côtes cassées.◊|v-separation|}◊v{Je voulais plus me retrouver impuissant devant une personne dans le besoin… C'est pour ça que je me suis inscrit.}}
<p-dial p-dial-pos="first" qui="Lierre">
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "Par conviction, je dirais…<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "Quand je me suis retiré de la Cité Centrale de Lusso, j'ai rencontré un médecin militaire.<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "J'étais à sa merci, avec mes côtes cassées.<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "Je voulais plus me retrouver impuissant devant une personne dans le besoin… C'est pour ça que je me suis inscrit."
  </corps-voix>
</p-dial>
<p-dial p-dial-pos="first" qui="Lierre">
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "Par conviction, je dirais…<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "Quand je me suis retiré de la Cité Centrale de Lusso, j'ai rencontré un médecin militaire.<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix non-closing">
    <span class="prefix"></span>
    "J'étais à sa merci, avec mes côtes cassées.<br class="v-separation">
  </corps-voix>
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "Je voulais plus me retrouver impuissant devant une personne dans le besoin… C'est pour ça que je me suis inscrit."
  </corps-voix>
</p-dial>
"Par conviction, je dirais…\par
"Quand je me suis retiré de la Cité Centrale de Lusso, j'ai rencontré un médecin militaire.\par
"J'étais à sa merci, avec mes côtes cassées.\par
"Je voulais plus me retrouver impuissant devant une personne dans le besoin… C'est pour ça que je me suis inscrit."

Conseil

La balise v-separation permet de créer des dialogues complexes et naturels en : - Ajoutant la classe non-closing à la balise corps-voix parente pour maintenir les guillemets ouverts - Insérant un <br class="v-separation"> pour marquer la séparation entre les parties du dialogue - Gérant automatiquement la mise en forme selon le format de sortie (HTML, EPUB, PDF)

v-cri

Indique qu'un personnage crie ou parle très fort. Cette balise doit être utilisée à l'intérieur d'une balise v dans un contexte de dialogue. Le texte sera affiché dans une taille plus grande pour suggérer visuellement le cri.

Attributs

class

Classes CSS additionnelles. Utilisez "distant" pour signifier que la voix est entendue à travers un appareil électronique.

v-cri[#:class "distant"]{AU SECOURS !}
nombre

Indique le nombre de personnes qui parlent en mĂŞme temps. Ne pas mettre de guillemets autour de la valeur.

p-dial[#:qui "Alice,Bob"]{â—Šv{â—Šv-cri[#:nombre 2]{HOURRA !}}}
qui

Le nom du personnage qui parle. Vous devez mettre le vrai nom du personnage, quelle que soit la situation.

v-cri[#:qui "Alice"]{AU SECOURS !}

Usage

pollen
â—Šp-dial[#:qui "Bob"]{â—Šv{â—Šv-cri{AU SECOURS !}}}
<p-dial p-dial-pos="unique" qui="Bob">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "<corps-voix-cri>AU SECOURS !</corps-voix-cri>"
  </corps-voix>
</p-dial>
<p-dial p-dial-pos="unique" qui="Bob">
  <corps-voix class="fn-voix">
    <span class="prefix"></span>
    "<corps-voix-cri>AU SECOURS !</corps-voix-cri>"
  </corps-voix>
</p-dial>
"{\LARGE{\strut AU SECOURS !\strut}}"

Conseil

Pour les cris, il est recommandé d'utiliser des majuscules pour renforcer visuellement l'effet du cri. En HTML et EPUB, l'apparence du texte crié est contrôlée par les styles CSS. En LaTeX, le texte est automatiquement affiché dans une taille plus grande.