====== Synonymes ======

Un **synonyme** est un nom alternatif que le joueur peut utiliser pour désigner un élément (ou une action) du scénario. Donjon FI gère trois sources de synonymes :

  - **Automatiques** — générés à partir des mots de l’intitulé.
  - **Explicites** — déclarés dans le scénario avec ''Interpréter''.
  - **Dynamiques** — ajoutés ou remplacés en cours de partie avec ''ajouter'' ou ''changer''.

===== Synonymes automatiques =====

Par défaut, le moteur extrait les mots de l’intitulé d’un élément et en fait des synonymes.

<code donjon>
La boîte rouge est un objet ici.
-- Synonymes générés : « boîte », « rouge »
</code>

Le joueur peut écrire ''examiner boîte'' ou ''examiner rouge'' — les deux désignent la boîte rouge.

Quand vous changez l’intitulé via [[reference:instructions:changer|changer]], les synonymes automatiques sont recalculés :

<code donjon>
changer l’intitulé de la boîte rouge est "le coffre bleu".
-- Nouveaux synonymes auto : « coffre », « bleu »
-- (« boîte » et « rouge » ne fonctionnent plus.)
</code>

===== Synonymes explicites avec Interpréter =====

Pour ajouter des noms alternatifs qui n’apparaissent pas dans l’intitulé, utilisez ''Interpréter'' à la compilation :

<code donjon>
La bibliothèque est un contenant ici.
Interpréter la bib et l’étagère comme la bibliothèque.

Le grand livre est un objet dans la bibliothèque.
Interpréter le livre, l’ouvrage et le bouquin comme le grand livre.
</code>

Le joueur peut maintenant écrire ''examiner bib'', ''ouvrir étagère'', ''lire bouquin'', etc.

===== Synonymes d’actions =====

Le verbe ''interpréter'' fonctionne aussi pour rediriger un verbe vers une action existante :

<code donjon>
interpréter regarder et observer comme examiner.
interpréter déchirer et détruire comme casser.
interpréter fouiller comme examiner.
</code>

Ainsi, ''regarder la table'', ''observer la table'' et ''examiner la table'' déclenchent toutes l’action [[reference:routines:action:start|examiner]].

<file donjon wiki_synonymes_interpreter_bibliotheque>
Le bureau est un lieu.

La bibliothèque est un contenant ici.
Interpréter la bib et l'étagère comme la bibliothèque.

Le grand livre est un objet dans la bibliothèque.
Interpréter le livre, l'ouvrage et le bouquin comme le grand livre.

interpréter regarder et observer comme examiner.

règle avant commencer le jeu:
  dire "Essayez : {/observer la bib/}, {/examiner étagère/}, {/regarder bouquin/}, {/examiner ouvrage/}.".
fin règle
</file>

[[djnc>wiki_synonymes_interpreter_bibliotheque|tester cet exemple]]

===== Quand l’ambigüité force une précision =====

Si plusieurs éléments visibles partagent le même synonyme, Donjon FI demande au joueur de préciser :

<code donjon>
La clé rouillée est une clé sur la table.
La clé dorée est une clé sur la table.
La clé rouge est une clé sur la table.
</code>

Le joueur écrit ''examiner clé'' → le moteur affiche quelque chose comme :

''Vouliez-vous parler de la clé rouillée, la clé dorée ou la clé rouge ?''

Si l’ambigüité disparaît (le joueur écrit ''examiner clé rouge'' ou bien deux des clés ne sont plus visibles), Donjon résout sans demander.

<file donjon wiki_synonymes_ambiguite_cles>
La salle des clés est un lieu.
La table est un support ici.

La clé rouillée est une clé sur la table.
La clé dorée est une clé sur la table.
La clé rouge est une clé sur la table.

règle avant commencer le jeu:
  dire "Essayez : {/examiner clé/} (le moteur demande de préciser) puis {/examiner clé rouge/} (sans ambigüité).".
fin règle
</file>

[[djnc>wiki_synonymes_ambiguite_cles|tester cet exemple]]

===== Modifier les synonymes en cours de partie =====

==== Ajouter sans effacer ====

<code donjon>
ajouter "magique" aux synonymes de ceci.
ajouter "fiole" et "émeraude" aux synonymes de la potion verte.
</code>

Les synonymes automatiques (et ceux d’''Interpréter'') restent en place ; les nouveaux s’ajoutent à la liste.

==== Remplacer la liste complète ====

<code donjon>
changer les synonymes de ceci sont "grimoire" et "ancien".
changer les synonymes du vieux livre sont "grimoire", "tome" et "manuscrit".
</code>

Tous les synonymes (auto **et** explicites) sont remplacés. ''examiner livre'' ne fonctionne plus si « livre » ne figure pas dans la nouvelle liste.

<WRAP info>Les synonymes définis avec ''ajouter'' ou ''changer'' ne sont **pas** recalculés automatiquement si l’intitulé change plus tard — sauf si vous activez le paramètre ''activerSynonymesAuto'', auquel cas ''changer l’intitulé de X est "…"'' réécrase la liste à partir du nouvel intitulé.</WRAP>

===== Exemple complet =====

Un mini-scénario qui démontre les trois sources de synonymes et la demande de précision sur ambigüité.

<file donjon ex_synonymes>
-- "Informations sur le jeu".
Le titre du jeu est "Le donjon des clés".
L’auteur du jeu est "DonjonFI".

Le donjon des clés est un lieu.
Sa description est "Une salle voûtée. Au centre, une table en bois supporte des clés. Au mur, une grande bibliothèque.".

La table en bois est un support dans le donjon des clés.

-- Trois clés → « examiner clé » sera ambigu.
La clé rouillée est une clé sur la table en bois.
La clé dorée est une clé sous la table en bois.
La clé rouge est une clé sur la table en bois.

-- Synonyme explicite d'un élément
La bibliothèque est un contenant dans le donjon des clés.
Interpréter la bib et l’étagère comme la bibliothèque.

Le grand livre est un objet dans la bibliothèque.
Interpréter le livre, l’ouvrage et le bouquin comme le grand livre.

-- Synonyme d'une action
interpréter regarder et observer comme examiner.

-- Modification des synonymes en cours de partie
action enchanter ceci:
  définition:
    ceci est un objet.
  phase exécution:
    ajouter "magique" et "enchanté" aux synonymes de ceci.
    dire "Une lueur entoure [intitulé ceci]. Vous pouvez maintenant l’appeler {/magique/} ou {/enchanté/}.".
fin action

Le joueur est dans le donjon des clés.
</file>
[[djnc>wiki_synonymes_demande_precision|tester cet exemple]]

À tester dans cet ordre :

  * ''examiner clé'' → le moteur demande de préciser (ambigüité entre les 3 clés)
  * ''examiner clé rouge'' → sans ambigüité, examine directement
  * ''observer la bib'' → ''observer'' = ''examiner'', et ''bib'' = ''la bibliothèque''
  * ''examiner ouvrage'' → synonyme du grand livre
  * ''enchanter la clé dorée'' puis ''examiner magique'' → synonyme ajouté en cours de partie

===== Voir aussi =====

  * [[reference:definitions:objets|Objets]] — où définir les éléments et leurs synonymes initiaux
  * [[reference:instructions:changer|Instruction changer]] — modifier l’intitulé et les synonymes en cours de partie
  * [[reference:routines:action:start|Actions personnalisées]] — pour rediriger un verbe vers une action existante