**Language / Langue :** **FR** | [[en:editeur:presentation|EN]]

====== Éditeur graphique - Présentation ======

L'éditeur graphique de JDR-Bot permet de créer et éditer des scénarios **sans écrire une ligne de YAML**. Il est intégré à la version desktop (Windows/Mac/Linux) et accessible depuis la version web.

===== Lancer l'éditeur =====

  - **Version desktop** : bouton "Éditeur" sur l'écran d'accueil
  - **Version web** : menu principal > Éditeur

===== Interface principale =====

L'éditeur est divisé en plusieurs zones :

  * **Graphe** (zone centrale) - représentation visuelle de toutes les salles et leurs connexions
  * **Inspecteur** (panneau droite) - édition détaillée de la salle sélectionnée
  * **Panneau Globaux** - variables, événements globaux, timers permanents, aliases
  * **Barre d'outils** (haut) - boutons Tester, Linter, Export, Undo/Redo, Sauvegarder

Deux fenêtres s'ouvrent à la demande depuis le menu **Affichage** :

  * **Mise en page** (''Ctrl+M'') - insère les syntaxes de texte dans le champ en cours d'édition
  * **Recherche rapide** (''Ctrl+K'') - atteint une salle, un événement, un objet ou lance une action

===== Profils d'affichage =====

**Affichage > Ouvrir Profil éditeur** choisit les champs visibles dans l'inspecteur :

  * **Simplifié** - masque les champs avancés, pour les premiers scénarios
  * **Essentiel** - les fonctions courantes, sans les réglages rares
  * **Expert** - tous les champs visibles, pour les scénarios complexes
  * **Personnalisé** - vous choisissez les familles affichées
  * **Discord** et **Terminal** - ne laissent que ce que ce support sait réellement afficher

Les deux profils de support masquent par exemple les vidéos et les boutons d'image sur Terminal, ou la vidéo sur Discord. **Changer de profil ne modifie jamais le scénario** : les fonctions incompatibles déjà présentes sont conservées, et la fenêtre du profil les recense avec leur emplacement.

===== Fenêtre Mise en page =====

Elle rassemble toutes les syntaxes de texte du moteur, classées en cinq groupes : mise en forme, variables et style, médias, éléments interactifs et blocs narratifs. Chaque bouton affiche le nom de la fonction et un aperçu de ce qui sera inséré.

Le comportement dépend de votre sélection :

  * **Du texte sélectionné** est encadré par la syntaxe. Sélectionnez un mot, cliquez sur //Variable//, vous obtenez ''v_mot_v''. Collez une adresse, cliquez sur //Image//, elle est encadrée.
  * **Sans sélection**, la syntaxe apparaît autour d'un mot d'exemple, lui-même sélectionné pour être remplacé aussitôt.
  * Quand vous avez fourni le texte, c'est le **paramètre restant** qui est présélectionné : l'identifiant d'un événement, le découpage d'une tuile.

Les espaces situés aux bords d'une sélection approximative restent hors de la syntaxe, et un bloc narratif part toujours d'une ligne propre. La fenêtre reste ouverte pendant que vous écrivez : elle suit le champ actif.

===== Générer des salles =====

**Outils > Générer des salles...** prépare un parcours parmi six structures. Le résultat s'ouvre dans un onglet séparé : complétez les textes, testez, puis importez les salles souhaitées dans votre scénario. Voir [[fr:editeur:generation|Génération de salles]] pour les paramètres, directions, choix numérotés et modèles facultatifs.

===== Formats de fichier =====

L'éditeur travaille avec le format ''.jdrproj'' (JSON interne). Il peut :

  * **Importer** un fichier ''.yaml'' existant (via ''Fichier > Importer YAML'')
  * **Exporter** en ''.yaml'' (via ''Fichier > Exporter YAML'')
  * **Exporter** en HTML5 standalone ou PDF livre-jeu

===== Undo / Redo =====

50 niveaux d'annulation. Raccourcis : Ctrl+Z / Ctrl+Shift+Z (ou Ctrl+Y).

La sauvegarde automatique du fichier, lorsqu'elle est activée et qu'un chemin de sauvegarde existe, intervient toutes les cinq minutes. Le brouillon local Web conserve le scénario principal ; sauvegardez séparément les onglets générés en ''.jdrproj''.

L'éditeur utilise ses propres confirmations pour fermer un document ou changer de scénario, sans ajouter la confirmation native du navigateur. Sauvegardez vos onglets avant de quitter ou recharger la page.

===== Palettes et styles visuels (v4.10) =====

L'interface de jeu et l'éditeur disposent de **palettes** (couleurs) et de **styles** (mise en forme) combinables indépendamment.

^ Palette ^ Description ^
| ''sombre'' | Fond sombre, contraste élevé (défaut) |
| ''neutre'' | Gris neutre, sans dominante de couleur |
| ''clair'' | Fond clair, lecture de jour |
| ''bonbons'' | Colorée et douce, pensée pour les enfants et les yeux sensibles |
| ''reverie'' | Pastel calme bleu/menthe/rose, ambiance apaisante |

^ Style ^ Description ^
| ''classique'' | Rendu propre et lisible, typographie sobre |
| ''rpg'' | Atmosphère fantasy |
| ''terminal'' | Monospace, ambiance terminal |
| ''aventure'' | Typographie narrative, mise en page roman |
| ''bonbons-s'' | Style enfant arrondi et ludique |
| ''reverie-s'' | Livre-jeu doux, aérien |

Les palettes portent les couleurs, les styles portent la mise en forme - ils sont combinables librement.

===== Gestion des groupes de salles (v4.10) =====

Les groupes permettent d'organiser visuellement les salles dans le graphe (sans effet sur le YAML exporté).

  * Menu Affichage > **Gérer les groupes...** : liste tous les groupes, avec le nombre de salles de chacun
  * Renommer un groupe vers un nom existant propose de **fusionner** les deux groupes
  * Les groupes sont purement visuels - aucun impact sur le gameplay ou l'export

===== Ordre des salles et numérotation (v4.10) =====

  * La liste des salles affiche le **numéro exporté** à côté de l'identifiant (''1 - debut'', ''2 - couloir''...)
  * **Glisser-déposer** dans la liste > modifie l'ordre d'export YAML
  * Saisir un numéro dans le champ Position déplace la salle et renumérote les autres de façon cohérente

===== Données et contrôles (4.17) =====

Les formulaires Web/Desktop prennent en charge les [[fr:yaml:listes-boucles|listes, collections et boucles]], ainsi que les [[fr:yaml:raccourcis|raccourcis clavier, souris et manette]]. Les gros projets utilisent pagination et recherche pour limiter le nombre de champs affichés.

Pendant un test, **Données du test** ouvre les valeurs actuelles dans une fenêtre séparée. Les diagnostics permettent de rejoindre le champ en cause : voir [[fr:editeur:linter-export|Linter et test auteur]].

===== Modèles, objets et encadrés =====

Dans la définition d'un [[fr:yaml:modeles|modèle]], l'insertion dans la salle appelante correspond à ''sur_place: true'' et exige une seule salle interne. Chaque collection générique peut aussi fournir des valeurs par défaut pour ses propriétés absentes.

Dans les [[fr:yaml:objets|objets]], **Nom affiché** est replié s'il est vide. **Objet secret**, près du support, allège la fiche en gardant la description et le bouton du meuble. Les champs masqués gardent leurs valeurs. L'effet **Renommer un objet**, dans la famille Objets, propose l'objet et le nouveau nom affiché sur deux champs distincts ; une valeur vide rétablit l'identifiant.

Chaque [[fr:yaml:hud|encadré HUD]] propose **Effacer en quittant la salle**, décoché par défaut. Cela exporte ''portee: salle'' ; l'absence de portée conserve le comportement persistant historique. Ces réglages participent à l'annulation/rétablissement et à l'import/export YAML FR/EN.

Les [[fr:yaml:listes-boucles|données structurées]] disposent de descriptions à chaque niveau et de tags sur leurs racines. Les noms, valeurs et descriptions restent regroupés dans la même fiche.