====== 7. Écriture vivante ======

Deux mécaniques discrètes mais qui changent beaucoup la qualité de l’écriture : les **balises de mention** (pour éviter qu’un objet déjà cité dans une description soit listé une seconde fois) et la **conjugaison automatique** d’un verbe selon le nombre de l’objet courant.

📚 Il existe aussi des balises d’**accord grammatical** (article, pronom, pluriel, féminin) — non couvertes par les tutoriels pour l’instant, mais documentées dans la [[reference:texte:start|référence sur les balises de texte]].

===== Mentionner un objet sans le lister =====

Quand un objet est dans un lieu, le moteur l’ajoute //automatiquement// en fin de description (« Vous voyez ici : la valise de cuir. »). Si vous l’aviez déjà nommé dans la prose de la description, ça fait doublon. La parade : les balises de mention, qui marquent un objet comme //déjà cité//.

  * ''[@X]'' — l’objet est visible et déjà mentionné dans la phrase. Il ne sera pas re-listé en bas.
  * ''[#X]'' — mention //sans// présupposer la visibilité. Utile pour parler d’un objet absent ou évoqué.
  * ''[&X]'' — l’objet est déjà connu du joueur (cas plus rare, pour des suites narratives).

<code donjon>
Le compartiment sept est un lieu.
Sa description est "Le compartiment sept. [@valise de cuir] est posée sur la banquette, étiquette tournée vers vous. Une légère odeur de [#tabac froid] flotte encore.".

La valise de cuir est un objet dans le compartiment sept.
Sa description est "Une valise patinée, étiquette effacée.".
</code>

[[djnc>wiki_tuto-train_07_a_balises_mention|tester cet exemple]]

Sans le ''[@]'', la valise apparaîtrait deux fois — une fois dans la prose, une fois dans la liste automatique. Avec ''[@]'', elle est mentionnée une seule fois. Le ''[#tabac froid]'' fait référence à un objet //qui n’existe pas// — c’est juste une accroche sensorielle, et le moteur ne tentera pas de la lister.

===== Conjuguer un verbe selon le nombre =====

L’accord article / pronom / adjectif est déjà couvert au Cirque Étoile. Restent les **verbes** : ''est'' au singulier, ''sont'' au pluriel, ''ait'' / ''aient'' au subjonctif. Donjon FI les conjugue automatiquement via la balise ''[v <verbe> <mode-temps> X]'' :

  * ''[v être ipr X]'' — ''est'' / ''sont'' (indicatif présent).
  * ''[v avoir spr X]'' — ''ait'' / ''aient'' (subjonctif présent).

<code donjon>
Le carnet noir est un objet dans le compartiment sept.
Les lunettes anciennes sont un objet dans le compartiment sept.

règle après examiner un objet:
  dire "[Le ceci] [v être ipr ceci] discrètement posé sur la banquette. Il faudrait que vous [v avoir spr ceci] le temps de tout fouiller.".
fin règle
</code>

[[djnc>wiki_tuto-train_07_b_conjugaison|tester cet exemple]]

Examinez successivement le carnet (singulier) puis les lunettes (pluriel) : la phrase ''dire'' reste **strictement identique** dans le code, mais le rendu joueur conjugue ''est'' → ''sont'' et ''ait'' → ''aient'' automatiquement. Plus besoin d’écrire deux versions ni de tester le nombre avec un ''si''.

===== À retenir =====

  * **Balises de mention** : ''[@X]'' (visible et cité), ''[#X]'' (cité non visible), ''[&X]'' (déjà connu). Évitent les doublons dans la liste auto.
  * **Conjugaison automatique** : ''[v <verbe> <mode-temps> X]''. Les verbes principaux du moteur (''être'', ''avoir'') sont déjà connus ; les modes courants : ''ipr'' (indicatif présent), ''spr'' (subjonctif présent), …
  * Combinez avec les balises d’accord (voir [[reference:texte:start|référence sur les balises de texte]]) pour écrire des règles génériques (''règle après examiner un objet'') qui produisent du texte cohérent pour tous les objets concernés.

Suite : [[tutoriels:train:partie8_inclure|8. Découper son scénario]]