Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:yaml:texte [2026/05/03 17:01] – Texte et formatage YAML cyrilfiesta
+++ fr:yaml:texte [2026/08/31 21:11] (Version actuelle) – Wiki : fins de pages homogènes, liens Discord retirés cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-====== Syntaxe YAML — Texte et formatage ======
+**Language / Langue :** **FR** | [[en:yaml:texte|EN]]
-===== Texte simple =====
+====== Texte et formatage (YAML) ======
-<code yaml>
+===== Retours à la ligne =====
-texte: "Une ligne de texte simple."
-</code>
-Pour un texte multiligne, utilisez le bloc YAML ''|'' :
+Dans un bloc YAML ''texte: |'', les retours à la ligne du fichier sont respectés tels quels.
-<code yaml>
+Pour un retour à la ligne **affiché** dans Discord (dans les formats qui ne supportent pas les vraies nouvelles lignes) : utiliser ''+n+''.
-texte: |
-  Première ligne.
-  Deuxième ligne.
-  Troisième ligne.
-</code>
-===== Sauts de ligne =====
+===== Bloc texte encadré =====
-Le tag ''+n+'' force un saut de ligne dans le rendu Discord :
+Quand le contenu entre ''%%[[%%'' et ''%%]]%%'' n'est pas une URL d'image, il s'affiche dans un encart (bloc code sur Discord, boîte sur web/desktop) :
 <code yaml>
-texte: "Ligne 1+n+Ligne 2+n+Ligne 3"
+texte: "[[Mémo : la clé se trouve dans la bibliothèque.]]"
 </code>
-===== Formatage Discord =====
+===== Formatage Markdown inline =====
+Ces styles fonctionnent **dans tous les modes** (quel que soit ''markdown:'' global) :
 ^ Syntaxe ^ Rendu ^
-| ''**texte**'' | **Gras** |
+| ''%%**texte**%%'' | **Gras** |
-| ''*texte*'' | //Italique// |
+| ''%%*texte*%%'' | //Italique// |
-| ''__texte__'' | Souligné |
+| ''%%__texte__%%'' | Souligné |
-| ''~~texte~~'' | Barré |
+| ''%%~~texte~~%%'' | ~~Barré~~ |
-| ''%%`texte`%%'' | Code inline |
+| %%``texte``%% | Code inline |
-| ''%%||spoiler||%%'' | Texte masqué |
+| ''%%||texte||%%'' | Spoiler (cliquer pour révéler) |
+| ''> texte'' (sur sa propre ligne) | Citation blockquote |
-===== Blocs sémantiques =====
+===== Blocs de code colorés =====
-Utilisez des blocs de code avec un type pour un rendu narratif soigné :
+<code yaml>
+texte: |
+  ```diff
+  - ancienne règle
+  + nouvelle règle
+  ```
+  ```python
+  def lancer_de(faces):
+      return random.randint(1, faces)
+  ```
+</code>
+Langages supportés : ''diff'', ''yaml'', ''python'', ''js'', ''json'', ''bash'', et tous ceux supportés par highlight.js (web/desktop). Sur Discord, rendu en bloc code générique.
+===== Blocs sémantiques (markdown: story) =====
+En ajoutant ''markdown: story'' dans l'en-tête du scénario, cinq types de blocs narratifs sont disponibles avec chacun leur rendu visuel distinct :
 <code yaml>
 texte: |
-  ```story
+  ```narration
-  *Le vent souffle entre les ruines...*
+  La brume s'épaissit entre les arbres. Quelque chose vous observe.
   ```
+  ```dialogue
+  **L'inconnu** : Vous n'auriez pas dû venir ici.
+  ```
+  ```pensee
+  *Il ment. Ses mains tremblent légèrement.*
+  ```
   ```systeme
-  Vous perdez 5 PV.
+  **Objectif mis à jour** : Trouver l'origine de la cloche.
   ```
-  ```dialogue
-  « Qui êtes-vous ? » demande le garde.
+  ```journal
+  Nuit du 14 octobre. Troisième nuit sans sommeil.
   ```
 </code>
-^ Bloc ^ Usage ^
+Cinq types : ''narration'' · ''dialogue'' · ''pensee'' · ''systeme'' · ''journal''
-| ''story'' | Narration principale |
-| ''systeme'' | Messages de jeu, stats |
-| ''dialogue'' | Répliques de personnages |
-| ''pensee'' | Monologue intérieur |
-| ''journal'' | Notes, archives, carnets |
-===== Texte conditionnel inline =====
+Le rendu visuel dépend du **style UI choisi par le joueur** (classique, rpg, terminal, aventure) - pas une clé YAML auteur.
-Un même texte peut varier selon l'état du jeu :
+===== Styles par bloc (v4.9) =====
+Dans une liste ''texte:'', chaque bloc peut avoir son propre style (web/desktop uniquement - ignoré sur Discord et terminal) :
 <code yaml>
 texte:
-  - texte: "Vous êtes en bonne santé."
+  - "Texte normal sans style"
-    si: "v_pv_v >= 8"
+  - taille: 28
-  - texte: "Vous êtes blessé."
+    police: Georgia
-    si: "v_pv_v >= 4"
+    texte: "Titre en Georgia 28 px"
-  - texte: "Vous êtes à l'agonie !"
+  - taille: 14
-    si: "~"
+    police: monospace
-  - "Ce texte s'affiche toujours en dessous."
+    fond: "#111827"
+    couleur-texte: "#facc15"
+    texte: "Badge en monospace avec fond sombre"
+  - taille: 18
+    si: "v_score_v > 0"
+    texte: "Affiché seulement si score > 0 : v_score_v pts"
 </code>
-===== Variables dans le texte =====
+^ Clé ^ Valeur ^
+| ''taille:'' | Taille en pixels (ex: ''18'', ''24'') |
+| ''police:'' | Famille CSS (ex: ''Georgia'', ''monospace'', ''cursive'') |
+| ''fond:'' | Couleur de fond CSS (ex: ''"#111827"'') |
+| ''couleur-texte:'' | Couleur du texte CSS (ex: ''"#facc15"'') |
-Utilisez ''v_nom_v'' pour afficher la valeur d'une variable :
+⚠ Ces clés s'appliquent au bloc entier. Pour styler un seul mot, utiliser le Markdown inline.
+===== Couleur de fond d'une salle =====
+La clé ''fond:'' sur une salle définit la couleur d'arrière-plan pour cette salle uniquement (web/desktop) :
 <code yaml>
-texte: "Il vous reste v_pv_v points de vie et v_or_v pièces d'or."
+- id: salle_nuit
+  fond: "#0d1117"
+  texte: "Il fait nuit noire."
 </code>
-Pour les variables texte : ''t_nom_t''
+===== Champ markdown: global =====
-Pour les variables online : ''v_score_o_v''
+Défini en en-tête du scénario, il enveloppe **tout** le texte des salles :
-===== Formatage des nombres =====
+^ Valeur ^ Rendu ^
+| ''fix'' | Bloc monospace (défaut) |
+| ''none'' | Texte brut |
+| ''bold'' | Gras |
+| ''italic'' | Italique |
+| ''quote'' | Citation blockquote |
+| ''story'' | Blocs sémantiques actifs |
+| ''py'' / ''yaml'' / ''js'' / … | Bloc code coloré |
-Le suffixe ''|padN'' ajoute des zéros devant un nombre :
+Les syntaxes de médias sont détaillées dans [[fr:yaml:medias|Sons, images et vidéos]].
-<code yaml>
-texte: "Temps : v_minutes_v:v_secondes_v|pad2"
-# Affiche "Temps : 2:05" au lieu de "Temps : 2:5"
-</code>
-===== Images =====
+===== Éléments inline interactifs =====
+Les doubles accolades servent aussi à rendre un mot, une phrase ou une image interactive :
 <code yaml>
-texte: "[[https://monsite.fr/image.png]]"
+texte: "La %%{{porte:?Une vieille porte.}}%% est fermée."
+texte: "Touchez le %%{{levier:@activer_levier}}%%."
+texte: "Posez la %%{{clé:>cle}}%% sur la %%{{porte:$porte}}%%."
 </code>
-L'URL peut contenir des variables :
+Voir [[fr:yaml:tooltips|Tooltips interactifs]], [[fr:yaml:elements-cliquables|Éléments cliquables]] et [[fr:yaml:glisser-deposer|Glisser-déposer]].
-<code yaml>
+Les tuiles et grilles utilisent la syntaxe image étendue : [[fr:yaml:tuiles-tilemaps|Tuiles et tilemaps]].
-texte: "[[https://monsite.fr/images/{zone}.png]]"
-</code>
-===== Sons =====
-<code yaml>
+===== Réutiliser le texte d'une autre salle =====
-texte: "<<https://monsite.fr/sons/ambiance.mp3>>"
-</code>
-===== Vidéos =====
+''%%[[SALLE:n]]%%'' insère le contenu narratif de la salle numéro //n// à l'endroit où vous l'écrivez. Pratique pour une description ou une réplique récurrente, écrite une seule fois.
 <code yaml>
-texte: "((https://monsite.fr/videos/intro.mp4))"
+texte: "Le couloir se prolonge.[[SALLE:12]]"
-texte: "((loop;autoplay;muted:https://monsite.fr/videos/boucle.mp4))"
 </code>
-===== Style par bloc =====
+La forme anglaise est ''%%[[ROOM:n]]%%''. Les renvois circulaires sont détectés et arrêtés : une salle ne peut pas s'inclure elle-même, directement ou indirectement.
-<code yaml>
+Le renvoi fonctionne sur le web, dans le logiciel et dans un export HTML5. Discord, le Terminal et le PDF affichent le texte référencé sous leur forme linéaire habituelle.
-texte:
-  - taille: 32
+Pour construire une conversation plutôt qu'un simple texte, voir [[fr:yaml:dialogues|Dialogues et séquences]].
-    police: Georgia
-    couleur-texte: "#c9a84c"
-    texte: "Titre imposant"
-  - taille: 14
-    texte: "Texte normal plus petit."
-</code>