Differences

This shows you the differences between two versions of the page.

--- tutorials:create-interactive-tutorial [2025/04/03 07:32] – [Set up your first scene] Tim
+++ tutorials:create-interactive-tutorial [2025/04/03 10:32] (current) – [Create an Interactive tutorial] Tim
@@ Line 2: / Line 2: @@
 Starting with GroIMP 2.1.7 it is possible to create interactive tutorials to present panels and workflows.
-The interaction is based on GroIMP Layouts and the embedded HTML view.
+The interaction is based on GroIMP Layouts, the embedded HTML view and the[[user-guide:more_panels#tutorial_navigation| tutorial navigation panel]].
@@ Line 18: / Line 18: @@
 ==== Content of each step ====
-For each step/layout you need to know the panels you want in and the description of the step as an HTML file. You can simply create an HTML file using any editor (e.g. https://html5-editor.net) (or Word with a bigger font size).
+For each step/layout you need to know the panels you want in and the description of the step as an HTML file. You can simply create an HTML file using any editor (e.g. https://html5-editor.net) (or Word with a bigger font size). It is hereby important to keep in mind that Java Swing and therefore the GroIMP GUI including the html-Viewer only support HTML up to version [[https://www.w3.org/TR/2018/SPSD-html32-20180315/ | 3.2]] (quite old) and no java-sript!.
@@ Line 62: / Line 63: @@
 ===== Second scene =====
-In the second step we want to show the 2d node toolbar and explain what it does with the following html text:
+In the second step we want to show the 2D node toolbar and explain what it does with the following html text:
 <code html 02_2DNode_toolbar.html>
-<h2> The 2d Node toolbar</h2>
+<html>
+<head>
+<title>The 2D Node toolbar</title>
+</head>
+<body>
+<h2> The 2D Node toolbar</h2>
-Using the 2d Node toolbar it is possible to edit specific nodes without XL or RGG.
+Using the 2D Node toolbar it is possible to edit specific nodes without XL or RGG.
-If you select a node the toolbar will show the possible options.
+If you select a node the toolbar (right above the 2d graph view) will show the possible options.
+Please select the A node and press the appearing "addNodeSuccessor" button in the 2D toolbar to add a child of the type of successor to the node A. The then opening pop-up window can be used to describe the type of node you wish to add, for our case the suggested F is completely fine.
-Please select the A node and press
+</body>
+</html>
+</code>
+To create the layout for this we need to do the following steps:
+  - Open the file explorer
+  - add the second html file
+  - open the html file
+  - **close the file explorer !!!**
+  - open the Node toolbar 2d (you can find this under panels/2d/node toolbar 2d)
+  - arrange the layout to as you like (e.g.  see below)
+  - use the add layout menu entry to save this layout to the list of layouts
+|{{ :tutorials:ineratctive_tutorial_sep2.png?600 |}}|
+|The first html view (seen in the tab on the left) could be closed if you want to. It only is open here for users to go read again |
+===== Third scene =====
+In the last step we want to show how the 2d toolbar is affecting the 3d view.
+<code html 03_3D_view.html>
+<html>
+<head>
+<title>The changes in 3D </title>
+</head>
+<body>
+<h2> The changes in 3D</h2>
+In the now opened 3D view you can see the F you added in the last step, please select this F in one of the views (both work) and add a second F (using the same steps as before). This will appear directly in the 3D view, on top of the other F as expected.
+</body>
+</html>
 </code>
+To finalize this last layout we need again to add the html file and also the 3D view, a possible layout can be seen below. And of course save the layout.
+{{ :tutorials:interatictive_tutorial_step3.png?600 |}}
+===== Finishing =====
+If you now press the next button, it should jump to the first layout and allow you to step through your three layouts. and we are done.
+===== Trouble shooting =====
+If you accidentally added a wrong layout you can remove it through the layout-explorer, which can be found in panels/layouts. Jet you can not change the order of the layouts there!
+Additionally you can always try to remove individual panels from a already saved layout, by saving and closing the project, accessing the gsz as a archive (zip) and edit the project.gs. It is reccomened to make a backup of the project before trying this.
+In the same way it is also possible to edit the HTML files later, they are also files in the gsz.