kotschak/qelectrotech-source-mirror
0
0
Fork 0
mirror of https://github.com/qelectrotech/qelectrotech-source-mirror.git synced 2026-10-03 01:04:13 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

Drop stale pending notices: the drawing-workflow stack merged (#1042, #1050-#1057, #1060) 

keyboard_control: placing a new symbol no longer needs a mouse, so the
'one real gap' section now says how to do it from the keyboard.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ispyisail
2026-09-27 22:31:59 +13:00
parent f7ddc38956
commit c0e059ce77
4 changed files with 41 additions and 121 deletions
Download Patch File Download Diff File Expand all files Collapse all files
collection_browser.md
+7 -9
@@ -31,12 +31,10 @@ on this page apply equally to both tabs.
The **search box** at the top filters the current tab as you type.
> **Status: pending.** Two changes to this panel are in open pull requests,
> not yet merged: with [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) a search shows one flat list, best match
> first, instead of the filtered tree; and with [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) **double-clicking**
> a symbol (or pressing **Enter** on it) places it on the folio instead of
> opening the element editor — a preference restores the old behaviour. See
> **[Drawing faster](drawing_faster)**.
A search shows one flat list, best match first, instead of the filtered
tree, and **double-clicking** a symbol (or pressing **Enter** on it) places it
on the folio instead of opening the element editor; a preference restores the
old behaviour. See **[Drawing faster](drawing_faster)**.
---
@@ -114,9 +112,9 @@ without waiting on a "favourites" feature that doesn't exist yet:
4. Repeat for every device you reach for often. From then on, they're one
level deep under **Collection utilisateur**, in an order you chose.
> **Pending:** with [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052), this user collection is also the palette of
> the **Insert** element picker, which shows it as a grid at the cursor —
> see **[Drawing faster](drawing_faster)**.
This user collection is also the palette of
the **Insert** element picker, which shows it as a grid at the cursor —
see **[Drawing faster](drawing_faster)**.
**"Show only this folder"** (§3) is the other half of this: once your
shortlist folder exists, right-click it and solo it to hide the entire
drawing_faster.md
+8 -72
@@ -13,18 +13,16 @@ were proposed in
[discussion #676](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/676)
and
[discussion #1033](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/1033),
and are built as a series of small pull requests, one per feature.
and were built as a series of small pull requests, one per feature.
> **Status: mostly pending.** The right-click menu restructure (§2) and
> command search (§9) are merged. Every other section carries its own notice naming the pull request
> it describes; nothing in such a section works in your build until that PR
> lands. Check the PR before trying it. Each notice is removed once its PR
> merges.
> **Status: merged.** Every feature on this page is in QElectroTech's
> master branch (the last pull requests merged on 27 September 2026), so it is
> in current development builds.
| § | Feature | How you reach it | Pull request |
|---|---|---|---|
| 1 | [Place a symbol without dragging](#1-placing-a-symbol-without-dragging), and place the last one again | Double-click or Enter in Collections; **A** | [#1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) |
| 2 | [Placing from the right-click menu](#2-the-folios-right-click-menu) | Right-click an empty spot | [#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041) (merged), [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| 2 | [Placing from the right-click menu](#2-the-folios-right-click-menu) | Right-click an empty spot | [#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041), [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| 3 | [Ranked collection search](#3-searching-the-collection-best-match-first) | The Collections search box | [#1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) |
| 4 | [Element picker at the cursor](#4-the-element-picker-insert) | **Insert** | [#1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052) |
| 5 | [Shortcut bar](#5-the-shortcut-bar-s) | **S** | [#1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053) |
@@ -32,13 +30,9 @@ and are built as a series of small pull requests, one per feature.
| 6 | [Your own symbols on the bar, and its width](#putting-your-own-symbols-on-the-bar) | *Éléments* in the edit window; the bar's corner grip | [#1060](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1060) |
| 7 | [Commands beside the selection](#7-commands-beside-the-selection) | Click something | [#1055](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1055) |
| 8 | [Repeat the last command](#8-enter-repeats-the-last-command) | **Enter** on the folio | [#1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056) |
| 9 | [Command search](#9-command-search-ctrlshiftm) | **Ctrl+Shift+M** | [#1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) (merged) |
| 9 | [Command search](#9-command-search-ctrlshiftm) | **Ctrl+Shift+M** | [#1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) |
| 10 | [Mouse gestures](#10-mouse-gestures-right-drag) | Right-drag | [#1057](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1057) |
The pull requests build on each other in the order of the table (except
§9, which stands alone), so they are expected to merge roughly in that
order.
Menu and option names below are given in French, as QElectroTech shows them
until the translations are updated, with an English gloss in italics.
@@ -46,12 +40,6 @@ until the translations are updated, with an English gloss in italics.
## 1. Placing a symbol without dragging
> **Status: pending.** This section describes
> [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
In the **Collections** panel, **double-click** a symbol, or select it and
press **Enter**. The symbol attaches to the cursor; click on the folio to put
it down. You stay in placing mode, so each further click places another copy.
@@ -85,18 +73,14 @@ Right-click an empty spot on a folio. The menu puts drawing first:
| Entry | Does | Since |
|---|---|---|
| **Renvoi de folio ▸** (*folio reference*) | places a folio report arrow where you right-clicked | pending, [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| **Insérer le dernier élément** (*insert last element*) | starts placing the last symbol again, as **A** does; shown once something has been placed | pending, [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| **Renvoi de folio ▸** (*folio reference*) | places a folio report arrow where you right-clicked | [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| **Insérer le dernier élément** (*insert last element*) | starts placing the last symbol again, as **A** does; shown once something has been placed | [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) |
| **Ajouter ▸** (*add*) | text, image, PDF, line, rectangle, ellipse, polyline, curve, terminal strip | merged ([#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041)) |
| **Propriétés du folio** (*folio properties*) | the folio's properties dialog | merged |
| **Lignes et colonnes ▸** (*rows and columns*) | add or remove a row or a column | merged — moved one level down by #1041 |
![The folio's right-click menu with the Renvoi de folio submenu open: Coming arrow, Going arrow, Next folio](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-folio-menu.png)
> **Status: pending** for the first two rows only:
> [PR #1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050),
> not yet merged. The rest of the menu is in current builds.
### Which arrows "Renvoi de folio" lists
It lists **the folio report symbols your project already uses**, read from
@@ -116,12 +100,6 @@ For what a folio report does once placed, see
## 3. Searching the collection, best match first
> **Status: pending.** This section describes
> [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Typing in the **Collections** search box now gives **one flat list, best
match first**, instead of the folder tree filtered down to matching
branches. Down arrow and Enter place the highlighted symbol (with §1).
@@ -145,12 +123,6 @@ symbols' **displayed names** in your language, not their file names.
## 4. The element picker (Insert)
> **Status: pending.** This section describes
> [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Press **Insert** with the mouse over the folio (*Édition → Insérer un
élément…*). A small window opens at the cursor:
@@ -178,12 +150,6 @@ same way as any collection, and there is nothing extra to back up.
## 5. The shortcut bar (S)
> **Status: pending.** This section describes
> [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Press **S** with the mouse over the folio (*Édition → Barre de raccourcis*).
The element picker opens at the cursor with **a row of command buttons on
top**, chosen for what is selected — the same idea as SolidWorks' S key.
@@ -217,12 +183,6 @@ and are not part of undo.
## 6. Customising the shortcut bar
> **Status: pending.** This section describes
> [PR #1054](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1054),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Click **…** at the right end of the bar's command row. An edit window opens
in the bar's place:
@@ -244,12 +204,6 @@ commands, as described next.
### Putting your own symbols on the bar
> **Status: pending.** This section describes
> [PR #1060](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1060),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
The symbols you use all day — a fuse, a coil, a contact, a lamp, a motor —
can sit on the bar as icons beside the commands, so placing one is **S** and
one click.
@@ -303,12 +257,6 @@ that width from then on. Until you drag the grip, all icons stay on one row.
## 7. Commands beside the selection
> **Status: pending.** This section describes
> [PR #1055](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1055),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Click a symbol, text or wire and a small bar of commands appears just above
and to the right of the cursor — SolidWorks' context toolbar. It holds the
first eight commands of the shortcut bar's list for that selection (§5), so
@@ -328,12 +276,6 @@ QElectroTech → Général → Apparence →* **Afficher les commandes près de
## 8. Enter repeats the last command
> **Status: pending.** This section describes
> [PR #1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Press **Enter** on the folio to start the last drawing or placing command
again. Draw a line, press Escape, press Enter — you are drawing another.
Place a fuse, Escape, Enter — you are placing another fuse.
@@ -388,12 +330,6 @@ preferences.
## 10. Mouse gestures (right-drag)
> **Status: pending.** This section describes
> [PR #1057](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1057),
> not yet merged. Nothing here works until that lands — check the PR before
> trying any of this against your own build. This section will drop this
> notice once it does.
Hold the **right** mouse button and drag in any direction: a ring of up to
eight commands appears around the point where you pressed. Drag toward one —
its slice lights up and its name shows below — and release to run it.
keyboard_control.md
+23 -35
@@ -10,29 +10,25 @@ vary by OS/desktop rather than just the Ctrl→Cmd swap; those are called out
individually instead of guessed. Every shortcut here is also rebindable,
see [Changing a shortcut](#changing-a-shortcut) below.
## The one real gap: placing a *new* element still needs a mouse
## Placing a new element from the keyboard
> **Status: pending fix.** [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042), not yet merged, closes this gap:
> double-click or **Enter** on a symbol in the Collections panel attaches it
> to the cursor, and **A** places the last one again. With [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052),
> **Insert** opens a picker at the cursor where you type a name and press
> Enter. Until they land, the paragraphs below describe current builds. See
> **[Drawing faster](drawing_faster)**.
Placing a symbol used to be the one thing that needed a mouse: the only way
to put a catalog symbol on a folio was to drag it from the Collections panel.
It no longer is:
Read this first, because it's the thing most people asking about mouseless
control actually want, and it isn't fully there yet. **Dragging an element
from the Collections panel onto a diagram is the only way to place one
you've never used in this project before — there is no keyboard or
double-click equivalent.** Checked directly: double-clicking an element in
the Collections panel opens it in the **Element Editor**, not onto your
diagram, and neither Enter nor a context-menu action inserts it either.
| To | Do |
|---|---|
| Place a symbol from the Collections panel | select it (Tab into the panel, arrow keys, or type in the search box) and press **Enter**: the symbol attaches to the cursor. Double-click does the same. |
| Place the last symbol again | **A** |
| Pick a symbol at the cursor by name | **Insert** opens a picker; type part of the name and press **Enter** |
That's narrower than it used to be, though: if the element you want is
**already somewhere in the project**, copying and pasting it is now fully
keyboard-driven — see [Duplicating an existing
element](#duplicating-an-existing-element-without-a-mouse) below. The gap
that remains is specifically *the first instance of a catalog element in a
project*.
A preference makes double-click open the element editor again, as it used
to (**[Preferences reference](preferences)**, §1, *Interface*). Full details, including where the attached
symbol lands and how to cancel it, are on **[Drawing faster](drawing_faster)**.
If the element is **already somewhere in the project**, copying and pasting
it also works entirely from the keyboard — see [Duplicating an existing
element](#duplicating-an-existing-element-without-a-mouse) below.
Once an element is already on a diagram, everything below applies —
selecting, moving, rotating, editing, wiring and deleting existing elements
@@ -202,13 +198,10 @@ elements' *display names*, not their filenames (searching `bobine3` won't
find "Coil", searching `coil` will). Arrow keys move through the filtered
tree once it has focus.
> **Status: pending.** With [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) the search gives one flat list, best
> match first, and with [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) Enter on a result places it — see
> **[Drawing faster](drawing_faster)**. Neither is merged yet.
That's as far as the keyboard takes you here — see the gap noted at the top
of this page. Placing the element you've found still means dragging it onto
a diagram.
The search gives one flat list, best match first, and **Enter** on a result
attaches it to the cursor for placing — see
[Placing a new element from the keyboard](#placing-a-new-element-from-the-keyboard)
above.
## Element Editor (editing a symbol's own drawing)
@@ -241,11 +234,9 @@ your platform's standard "redo" key), plus template-specific actions —
logos, **Ctrl+Y** edits cell info, zoom on Ctrl+9/Ctrl+0 and your
platform's standard zoom-in/out keys.
## Commands at the cursor (mostly pending)
## Commands at the cursor
> **Status: pending**, except command search (Ctrl+Shift+M), which is
> merged. Each other row names its open pull request; nothing in those rows
> works until it lands. The full description is on **[Drawing faster](drawing_faster)**.
The full description is on **[Drawing faster](drawing_faster)**.
| Action | Key | Pull request |
|---|---|---|
@@ -253,7 +244,7 @@ platform's standard zoom-in/out keys.
| Element picker at the cursor: type a name, Enter places it | Insert | [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052) |
| Shortcut bar: commands for the selection, plus the picker | S | [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053) |
| Repeat the last drawing or placing command | Enter (on the folio) | [PR #1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056) |
| Search every command by name and run it | Ctrl+Shift+M | merged ([PR #1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049)) |
| Search every command by name and run it | Ctrl+Shift+M | [PR #1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) |
Command search makes every command reachable without knowing its menu, and
lists each command's own key next to it.
@@ -273,9 +264,6 @@ list to conflicts only.
Stated plainly rather than left for you to discover:
- **Placing a *new* catalog element** — one not already used somewhere in
the project — from the Collections panel onto a diagram. (Duplicating an
*existing* one is keyboard-driven — see above.)
- **Drawing** a line, rectangle, polygon or terminal — reaching the tool is
keyboard-driven (**Édition → Ajouter**, above), but placing its points on
the canvas isn't, in a diagram or inside the Element Editor's own symbol
preferences.md
+3 -5
@@ -39,8 +39,8 @@ title-block templates, custom title-block templates, and custom macros.
round up at .75, or no rounding) — matters on fractional-scale displays
- Language
Three more options in this group are **pending** — each is in an open pull
request, not in current builds (see **[Drawing faster](drawing_faster)**):
Three more options in this group come with the features on
**[Drawing faster](drawing_faster)**:
| Option | Default | Pull request |
|---|---|---|
@@ -126,9 +126,7 @@ export), see **[DXF import & export](dxf)**.
---
## 3b. Barre de raccourcis (shortcut bar) — pending
> **Status: pending.** This page is added by [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053), not yet merged.
## 3b. Barre de raccourcis (shortcut bar)
Chooses the commands the **S** shortcut bar shows (and, with later pull
requests, the command bar beside a selection and the gesture ring). Pick the