**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** (icône ⚙️) - 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 =====

Le bouton en haut à droite choisit ce que l'inspecteur affiche :

  * **Simplifié** - masque les champs avancés, idéal pour débuter
  * **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.


===== 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 est activée par défaut (toutes les 30 secondes).



===== 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 Vue → **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