Différences

Ci-dessous, les différences entre deux révisions de la page.

--- en:editeur:presentation [2026/07/06 00:12] – maj 4.13 : modes d'interface + corrections cyrilfiesta
+++ en:editeur:presentation [2026/10/20 22:06] (Version actuelle) – Mod?les sur_place, port?e des encadr?s et objets 4.17 cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
 **Language / Langue :** [[fr:editeur:presentation|FR]] | **EN**
-====== Graphical Editor - Overview ======
+====== Graphical editor - Overview ======
-The graphical editor lets you create JDR-Bot scenarios without writing YAML manually.
+The graphical editor lets you create JDR-Bot scenarios without writing YAML by hand.
-It provides:
+===== Starting the editor =====
-  * an interactive room graph;
-  * a room inspector;
+  * **Web**: the //Editor// button in the site header.
-  * global variables, events, actions and timers;
+  * **Desktop**: the //Editor// button in the application.
-  * a linter;
-  * YAML, standalone HTML5 and PDF exports;
+===== Main interface =====
-  * combinable palettes and styles.
+The editor is split into several areas:
+  * **Graph** (centre) - a visual map of every room and their connections
+  * **Inspector** (right panel) - detailed editing of the selected room
+  * **Globals panel** - variables, global events, permanent timers, aliases
+  * **Toolbar** (top) - Test, Linter, Export, Undo/Redo and Save buttons
+Two windows open on demand from the **View** menu:
+  * **Text formatting** (''Ctrl+M'') - inserts the text syntaxes into the field you are editing
+  * **Quick search** (''Ctrl+K'') - reaches a room, an event, an object, or runs an action
+===== Editor profiles =====
+**View > Open Editor Profile** selects the fields shown in the inspector:
+  * **Simplified** - hides the advanced fields, for a first scenario
+  * **Essential** - the common features, without the rare settings
+  * **Expert** - every field visible, for complex scenarios
+  * **Custom** - you pick the families to display
+  * **Discord** and **Terminal** - only keep what these platforms can really display
+The two platform profiles hide, for instance, videos and image buttons on Terminal, or video on Discord. **Changing profile never modifies the scenario**: incompatible features already written are kept, and the profile window lists them with their location.
+===== Text formatting window =====
+It gathers every text syntax of the engine, sorted into five groups: formatting, variables and style, media, interactive elements and story blocks. Each button shows the name of the feature and a preview of what will be inserted.
+Its behaviour depends on your selection:
+  * **Selected text** is wrapped by the syntax. Select a word, click //Variable//, you get ''v_word_v''. Paste an address, click //Image//, it is wrapped.
+  * **With no selection**, the syntax appears around a sample word, itself selected so you can replace it right away.
+  * When you supplied the text yourself, the **remaining parameter** is preselected instead: the identifier of an event, the slicing of a tile.
+Spaces sitting at the edge of a rough selection stay outside the syntax, and a story block always starts on a clean line. The window stays open while you write: it follows the active field.
+===== Generate rooms =====
+**Tools > Generate rooms...** prepares a route using one of six structures. The result opens in a separate tab: fill in the text, test, then import the rooms you want into your scenario. See [[en:editeur:generation|Room generation]] for settings, directions, numbered choices and optional models.
+===== File formats =====
+The editor works with the ''.jdrproj'' format (internal JSON). It can:
+  * **Import** an existing ''.yaml'' file (''File > Import YAML'')
+  * **Export** to ''.yaml'' (''File > Export YAML'')
+  * **Export** to standalone HTML5 or to a PDF gamebook
+===== Undo / Redo =====
+Fifty undo levels. Shortcuts: Ctrl+Z / Ctrl+Shift+Z (or Ctrl+Y).
+When enabled and a save path exists, automatic file saving runs every five minutes. The local Web draft keeps the main scenario; save generated tabs separately as ''.jdrproj''.
+The editor uses its own confirmations when closing a document or changing scenarios, without adding the browser's native confirmation. Save your tabs before leaving or reloading the page.
+===== Palettes and visual styles (v4.10) =====
+The game interface and the editor come with **palettes** (colors) and **styles** (layout), freely combinable.
+^ Palette ^ Description ^
+| ''sombre'' | Dark background, high contrast (default) |
+| ''neutre'' | Neutral grey, with no color cast |
+| ''clair'' | Light background, for daytime reading |
+| ''bonbons'' | Colorful and soft, meant for children and sensitive eyes |
+| ''reverie'' | Calm pastel blue, mint and pink, a soothing mood |
+^ Style ^ Description ^
+| ''classique'' | Clean and readable, plain typography |
+| ''rpg'' | Fantasy atmosphere |
+| ''terminal'' | Monospace, terminal mood |
+| ''aventure'' | Narrative typography, novel-like layout |
+| ''bonbons-s'' | Rounded, playful, child-friendly style |
+| ''reverie-s'' | Soft and airy gamebook |
+Palettes carry the colors, styles carry the layout: they combine freely.
+===== Room groups (v4.10) =====
+Groups organise the rooms visually inside the graph, with no effect on the exported YAML.
+  * View menu > **Manage groups...** lists every group with its number of rooms
+  * Renaming a group to an existing name offers to **merge** the two
+  * Groups are purely visual: no impact on gameplay or on the export
+===== Room order and numbering (v4.10) =====
+  * The room list shows the **exported number** next to the identifier (''1 - start'', ''2 - corridor''...)
+  * **Drag and drop** in the list changes the YAML export order
+  * Typing a number in the Position field moves the room and renumbers the others consistently
+===== Data and controls (4.17) =====
+Web/Desktop forms support [[en:yaml:listes-boucles|lists, collections and loops]] and [[en:yaml:raccourcis|keyboard, mouse and gamepad shortcuts]]. Large projects use pagination and search to limit the number of displayed fields.
+During a test, **Test data** opens current values in a separate window. Diagnostics open the relevant field: see [[en:editeur:linter-export|Linter and author tests]].
+===== Models, objects and HUD panels =====
+In a [[en:yaml:modeles|model]] definition, insertion into the calling room corresponds to ''inline: true'' and requires one internal room. Each generic collection can also provide defaults for missing properties.
+In [[en:yaml:objets|objects]], **Display name** is folded when empty. **Secret item**, near the location, simplifies the form while retaining furniture description and button. Hidden fields keep their values. **Rename an item**, in the Objects effect family, has separate object and new display-name fields; an empty value restores the identifier.
+Every [[en:yaml:hud|HUD panel]] offers **Clear when leaving the room**, unchecked by default. It exports ''scope: room''; omitting scope preserves the historical persistent behaviour. These settings support undo/redo and FR/EN YAML import/export.
+[[en:yaml:listes-boucles|Structured data]] supports descriptions at every level and tags on roots. Names, values and descriptions remain grouped in the same form.
-Palettes carry colors. Styles carry layout and shape. They are independently combinable.