diff --git a/aligning_items.md b/aligning_items.md index d2de41f..879ead2 100644 --- a/aligning_items.md +++ b/aligning_items.md @@ -114,6 +114,8 @@ Each of these commands, and *Aligner sur la grille*, has its own icon in the menu, the right-click menu, command search and the shortcut bar ([PR #1153](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1153), merged 2026-09-29). +![Command search for 'align' and 'centrer' in light and dark palettes, each Align command with its icon](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/align-icons-command-search.png) + With a single item selected the six commands are greyed out; only Snap to grid is available. A single group counts as one item, however many things are in it. diff --git a/assistant_live_mode.md b/assistant_live_mode.md index 1246386..cc2af5f 100644 --- a/assistant_live_mode.md +++ b/assistant_live_mode.md @@ -67,6 +67,8 @@ The tools are kept apart so one can never be taken for the other. So a setting you forgot about can never leave the door open silently. + ![The startup warning: live mode is on, each action is undone with Ctrl+Z, the Arrêter button cuts the connection; buttons Désactiver, Pas pour cette session and Continuer](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-warning.png) + With the setting off, QElectroTech opens nothing at all and behaves exactly as it does without this feature; the `qet_live_*` tools answer that live mode is off and do nothing. When they cannot connect, they say which of the three @@ -94,6 +96,8 @@ lists every action, newest first: the time, ✓ or ✗, and its undo step's name Hover an entry, or double-click it, for the details: the error, what the script logged, and the script itself. +![The Assistant panel during a test session (ask-first unticked): a list of timed actions with ticks and crosses — screenshot, undo_last refused, show_folio, a refused diagrameditor.delete_selection, zoom_fit — and below it the status bar reading 'Mode direct : ✓ screenshot à 10:36:25' with the Arrêter button](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-dock.png) + At the top: *Demander avant d'exécuter un script écrit par l'assistant* (*Ask before running a script the assistant wrote*), **ticked at every start**. While it is ticked, a script the assistant wrote on the spot is shown to you first, @@ -106,6 +110,8 @@ run a script*): | *Refuser* (*Refuse*) | nothing happens; the assistant is told you refused | | *Toujours pour cette session* (*Always this session*) | runs it and stops asking until the next start | +![The ask-first box: the assistant's one-line script that adds a text on the sheet on screen, with Toujours pour cette session, Refuser and Exécuter](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/live-mode-ask-first.png) + Stored scripts — the **[script buttons](script_buttons)** you already have — run without asking: you put them there. diff --git a/collection_browser.md b/collection_browser.md index eaa5dfe..a1876a0 100644 --- a/collection_browser.md +++ b/collection_browser.md @@ -41,6 +41,8 @@ forme de liste triée* (*Show search results as a ranked list*) in **Configurer QElectroTech > Général** ([PR #1083](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1083)). The search then filters the tree as it did before, with the tree's own keyboard navigation. +![Searching 'diode' two ways: on the left the ranked list (Diode, diode-tube, Diode bridge…), on the right the filtered tree, opened down to Electric > All-pole > Electronics and semiconductors > Diode](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/collections-search-list-vs-tree.png) + --- ## 2. The three collections, and which ones you can actually edit @@ -160,6 +162,8 @@ ready to drag onto a cabinet layout sheet. - The entry is hidden when no selected symbol has both values. - Like anything embedded, the thumbnails travel inside the `.qet` file. +![A selection's right-click menu with Générer une vignette d'armoire below Créer un template](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/cabinet-thumbnail-menu.png) + Since [PR #1170](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1170) (merged 2026-09-29); discussion [#602](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/602). diff --git a/element_editor.md b/element_editor.md index 3084296..f3de708 100644 --- a/element_editor.md +++ b/element_editor.md @@ -197,6 +197,8 @@ another width and height, for example the size of one cell or of the space a symbol usually gets. Both settings are remembered between sessions; the frame is off by default. +![The symbol editor with a relay symbol in the middle of a large dashed blue frame; the frame toggle is checked on the toolbar](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/element-editor-background-frame.png) + The frame is only drawn on screen. It is not saved in the symbol, and it does not appear in an SVG export. diff --git a/faq.md b/faq.md index 4c714c6..caf7df8 100644 --- a/faq.md +++ b/faq.md @@ -287,6 +287,8 @@ At the next start after a crash, a window titled **Fichiers de restauration** newest, marked *(la plus récente)* (*most recent*), is selected; pick an older one if the newest is the broken one. The copies you did not pick are deleted. +![The Fichiers de restauration window: one project listed, with a drop-down set to its newest copy, marked (la plus récente), and Cancel and OK buttons](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/faq-recovery-files.png) + A copy that cannot be read gives a warning instead of crashing QElectroTech again ([PR #1031](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1031)). diff --git a/images/align-icons-command-search.png b/images/align-icons-command-search.png new file mode 100644 index 0000000..a726d6d Binary files /dev/null and b/images/align-icons-command-search.png differ diff --git a/images/cabinet-thumbnail-menu.png b/images/cabinet-thumbnail-menu.png new file mode 100644 index 0000000..1a026aa Binary files /dev/null and b/images/cabinet-thumbnail-menu.png differ diff --git a/images/collections-search-list-vs-tree.png b/images/collections-search-list-vs-tree.png new file mode 100644 index 0000000..d946ef4 Binary files /dev/null and b/images/collections-search-list-vs-tree.png differ diff --git a/images/element-editor-background-frame.png b/images/element-editor-background-frame.png new file mode 100644 index 0000000..95a1593 Binary files /dev/null and b/images/element-editor-background-frame.png differ diff --git a/images/faq-recovery-files.png b/images/faq-recovery-files.png new file mode 100644 index 0000000..219b8d0 Binary files /dev/null and b/images/faq-recovery-files.png differ diff --git a/images/live-mode-ask-first.png b/images/live-mode-ask-first.png new file mode 100644 index 0000000..b9b29d3 Binary files /dev/null and b/images/live-mode-ask-first.png differ diff --git a/images/live-mode-dock.png b/images/live-mode-dock.png new file mode 100644 index 0000000..8aac89d Binary files /dev/null and b/images/live-mode-dock.png differ diff --git a/images/live-mode-warning.png b/images/live-mode-warning.png new file mode 100644 index 0000000..ac62818 Binary files /dev/null and b/images/live-mode-warning.png differ diff --git a/images/macro-recorder-box.png b/images/macro-recorder-box.png new file mode 100644 index 0000000..b3dc6bc Binary files /dev/null and b/images/macro-recorder-box.png differ diff --git a/images/macro-recorder-status.png b/images/macro-recorder-status.png new file mode 100644 index 0000000..25007d6 Binary files /dev/null and b/images/macro-recorder-status.png differ diff --git a/images/preferences-configuration-menu.png b/images/preferences-configuration-menu.png new file mode 100644 index 0000000..4160a3c Binary files /dev/null and b/images/preferences-configuration-menu.png differ diff --git a/images/preferences-plc-table-dark-after.png b/images/preferences-plc-table-dark-after.png new file mode 100644 index 0000000..96ecf41 Binary files /dev/null and b/images/preferences-plc-table-dark-after.png differ diff --git a/images/preferences-plc-table-dark-before.png b/images/preferences-plc-table-dark-before.png new file mode 100644 index 0000000..dfd7b74 Binary files /dev/null and b/images/preferences-plc-table-dark-before.png differ diff --git a/images/script-buttons-manager.png b/images/script-buttons-manager.png new file mode 100644 index 0000000..d3cbe79 Binary files /dev/null and b/images/script-buttons-manager.png differ diff --git a/images/script-buttons-menu.png b/images/script-buttons-menu.png new file mode 100644 index 0000000..12af8b8 Binary files /dev/null and b/images/script-buttons-menu.png differ diff --git a/images/script-buttons-toolbar.png b/images/script-buttons-toolbar.png new file mode 100644 index 0000000..80c0b4d Binary files /dev/null and b/images/script-buttons-toolbar.png differ diff --git a/macro_recorder.md b/macro_recorder.md index 69bacee..4c531f3 100644 --- a/macro_recorder.md +++ b/macro_recorder.md @@ -53,6 +53,8 @@ QElectroTech answers. So the recording is saved where the assistant's (*Recording: N steps*) with an **Arrêter** (*Stop*) button. 4. Stop: **Arrêter**, or the same menu entry, which is ticked while recording. +![The status bar while recording: a red dot, 'Enregistrement : 1 étape(s)', and the Arrêter button](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/macro-recorder-status.png) + A box, *Macro enregistrée* (*Macro recorded*), gives the recording's name (*Macro du 02/10/2026 14:30*), its number of steps and its folder: @@ -62,6 +64,8 @@ A box, *Macro enregistrée* (*Macro recorded*), gives the recording's name | *Ouvrir le dossier* (*Open the folder*) | opens the recording's folder | | *Fermer* (*Close*) | closes the box; the recording stays saved | +![The Macro enregistrée box: the recording's name and step count, the folder it was saved in, and the buttons Ouvrir le dossier, Fermer and Copier la demande pour l'assistant](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/macro-recorder-box.png) + Recording needs no setting: it only writes files. Turning it into a script does — see below. diff --git a/preferences.md b/preferences.md index daa473d..7d9c3d1 100644 --- a/preferences.md +++ b/preferences.md @@ -194,6 +194,8 @@ From the **Configuration** menu, below *Configurer QElectroTech*: | **Enregistrer la configuration sous...** (*Save configuration as*) | saves every setting to a `.conf` file | | **Charger une configuration...** (*Load configuration*) | replaces your settings with a saved file, then **closes QElectroTech**; start it again to use them | +![The Configuration menu: Afficher, Passer en mode plein écran, Configurer QElectroTech, then Enregistrer la configuration sous… and Charger une configuration…](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-configuration-menu.png) + Use it to keep one set of settings per customer or drawing standard, to move your settings to another computer, or to keep a copy before trying something. The file is plain text in ini format, the same on every system. @@ -218,6 +220,10 @@ their fixed size. Since [PR #1165](https://github.com/qelectrotech/qelectrotech- fixed the PLC input/output table's *Type* column showing as light grey boxes under a dark system theme. +| Before | After | +|---|---| +| ![PLC input/output table under a dark system theme, Type column drawn as light grey boxes](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-plc-table-dark-before.png) | ![The same table after the fix, Type column dark like the others](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/preferences-plc-table-dark-after.png) | + --- See also: **[Project XML](project_XML)** · **[Linking elements](element_linking)** · diff --git a/script_buttons.md b/script_buttons.md index 4addab9..c740ee8 100644 --- a/script_buttons.md +++ b/script_buttons.md @@ -117,6 +117,8 @@ broken.js: unknown header key @shortcutt* (*Ignored*), so you can see which line is wrong. A misspelt shortcut that silently did nothing would be harder to find. +![The Projet > Scripts menu: a stored script with its icon, then a greyed entry 'Ignoré : broken.js: unknown header key @shortcutt', then Gérer les scripts, Exécuter un script and Ouvrir le dossier des scripts (captured before the macro recorder entry was added)](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-menu.png) + A file name becomes the script's id: `add-revision-note.js` is `diagrameditor.script.add-revision-note` in the shortcut settings. @@ -146,6 +148,8 @@ Below the scripts, the **Projet > Scripts** menu holds: | *Exécuter un script...* (*Run script*) | run any `.js` file once, as before — it moves here from the *Projet* menu | | *Ouvrir le dossier des scripts* | open the scripts folder | +![The Scripts toolbar after the arrange buttons: one script with an SVG page icon, one with an orange initials tile reading HL](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-toolbar.png) + ### One click, one Ctrl+Z > **Status: pending** — [PR #1219](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1219). @@ -183,6 +187,8 @@ scripts with their icons on the left, and edits the selected one on the right. Below the fields is the script's text, a plain text editor. +![The Gérer les scripts window: three scripts listed with their icons on the left; on the right the Nom, Icône (pick.svg, with a blue triangle preview), Info-bulle, Raccourci and Actif fields, the script text, and the Nouveau, Supprimer, Tester, Enregistrer, Ouvrir le dossier and Fermer buttons](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/script-buttons-manager.png) + | Button | Does | |---|---| | *Nouveau* (*New*) | starts a script called *Nouveau script* from a template |