Outils pour utilisateurs

Outils du site


fr:yaml:texte

Ceci est une ancienne révision du document !


Language / Langue : FR | 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) :

texte: "[[Mémo : la clé se trouve dans la bibliothèque.]]"

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

texte: |
  ```diff
  - ancienne règle
  + nouvelle règle
  ```
 
  ```python
  def lancer_de(faces):
      return random.randint(1, faces)
  ```

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 :

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.
  ```

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) :

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"
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) :

- id: salle_nuit
  fond: "#0d1117"
  texte: "Il fait nuit noire."

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 : Sons, images et vidéos

Éléments inline interactifs

Les doubles accolades servent aussi à rendre un mot, une phrase ou une image interactive :

texte: "La %%{{porte:?Une vieille porte.}}%% est fermée."
texte: "Touchez le %%{{levier:@activer_levier}}%%."
texte: "Posez la %%{{clé:>cle}}%% sur la %%{{porte:$porte}}%%."

Voir Tooltips interactifs, Éléments cliquables et Glisser-déposer.

Les tuiles et grilles utilisent la syntaxe image étendue : Tuiles et tilemaps.

Réutiliser le texte d'une autre salle

[[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.

texte: "Le couloir se prolonge.[[SALLE:12]]"

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.

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.

Pour construire une conversation plutôt qu'un simple texte, voir Dialogues et séquences.

Retrouvez nous sur le discord Make&Play

fr/yaml/texte.1788117997.txt.gz · Dernière modification : de cyrilfiesta