Différences

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

--- en:yaml:export [2026/08/31 21:22] – Wiki : fins de pages homogènes, liens Discord retirés cyrilfiesta
+++ en:yaml:export [2026/09/26 03:44] (Version actuelle) – documentation 4.15 : succès, variables persistantes et exports cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
 **Language / Langue :** [[fr:yaml:export|FR]] | **EN**
-====== YAML - Standalone and PDF Export ======
+====== YAML - Multiple files, standalone and PDF export ======
-===== HTML5 Standalone Export =====
+===== Splitting a scenario into several YAML files =====
-The standalone export generates a ZIP containing a complete game that can run without installing JDR-Bot. It can be hosted on itch.io or any web server.
+A large scenario may be split across several files. In the editor's room list, select a global category or a room, then use **Split after selection**. A separator can be moved or removed like other entries in the list.
-From the editor: ''File > Export HTML5 Standalone''.
+On export, the editor automatically creates:
-ZIP contents:
+<code>
-  * ''index.html'' - entry point.
+scenario.yaml
-  * ''app/'' - JS/CSS runtime.
+scenario.1.yaml
-  * ''data/'' - compiled scenario data.
+scenario.2.yaml
+</code>
-Features:
+The main file receives ''Nombre_yaml: 3''. Do not build this series by hand: the editor places cuts between complete sections and keeps comments preceding a new section with that section.
-  * No JDR-Bot backend required.
-  * Progress saved in localStorage.
-  * Online variables converted to local persistent variables.
-  * Mobile and tablet compatible.
-  * External assets remain referenced by URL.
-===== PDF Gamebook Export =====
+Several fragments are downloaded in one ZIP. They may also be extracted into a folder named after the scenario. **Open a folder** loads the whole series at once. Numbered fragments are not separate playable scenarios.
-The PDF export creates a printable gamebook with numbered chapters, links, endings and appendices for objects, actions and HUD panels.
+A folder may also contain the scenario's images and notes. The engine looks for its ZIP first, then its main YAML and finally its TXT; unrelated files are ignored.
-===== Sharing on itch.io =====
+===== HTML5 standalone export =====
-  - Export as a standalone HTML5 bundle
+**File > Export HTML5 standalone** creates a complete game ZIP which needs no installation and can be hosted on itch.io or any Web server.
-  - On itch.io, create a project of type "HTML"
-  - Upload the ZIP directly
+The ZIP contains ''index.html'', the runtime in ''app/'' and compiled scenario data in ''data/''.
-  - Select the ZIP as the main file
-  - Tick "This file will be played in the browser"
+  * no JDR-Bot server is required;
+  * game saves, achievements and ''_p'' variables use local storage;
+  * online ''_o'' variables become local to that standalone;
+  * local media is bundled whenever possible;
+  * external media remains available through its URL.
+[[en:yaml:achievements|Scenario achievements]] are always included. **Include compatible global achievements** is disabled by default and only adds global achievements which can be earned inside a standalone game.
+A later JDR-Bot update does not alter an already exported ZIP. Export it again to include standalone runtime fixes.
+===== PDF gamebook export =====
+**File > Export PDF gamebook** creates a gamebook with numbered chapters, references, endings, appendices and a tracking sheet. It contains internal links and remains playable when printed.
+===== Sharing on itch.io =====
-A hosted video keeps working there, since the bundle is served over HTTPS. Local ''%%file://%%'' pages cannot play them.
+  - Export the scenario as an HTML5 standalone.
+  - Create an itch.io project of type **HTML**.
+  - Upload the ZIP directly.
+  - Select it as the main file.
+  - Tick **This file will be played in the browser**.
 ===== See also =====