Différences

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

--- fr:yaml:texte [2026/10/09 23:48] – Documentation 4.16 : generation et mises a jour de l'editeur cyrilfiesta
+++ fr:yaml:texte [2026/11/04 23:29] (Version actuelle) – Documentation 4.17 : objets, evenements et mise en page verifies cyrilfiesta
@@ Ligne 74: / Ligne 74: @@
 </code>
-Cinq types : ''narration'' · ''dialogue'' · ''pensee'' · ''systeme'' · ''journal''
+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.
@@ Ligne 104: / Ligne 104: @@
 | ''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.
+Ces clés s'appliquent au bloc entier. Pour styler un seul mot, utiliser le Markdown inline.
 ===== Couleur de fond d'une salle =====
@@ Ligne 127: / Ligne 127: @@
 | ''quote'' | Citation blockquote |
 | ''story'' | Blocs sémantiques actifs |
-| ''py'' / ''yaml'' / ''js'' / … | Bloc code coloré |
+| ''py'' / ''yaml'' / ''js'' / ... | Bloc code coloré |
 Les syntaxes de médias sont détaillées dans [[fr:yaml:medias|Sons, images et vidéos]].
 ===== Éléments inline interactifs =====
@@ Ligne 137: / Ligne 136: @@
 <code yaml>
-texte: "La %%{{porte:?Une vieille porte.}}%% est fermée."
+texte:
-texte: "Touchez le %%{{levier:@activer_levier}}%%."
+  - "La {{porte:?Une vieille porte.}} est fermée."
-texte: "Posez la %%{{clé:>cle}}%% sur la %%{{porte:$porte}}%%."
+  - "Touchez le {{levier:@activer_levier}}."
+  - "Posez la {{clé:>cle}} sur la {{porte:$porte}}."
 </code>
@@ Ligne 145: / Ligne 145: @@
 Les tuiles et grilles utilisent la syntaxe image étendue : [[fr:yaml:tuiles-tilemaps|Tuiles et tilemaps]].
 ===== Réutiliser le texte d'une autre salle =====
@@ Ligne 163: / Ligne 162: @@
 ===== Liste des choix dans le texte =====
-''%%[[choix_vertical]]%%'' affiche les alias des choix de la salle sur plusieurs lignes. ''%%[[choix_horizontal]]%%'' les sépare par « / ». Les formes anglaises ''%%[[choice_vertical]]%%'' et ''%%[[choice_horizontal]]%%'' fonctionnent aussi.
+''%%[[choix_vertical]]%%'' affiche les alias des choix de la salle sur plusieurs lignes. ''%%[[choix_horizontal]]%%'' les sépare par " / ". Les formes anglaises ''%%[[choice_vertical]]%%'' et ''%%[[choice_horizontal]]%%'' fonctionnent aussi.
 <code yaml>
@@ Ligne 176: / Ligne 175: @@
         vers: coffre
       - vers: couloir
+  - id: coffre
+    texte: Le coffre.
+  - id: couloir
+    texte: Le couloir.
 </code>
-La liste affiche « fouiller » et « 2 ». Sans alias, un choix utilise son numéro dans la liste déclarée, utilisable directement ou avec ''avancer''. Les alias modifiés et les choix ajoutés sont pris en compte lors du jeu et dans l'aperçu. Les choix masqués par leurs conditions ne sont pas annoncés ; les numéros des autres choix ne changent pas.
+La liste affiche "fouiller" et "2". Sans alias, un choix utilise son numéro dans la liste déclarée, utilisable directement ou avec ''avancer''. Les alias modifiés et les choix ajoutés sont pris en compte lors du jeu et dans l'aperçu. Les choix masqués par leurs conditions ne sont pas annoncés ; les numéros des autres choix ne changent pas.
 Le [[fr:editeur:generation|générateur de fiction interactive]] peut ajouter ce texte, des alias numérotés et des boutons de choix. Les textes de sorties directionnelles des labyrinthes et donjons sont, eux, remplacés lors de la génération.
+===== Textes composés et boucles (4.17) =====
+Un groupe peut porter une condition et un style, puis contenir d'autres textes ou boucles. Le style est hérité ; un enfant peut le préciser.
+<code yaml>
+texte:
+  - si: v_visible_v = 1
+    taille: 23
+    texte:
+      - pour_chaque: objet
+        dans: sac
+        faire:
+          - texte: t_objet_t
+</code>
+Déclarer ici ''visible'' dans ''vars:'' et ''sac'' dans ''listes:''. Dans un texte ou un HUD, les boucles ne modifient pas les données. Les médias habituels sont admis, sans pause ni interaction ; leur répétition dépend des conditions de l'auteur et des règles de lecture du client.
+Écrire les balises de médias dans le scénario : ''%%[[t_objet.image_t]]%%'' lit une adresse. Une valeur insérée comme ''t_objet.nom_t'' reste du texte, même si elle contient des balises. Voir [[fr:yaml:listes-boucles|Listes et boucles]]. Dans l'éditeur, **Contenu composé** crée ce groupe.
+===== Objets du meuble et inventaire vertical =====
+''%%[[OBJET_DANS:coffre]]%%'' insère l'identifiant du premier objet présent dans ce meuble de la salle courante, ou un texte vide si le meuble est vide. La forme anglaise est ''%%[[ITEM_IN:coffre]]%%''.
+''%%[[INVENTAIRE_VERTICAL]]%%'' affiche un objet par ligne, avec les identifiants et les quantités regroupées. La forme anglaise est ''%%[[INVENTORY_VERTICAL]]%%''.
+<code yaml>
+titre: 'Wiki 4.17 : inventaire'
+langue: fr
+salles:
+  - id: atelier
+    auto_refresh: true
+    texte: |
+      Inventaire :
+      [[INVENTAIRE_VERTICAL]]
+      Premier objet du coffre : [[OBJET_DANS:coffre]]
+    objets:
+      - nom: cle
+        endroit: coffre
+        reaction_prise: Prendre
+    choix:
+      - commande: regarder
+        bouton: Regarder
+        vers: atelier
+</code>
+''reaction_prise: Prendre'' ajoute le bouton natif de prise de cet objet dans ce meuble. ''auto_refresh: true'' actualise le texte après la prise : la clé apparaît dans l'inventaire vertical et le coffre est vide. Le choix «Regarder» réaffiche la salle sans prendre d'objet.
+===== Nom de la salle précédente =====
+''%%[[SALLE_PRECEDENTE]]%%'' insère l'identifiant de la salle précédente connue, pas son texte ni son bouton. Avant le premier déplacement, le résultat est vide. Cette balise n'a pas d'alias anglais.
+<code yaml>
+titre: 'Wiki 4.17 : précédent'
+salles:
+- id: entree
+  texte: 'Précédente : [[SALLE_PRECEDENTE]]'
+  choix:
+  - bouton: Suite
+    vers: atelier
+- id: atelier
+  texte: 'Précédente : [[SALLE_PRECEDENTE]]'
+  choix:
+  - bouton: Retour
+    vers: entree
+</code>
+===== Alignement local et séparations dimensionnées =====
+Sur Web, Desktop et dans l'export HTML, ''%%[[align:gauche]]texte[[/align]]%%'' aligne un bloc. Les directions sont ''gauche'', ''centre'', ''droite'' ou ''left'', ''center'', ''right''. Une variable textuelle comme ''t_cote_t'' peut donner la direction. Fermez le bloc avec ''%%[[/align]]%%''.
+''%%[[split]]%%'' sépare des zones. ''%%[[split:40]]%%'' réserve 40 % à la zone précédente ; le reste va à la suivante. La séparation et l'alignement fonctionnent aussi dans les encadrés HUD.
+<code yaml>
+titre: 'Wiki 4.17 : alignement'
+vars_texte:
+  cote: droite
+salles:
+- id: atelier
+  texte: |
+    [[align:gauche]]Gauche.[[/align]]
+    [[align:centre]]Centre.[[/align]]
+    [[align:t_cote_t]]Droite.[[/align]]
+    [[split:40]]
+    Seconde zone.
+  choix:
+  - commande: rester
+    bouton: Rester
+    vers: atelier
+</code>