# Mentions d’entités et @

> Une grammaire de référence unique : clic droit dans le manuscrit, @ dans les textes longs. Détecter ne signifie pas lier.

Source: https://loomworld.ai/fr/docs/references

## Ce que conserve une référence

L’ensemble du projet utilise une seule grammaire de référence : une référence conserve une version de protocole, une portée, un type d’objet, un identifiant stable et le texte affiché. Ainsi, « vers qui pointe cet élément » reçoit la même réponse dans le manuscrit, l’univers, la chronologie, les préfigurations ou un message de l’agent — vous n’avez pas à apprendre cinq dialectes pour cinq écrans.

Renommer un objet maintient chaque référence sur la même fiche ; les objets portant le même nom sont distingués par leur type et leur identifiant stable, et les alias ne servent qu’à la recherche — ils ne constituent jamais une identité. Si vous avez un personnage nommé « Clair de lune » et une entrée d’univers nommée « Clair de lune », les candidats affichent des types distincts et ne peuvent pas être confondus.

## Quand un lien vaut la peine d’être créé

Lorsque les mots désignent réellement une fiche existante. L’intérêt n’est pas de colorer un mot, mais que vous et l’IA sachiez de quelle fiche il s’agit — afin que la suite rassemble la bonne matière, que les statistiques s’attribuent correctement et qu’un clic ouvre la fiche. Une simple mention au passage d’un élément pas encore répertorié n’en a pas besoin.

## Dans le manuscrit : clic droit « Lier à… »

Sélectionnez par glisser, puis faites un clic droit. La moitié supérieure du menu propose Réécrire / Développer / Condenser / Peaufiner, complétée par une consigne libre ; la moitié inférieure affiche « Lier à… », qui recherche dans tout le projet — personnages, lieux, objets, entrées d’univers, chapitres, scènes, temps et lieux, lignes du manuscrit, éléments de chronologie, préfigurations et entrées de modules. Si rien n’est disponible, le menu l’indique, tout comme lorsqu’une recherche ne donne aucun résultat.

Lorsque vous souhaitez créer une nouvelle fiche, la liste propose explicitement « + Créer un personnage… », « + Créer un objet… » et les entrées de liaison. C’est un choix délibéré de votre part, et non une supposition du système.

## Dans les textes longs : les deux usages de @

- **Choix en deux étapes**Dans les descriptions d’univers, les notes de préfiguration et les descriptions de chronologie, tapez `@`, choisissez une catégorie (personnages / lieux et cartes / objets / univers / structure du manuscrit / chronologie / préfigurations / entrées de modules), puis l’objet exact. Les candidats ne sont jamais tronqués au sein d’une catégorie : faites défiler la liste complète et continuez à taper pour filtrer.

- **Ou recherche directe**Si vous connaissez déjà le nom, tapez @mot-clé pour chercher parmi tous les types. Les deux voies enregistrent la même référence stable.

- **Insertion sur place**La mention apparaît sous la forme d’une étiquette reconnaissable à l’endroit où vous avez tapé et mène à la fiche ; aucune deuxième boîte d’aperçu ne vient s’afficher en dessous.

La correspondance prend en compte les noms officiels et les alias, les concordances exactes étant classées avant les préfixes et sous-chaînes. Les noms et les chemins sont analysés séparément, si bien que chercher le titre d’une scène ne liste pas chaque ligne contenue dans cette scène.

## Ce qui découle de la liaison

- Les liens vers des personnages, objets et lieux dans le manuscrit continuent d’alimenter les décomptes habituels d’apparition et d’utilisation ; les autres cibles sont des liens informatifs qui permettent de naviguer et d’apporter du contexte, sans jamais réécrire le module cible.
- Une référence ne crée jamais une fiche manquante, et lier une entrée de module ne déverse pas tout ce module dans le contexte de l’IA — il s’agit d’une navigation.
- Une référence n’accorde aucun droit d’écriture : chaque modification de l’IA passe toujours par la carte de confirmation.

## Détecter n’est pas lier

L’éditeur reconnaît les noms de personnages, lieux, objets et entrées d’univers, mais se contente de les souligner d’un trait pointillé très discret ; le survol ajoute un voile plus pâle qu’une sélection, et le clic n’ouvre pas les détails. Sur les personnages et objets, un clic propose « Convertir en référence », créant ainsi la véritable liaison. Les lignes de dialogue de personnage sautent cette étape — elles indiquent déjà qui s’exprime.

Seules les références liées alimentent les décomptes et la préparation du contexte pour l’IA ; le marquage discret n’est qu’un rappel visuel.

## Limites et dépannage

- L’ancienne syntaxe [[nom]] et les anciennes graphies de personnages et d’objets restent lisibles. Lorsqu’un ancien nom correspond à un seul objet, il s’affiche sans problème ; en cas d’homonymes, il est signalé comme ambigu plutôt que de choisir silencieusement le premier, et un objet disparu est marqué comme non valide.
- Après la suppression d’un objet, la référence conserve son texte affiché d’origine ; rien ne lui est substitué.
- Les références entre projets ne sont pas ouvertes dans cette version — transférez vos contenus à l’aide du paquet de projet.
- Appuyer sur Tab à l’intérieur d’un champ n’ouvre pas le menu des types du manuscrit ; ce raccourci est réservé aux lignes du manuscrit.

Le sens des liaisons et les effets de bord sont décrits dans [Liens entre modules](https://loomworld.ai/fr/docs/cross-sync).