**Language / Langue :** **FR** | [[en:yaml:texte|EN]]

====== Texte et formatage (YAML) ======

===== Retours à la ligne =====

Dans un bloc YAML ''texte: |'', les retours à la ligne du fichier sont respectés tels quels.

Pour un retour à la ligne **affiché** dans Discord (dans les formats qui ne supportent pas les vraies nouvelles lignes) : utiliser ''+n+''.

===== Bloc texte encadré =====

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: "[[Mémo : la clé se trouve dans la bibliothèque.]]"
</code>

===== Formatage Markdown inline =====

Ces styles fonctionnent **dans tous les modes** (quel que soit ''markdown:'' global) :

^ Syntaxe ^ Rendu ^
| ''%%**texte**%%'' | **Gras** |
| ''%%*texte*%%'' | //Italique// |
| ''%%__texte__%%'' | Souligné |
| ''%%~~texte~~%%'' | ~~Barré~~ |
| %%``texte``%% | Code inline |
| ''%%||texte||%%'' | Spoiler (cliquer pour révéler) |
| ''> texte'' (sur sa propre ligne) | Citation blockquote |

===== Blocs de code colorés =====

<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: |
  ```narration
  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
  **Objectif mis à jour** : Trouver l'origine de la cloche.
  ```

  ```journal
  Nuit du 14 octobre. Troisième nuit sans sommeil.
  ```
</code>

Cinq types : ''narration'' · ''dialogue'' · ''pensee'' · ''systeme'' · ''journal''

Le rendu visuel dépend du **style UI choisi par le joueur** (classique, rpg, terminal, aventure) — pas une clé YAML auteur.

===== 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 normal sans style"
  - taille: 28
    police: Georgia
    texte: "Titre en Georgia 28 px"
  - taille: 14
    police: monospace
    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>

^ 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"'') |

⚠ 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>
- id: salle_nuit
  fond: "#0d1117"
  texte: "Il fait nuit noire."
</code>

===== Champ markdown: global =====

Défini en en-tête du scénario, il enveloppe **tout** le texte des salles :

^ 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é |

→ Voir aussi : [[fr:yaml:medias|Sons, images et vidéos]]

**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**