Balises de contexte
Cette page regroupe les balises qui définissent le contexte narratif et la structure du contenu. Ces balises déterminent comment le texte qu'elles contiennent doit être interprété et mis en forme.
Par exemple, le contenu placé dans une balise livre-chapitre-corps-poeme sera formaté comme un poème, tandis que le contenu dans livre-chapitre-corps sera traité comme du texte narratif standard. Le contexte influence non seulement la mise en page, mais aussi le comportement des balises enfants (comme les dialogues ou les séparateurs).
Les contextes ne sont généralement pas imbriqués entre eux, ils se suivent plutôt les uns après les autres pour définir différentes sections du document.
Sections non imbriquables
Les sections ne sont généralement pas imbriquables entre elles (ou plutôt, leurs imbrications n'ont pas été testées pour la plupart). Ce sont donc très souvent des sections qui se suivent les unes derrière les autres.
div
Crée un bloc de contenu générique. En LaTeX, ajoute automatiquement un retour à la ligne (\par) à la fin du bloc.
À utiliser parcimonieusement dans le corps de texte, préférer les balises de contexte spécifiques quand c'est possible.
livre-chapitre-corps
Corps principal d'un chapitre. Un chapitre peut contenir 0, 1, ou plusieurs de cette balise. C'est la balise la plus utilisée pour le corps de texte d'un chapitre.
Attributs
style-dialogue-
Optionnel. Détermine le style de dialogue contenu dans cette balise.
Exemples de valeurs :
fr-FR: style classique français.fr-WB: style classique français mais sans les guillemets (un peu comme dans le théâtre).
Par défaut, un style avec guillemets anglais est utilisé par Fabrilivre.
Voir la documentation sur les dialogues pour plus de détails.
Usage
◊livre-chapitre-corps[#:style-dialogue "fr-FR"]{
Voici le début de ce chapitre. Le texte sera formaté comme du contenu narratif standard.
◊p-dial[#:qui "Personnage 1"]{◊v{Bonjour,} dit-il. ◊v{Comment allez-vous ?}}
◊p-dial[#:qui "Personnage 2"]{◊v{Très bien, merci,} répondit-elle.}
}
<livre-chapitre-corps style-dialogue="fr-FR">
<p>Voici le début de ce chapitre. Le texte sera formaté comme du contenu narratif standard.</p>
<p-dial qui="Personnage 1">
<corps-voix>« Bonjour, »</corps-voix> dit-il. <corps-voix>« Comment allez-vous ? »</corps-voix>
</p-dial>
<p-dial qui="Personnage 2">
<corps-voix>« Très bien, merci, »</corps-voix> répondit-elle.
</p-dial>
</livre-chapitre-corps>
<livre-chapitre-corps style-dialogue="fr-FR">
<p>Voici le début de ce chapitre. Le texte sera formaté comme du contenu narratif standard.</p>
<p-dial qui="Personnage 1">
<corps-voix>« Bonjour, »</corps-voix> dit-il. <corps-voix>« Comment allez-vous ? »</corps-voix>
</p-dial>
<p-dial qui="Personnage 2">
<corps-voix>« Très bien, merci, »</corps-voix> répondit-elle.
</p-dial>
</livre-chapitre-corps>
livre-chapitre-corps-annonce
Balise pour les annonces ou déclarations importantes dans le texte. Mise en forme distinctive pour attirer l'attention.
Usage
◊livre-chapitre-corps-annonce{
ATTENTION : Ce message est important et doit être lu avec attention.
}
livre-chapitre-corps-haiku
Balise spécialisée pour les haïkus. Formatage spécifique pour ce type de poème japonais.
Usage
livre-chapitre-corps-poeme
Balise pour formater du contenu comme un poème. Le texte sera mis en forme avec une indentation et un espacement appropriés pour la poésie.
Usage
◊livre-chapitre-corps-poeme{
Dans la nuit silencieuse,
Les étoiles brillent doucement,
Témoins de nos rêves secrets.
}
livre-chapitre-corps-separateur
Balise pour créer des séparateurs visuels dans le texte. Peut contenir du texte personnalisé ou utiliser un séparateur par défaut.
Usage
◊livre-chapitre-corps-separateur{}
◊livre-chapitre-corps-separateur{***}
◊livre-chapitre-corps-separateur{Chapitre suivant}
livre-chapitre-intro
Crée une introduction ou une épigraphe pour un chapitre. Cette balise est généralement utilisée pour placer une citation, une dédicace ou un texte introductif avant le contenu principal du chapitre.
L'introduction peut contenir du texte narratif standard avec livre-chapitre-corps et se termine généralement par une référence bibliographique avec livre-chapitre-intro-reference.
Attributs
Aucun attribut particulier.
Usage
◊livre-chapitre-intro{
◊livre-chapitre-corps{Trois semaines. C'est ton espérance de vie restante dès que tu nous auras quittés. Que ce soient des zneps à l'affut de chair humaine, des factions hostiles, ou des maladies nouvelles et résurgentes. Les dangers sont nombreux en surface.}
◊livre-chapitre-intro-reference{
◊livre-chapitre-intro-reference-auteur{Oncle Foley}
◊livre-chapitre-intro-reference-titre{Convocation de fin d'année}}
}
<livre-chapitre-intro>
<livre-chapitre-corps>
<p>Trois semaines. C'est ton espérance de vie restante dès que tu nous auras quittés. Que ce soient des zneps à l'affut de chair humaine, des factions hostiles, ou des maladies nouvelles et résurgentes. Les dangers sont nombreux en surface.</p>
</livre-chapitre-corps>
<livre-chapitre-intro-reference>
— Oncle Foley, Convocation de fin d'année.
</livre-chapitre-intro-reference>
</livre-chapitre-intro>
<livre-chapitre-intro>
<livre-chapitre-corps>
<p>Trois semaines. C'est ton espérance de vie restante dès que tu nous auras quittés. Que ce soient des zneps à l'affut de chair humaine, des factions hostiles, ou des maladies nouvelles et résurgentes. Les dangers sont nombreux en surface.</p>
</livre-chapitre-corps>
<livre-chapitre-intro-reference>
— Oncle Foley, Convocation de fin d'année.
</livre-chapitre-intro-reference>
</livre-chapitre-intro>
\begin{epigraph}
Trois semaines. C'est ton espérance de vie restante dès que tu nous auras quittés. Que ce soient des zneps à l'affut de chair humaine, des factions hostiles, ou des maladies nouvelles et résurgentes. Les dangers sont nombreux en surface.
\vspace{0.5em} \raggedleft — Oncle Foley, Convocation de fin d'année.
\end{epigraph}
Structure recommandée
Une introduction de chapitre typique suit cette structure hiérarchique :
livre-chapitre-intro
├── livre-chapitre-corps
│ └── (texte narratif de l'introduction)
└── livre-chapitre-intro-reference
├── livre-chapitre-intro-reference-auteur
├── livre-chapitre-intro-reference-titre
└── livre-chapitre-intro-reference-date (optionnel)
Note importante : Les balises -auteur, -titre et -date sont directement contenues dans livre-chapitre-intro-reference, pas dans des balises séparées.
livre-chapitre-intro-reference
Crée une référence bibliographique pour l'introduction d'un chapitre. Cette balise formate automatiquement les références avec des tirets et des virgules, et ajoute un point final.
Cette balise peut contenir des sous-balises pour structurer la référence :
- livre-chapitre-intro-reference-auteur - Nom de l'auteur
- livre-chapitre-intro-reference-titre - Titre de l'œuvre
- livre-chapitre-intro-reference-date - Date (optionnel)
Attributs
Aucun attribut particulier.
Usage
◊livre-chapitre-intro-reference{
◊livre-chapitre-intro-reference-auteur{Fanny}
◊livre-chapitre-intro-reference-titre{réfectoire de Forthwin}
◊livre-chapitre-intro-reference-date{26 octobre 2324}
}
Formatage automatique
La balise livre-chapitre-intro-reference formate automatiquement le contenu :
- Ajoute un tiret au début
- Sépare les éléments par des virgules
- Ajoute un point final
- En LaTeX, aligne à droite avec un espacement
Exemple complet de structure de chapitre
Voici un exemple complet montrant comment structurer un chapitre avec introduction :
◊(define-meta title "Mon Chapitre")
◊livre-chapitre-titre{Mon Chapitre}
◊livre-chapitre-intro{
◊livre-chapitre-corps{Voici le texte d'introduction qui donne le contexte ou cite une source importante pour ce chapitre.}
◊livre-chapitre-intro-reference{
◊livre-chapitre-intro-reference-auteur{Jean Dupont}
◊livre-chapitre-intro-reference-titre{Mémoires d'un voyageur}
◊livre-chapitre-intro-reference-date{15 mars 2024}
}
}
◊livre-chapitre-corps{
Le contenu principal du chapitre commence ici...
}
◊livre-chapitre-corps-separateur{}
◊livre-chapitre-corps{
Suite du contenu après un séparateur...
}
livre-chapitre-intro-reference-auteur
Spécifie l'auteur d'une référence bibliographique dans une introduction de chapitre.
Attributs
Aucun attribut particulier.
Usage
livre-chapitre-intro-reference-date
Spécifie la date d'une référence bibliographique dans une introduction de chapitre.
Attributs
Aucun attribut particulier.
Usage
livre-chapitre-intro-reference-titre
Met en forme le titre d'une référence bibliographique dans une introduction de chapitre. Le texte sera affiché en italique.
Attributs
Aucun attribut particulier.
Usage
livre-chapitre-titre
Utilisez pour inclure le titre principal d'un chapitre, généralement en haut de chapitre.
Attributs
Aucun attribut particulier.
Usage
section-isolee
Crée une section isolée du reste du contenu. Cette balise est utilisée pour des passages qui doivent être visuellement séparés du texte principal, comme des notes importantes, des avertissements ou des contenus spéciaux.
Attributs
Aucun attribut particulier.
Usage
◊section-isolee{
ATTENTION : Ce passage contient des informations importantes
qui nécessitent une attention particulière.
}