From 7335a2c66efd29df8f3809b26e1d7ab3e1310790 Mon Sep 17 00:00:00 2001 From: ispyisail Date: Sat, 19 Sep 2026 17:42:19 +1200 Subject: [PATCH] Traduire les trois pages restantes, et corriger la page d'impression MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit templates-FR, mouse_modifiers-FR et printing_and_export-FR, traduits en reprenant les libellés de l'application plutôt qu'en les réinventant : « Folios à imprimer », « Adapter le folio à la page », « Utiliser toute la feuille », « Options de rendu », « Exporter entièrement le folio », « Exporter seulement les éléments », « SVG: fond transparent », « Conserver les proportions », « Créer un template », « Enregistrer un template », « Nom du nouveau template ». La barre d'état des formes est citée telle quelle, Maj comprise. Traduire a fait apparaître deux erreurs dans la page anglaise, corrigées ici aussi : - printing_and_export listait « Draw guides » comme une option. Ce n'est pas une option : draw_guides existe comme propriété enregistrée, aucune fenêtre ne la propose, et l'impression la force à false (projectprintwindow.cpp:546). La ligne est remplacée par une note qui dit pourquoi les guides n'arrivent jamais dans un export. - Le filtre de date de la fenêtre d'impression manquait entièrement. Il ne filtre pas l'impression : il coche et décoche la liste des folios d'après la date du cartouche, soit à partir d'une date, soit à une date exacte. « Imprimer tout ce qui a été révisé depuis le 3 » devient un clic. languages.md : les quatre pages du jour sont maintenant marquées traduites en français, et pas en allemand. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01CaKympWT3owLotCpEN2CFj --- languages.md | 6 +- mouse_modifiers-FR.md | 186 +++++++++++++++++++++++++++++++++++ printing_and_export-FR.md | 150 +++++++++++++++++++++++++++++ printing_and_export.md | 20 +++- templates-FR.md | 197 ++++++++++++++++++++++++++++++++++++++ 5 files changed, 555 insertions(+), 4 deletions(-) create mode 100644 mouse_modifiers-FR.md create mode 100644 printing_and_export-FR.md create mode 100644 templates-FR.md diff --git a/languages.md b/languages.md index c662a2c..b8db4d0 100644 --- a/languages.md +++ b/languages.md @@ -72,9 +72,9 @@ Beginnen Sie mit der deutschen Version dieses Wikis: | Search & Replace | ✅ | ✅ | ✅ | | Building a nomenclature query | ✅ | ✅ | ✅ | | Conductors | ✅ | ✅ | ❌ | -| Printing and exporting | ✅ | ❌ | ❌ | -| Mouse modifiers | ✅ | ❌ | ❌ | -| Templates | ✅ | ❌ | ❌ | +| Printing and exporting | ✅ | ✅ | ❌ | +| Mouse modifiers | ✅ | ✅ | ❌ | +| Templates | ✅ | ✅ | ❌ | **Legend:** ✅ Translated | 📋 Planned | ❌ Not yet started diff --git a/mouse_modifiers-FR.md b/mouse_modifiers-FR.md new file mode 100644 index 0000000..a1b999b --- /dev/null +++ b/mouse_modifiers-FR.md @@ -0,0 +1,186 @@ +# Touches de modification à la souris : Maj, Ctrl et Alt + +Maintenir une touche pendant un glisser change ce que fait ce glisser : contraindre +une forme à un carré, libérer un objet de la grille, redimensionner depuis le +centre, caler une rotation sur 15°, ou déplacer le texte d'un élément plutôt que +l'élément. + +Presque rien de tout cela n'est visible dans l'interface. Deux de ces touches +apparaissent dans la barre d'état alors que le glisser est déjà commencé ; le +reste n'est écrit nulle part. Cette page est la liste. + +**[Tout piloter au clavier](keyboard_control)** est la page jumelle et traite du +problème inverse : se passer complètement de la souris. + +Sources : `sources/diagram.cpp`, `sources/diagramevent/diagrameventaddshape.cpp`, +`sources/qetgraphicsitem/qetshapeitem.cpp`, +`sources/qetgraphicsitem/dynamicelementtextitem.cpp`. + +--- + +## 1. La règle qui explique la moitié de la page : Ctrl veut dire « ignorer la grille » + +Ctrl n'est pas traité outil par outil. La vérification est **dans la fonction de +grille elle-même**, donc elle vaut partout où une position est alignée : poser +un élément, dessiner une forme, déplacer un objet, tirer une poignée. + +Touche maintenue, les positions s'arrondissent au **pixel** le plus proche au +lieu du carreau. C'est du positionnement fin, pas une liberté totale : vous +tombez toujours sur des coordonnées entières. + +Deux conséquences faciles à heurter : + +- Ctrl **inverse aussi la sélection** quand vous *cliquez* un objet. Un + Ctrl+clic ajoute ou retire l'objet de la sélection ; Ctrl maintenu pendant un + *glisser* le libère de la grille. Même touche, deux rôles, départagés par le + fait que vous ayez bougé ou non. +- **Ctrl+Maj n'est pas disponible** comme combinaison à vous. La vue du folio se + la réserve pour son propre changement de mode. + +--- + +## 2. Déplacer + +| Vous faites glisser | Sans rien | Avec une touche | +|---|---|---| +| Un élément, une image, une forme | s'aligne sur la grille | **Ctrl** — positionnement fin | +| Un champ de texte indépendant | s'aligne sur la grille | **Ctrl** — positionnement fin | +| Le texte d'un conducteur | s'aligne sur la grille | **Ctrl** — positionnement fin | +| **Le texte d'un élément** (label, référence, champ d'information) | déplace **tout l'élément** | **Maj** — déplace le texte seul, l'élément ne bouge pas | +| Un groupe de textes d'élément | s'aligne sur la grille | **Ctrl** — positionnement fin | + +La ligne **Maj** est celle qu'on demande le plus souvent. Cliquer le label d'un +élément et tirer déplace l'élément, parce que le label passe l'événement à son +parent. Maintenez **Maj** en appuyant, et le label se déplace seul. + +> **Remarque.** Le texte d'un élément est la seule chose du folio qui ne +> s'aligne pas sur la grille quand on le déplace : il avance d'une unité à la +> fois. C'est en cours de changement dans la +> [PR #927](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/927) ; +> d'ici là, attendez-vous à des labels hors grille. + +--- + +## 3. Dessiner une forme + +Pendant qu'on étire un rectangle ou une ellipse — la barre d'état le rappelle : +*« Clic gauche : positionner le coin opposé (Maj = carré, Ctrl = depuis le +centre + position libre, Ctrl+Maj = carré centré) ; clic droit : annuler »* : + +| Touche | Résultat | +|---|---| +| *rien* | d'un coin à l'autre, aligné sur la grille | +| **Maj** | un carré ou un cercle parfait — le plus grand côté l'emporte | +| **Ctrl** | tracé **depuis le centre**, et hors grille | +| **Ctrl+Maj** | un carré ou un cercle centré | + +Maj n'a aucun effet sur les lignes, les polygones et les chemins : seulement sur +les rectangles et les ellipses. + +Le fait qu'une forme soit centrée est décidé **au premier clic**, et non +revérifié pendant le glisser. Relâcher Ctrl en cours de route ne la ramène pas à +un tracé depuis le coin ; c'est voulu, pour qu'une main fatiguée n'annule pas une +décision déjà prise. + +--- + +## 4. Remodeler : redimensionner, pivoter, incliner + +Sélectionnez une forme ou une image et tirez une de ses poignées. + +| Poignée | Touche | Résultat | +|---|---|---| +| Redimensionner | **Ctrl** | redimensionne symétriquement depuis le centre au lieu du coin opposé | +| Redimensionner | **Maj** | conserve les proportions — pour une image, ses proportions **d'origine**, pas un carré forcé | +| Coin (formes) | **Alt** | détache ce coin : le rectangle ou l'ellipse devient un polygone que l'on remodèle librement. Les poignées de milieu de côté ignorent Alt | +| Pivoter | **Maj** | cale l'angle par pas de 15° | +| Incliner | **Maj** | cale l'inclinaison par pas de 15° | +| Début/fin d'arc | **Maj** | cale l'angle de l'arc par pas de 15° | +| Nœud de chemin (mode édition de nœuds) | **Alt** | donne au nœud des poignées de courbe symétriques | +| Poignée de courbe | **Alt** | rompt la symétrie : le nœud devient un coin au lieu de refléter la poignée opposée | + +Ctrl libère ici aussi le glisser de la grille, comme partout ailleurs. + +--- + +## 5. Sélectionner + +| Action | Résultat | +|---|---| +| **Ctrl**+clic sur un objet ou un conducteur | l'ajoute à la sélection, ou l'en retire | +| Glisser dans le vide | sélection par rectangle élastique, textes d'éléments compris | +| **Tab** / **Maj+Tab** | passe à l'objet suivant / précédent sans souris | + +--- + +## 6. Déplacer au clavier + +Avec une sélection, et sans texte en cours d'édition : + +| Touches | Déplacent de | +|---|---| +| Flèches | la grille de déplacement — 10 unités par défaut | +| **Alt**+flèches | la grille fine — 1 unité par défaut | +| **Ctrl**+flèches | rien ne bouge ; ajuste l'alignement d'un groupe de textes sélectionné | + +Les deux grilles se règlent dans **[Configuration → Général](preferences)**, +indépendamment de celle sur laquelle la souris s'aligne. + +--- + +## 7. Vue et navigation + +| Action | Résultat | +|---|---| +| **Ctrl**+molette | zoom avant et arrière (mode gestes/pavé tactile) | +| **Ctrl**+**+** / **Ctrl**+**−** | zoom avant et arrière | +| **Ctrl**+molette sur les onglets de folios | change de folio | + +--- + +## 8. Annuler ce qu'on a commencé + +Dès qu'un outil est choisi — un élément, une forme, un modèle, un collage — une +pose est en cours et suit le pointeur jusqu'à ce que vous la terminiez. + +| Touche | Résultat | +|---|---| +| **Clic gauche** | pose l'objet | +| **Clic droit** | annule. Le menu contextuel du folio est désactivé pendant une pose, d'où l'annulation au lieu d'un menu | +| **Échap** | annule, dès le début de la pose | + +> L'outil **texte** fait exception : ni Échap ni le clic droit ne l'annulent, et +> le clic suivant dépose un champ de texte dont vous ne vouliez peut-être pas. +> Corrigé par la +> [PR #928](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/928) ; +> en attendant, la sortie consiste à choisir un autre outil. + +--- + +## 9. Dans l'éditeur d'élément + +L'éditeur d'élément suit la même règle **Ctrl = ignorer la grille** pour les +parties, les textes et les poignées, et la même règle **Maj = pas de 15°** pour +les rotations. Il garde ses propres réglages de grille, distincts de ceux du +schéma. + +--- + +## 10. Ce qui surprend + +- **Ctrl+clic et Ctrl+glisser** ne font pas la même chose, voir plus haut. +- **Ctrl+Maj est réservé** par la vue du folio ; n'attendez pas qu'il se combine + librement. +- **Maj sur le texte d'un élément** est le seul moyen de déplacer un label sans + son élément — il n'existe aucune entrée de menu pour cela. +- **Alt sur un coin de forme est destructeur, utilement** : la conversion en + polygone est une vraie modification de l'objet, pas un affichage temporaire. + +--- + +## Voir aussi + +- **[Tout piloter au clavier](keyboard_control)** — se passer de la souris +- **[Configuration](preferences)** — les réglages de grille et de déplacement +- **[Modèles](templates-FR)** — qui se déposent au glisser, et pas autrement +- **[Conducteurs](conductors-FR)** — les propriétés des fils diff --git a/printing_and_export-FR.md b/printing_and_export-FR.md new file mode 100644 index 0000000..a45bf30 --- /dev/null +++ b/printing_and_export-FR.md @@ -0,0 +1,150 @@ +# Imprimer et exporter + +Sortir un schéma de QElectroTech passe par l'un de trois chemins, et ce ne sont +pas les mêmes boutons sur le même code : ils n'offrent pas les mêmes options ni +les mêmes valeurs par défaut. + +| Vous voulez | Utilisez | Ce que c'est | +|---|---|---| +| du papier, ou un PDF | **Fichier → Imprimer**, ou **Fichier → Exporter en pdf** | la même fenêtre, avec le format de sortie changé | +| du PNG, JPEG, BMP, SVG ou DXF | **Fichier → Exporter** | une fenêtre par folio, avec ses propres dimensions | +| la même chose depuis un script | `qelectrotech --export-pdf` / `--export-png` / `--export-svg` | voir **[Référence de la ligne de commande](cli_reference)** | + +Sources : `sources/print/projectprintwindow.{ui,cpp}`, +`sources/exportpropertieswidget.cpp`, `sources/exportproperties.cpp`. + +--- + +## 1. Imprimer et exporter en PDF, c'est la même fenêtre + +**Fichier → Exporter en pdf** ouvre la fenêtre d'impression avec le format de +sortie réglé sur PDF. Tout ce qui suit vaut pour les deux. + +Vous y trouvez la liste **Folios à imprimer :** avec **Tout cocher** / +**Tout décocher**, un aperçu, et ces options : + +| Option | Par défaut | Effet | +|---|---|---| +| **Adapter le folio à la page** | activé | met le folio à l'échelle du papier. Désactivez pour imprimer à l'échelle réelle, quitte à déborder sur plusieurs feuilles | +| **Utiliser toute la feuille** | désactivé | ignore la marge non imprimable de l'imprimante. À n'activer que si l'imprimante le permet vraiment | +| **Dessiner le cadre** | activé | le cadre avec les repères de lignes et de colonnes | +| **Dessiner le cartouche** | activé | le cartouche | +| **Conserver les couleurs des conducteurs** | activé | imprime les fils en couleur plutôt qu'en noir | +| **Dessiner les bornes** | désactivé | les marques de bornes sur les éléments | +| **Dessiner les noms des bornes** | désactivé | leurs libellés | +| **Inscrire les informations des composants** | désactivé | **PDF uniquement** — voir plus bas | + +Il n'y a volontairement **aucune option de grille ici** : la grille de l'éditeur +n'est jamais imprimée. + +Les réglages sont mémorisés sous `print/default/…`, séparément de ceux de +l'export d'images : régler l'un ne règle pas l'autre. + +### Choisir les folios par date + +Au-dessus de la liste se trouve un filtre de date — **Toutes les dates**, +**À partir de la date du**, **À la date du**. Il ne filtre pas l'impression : il +**coche et décoche la liste pour vous**, d'après la date du cartouche de chaque +folio. + +| Choix | Coche | +|---|---| +| Toutes les dates | tous les folios | +| À partir de la date du | les folios datés à cette date ou après | +| À la date du | les folios datés exactement de ce jour | + +« Imprimer tout ce qui a été révisé depuis le 3 » devient un clic au lieu de +quarante. Vous pouvez toujours cocher et décocher à la main ensuite. + +### Deux choses qu'un PDF de QElectroTech fait et auxquelles on ne s'attend pas + +- **Les renvois deviennent cliquables.** Les renvois de folio et les références + croisées sont transformés en liens internes : cliquer sur un renvoi dans le + PDF saute au folio visé. C'est automatique, aussi bien depuis l'interface que + depuis la ligne de commande — rien à activer. +- **Les informations des composants peuvent être jointes en bulles.** Cochez + **Inscrire les informations des composants** — visible seulement quand la + sortie est un PDF — et les informations de chaque élément lui sont attachées + sous forme d'annotation PDF consultable. Les renvois de folio et les éléments + esclaves sont ignorés. + +--- + +## 2. Exporter des images + +**Fichier → Exporter** est une autre fenêtre : une ligne par folio, chacune avec +son **Nom de fichier**, ses **Dimensions** (largeur × hauteur), un bouton +**Conserver les proportions**, **Réinitialiser les dimensions**, un **Aperçu** +et **Exporter vers le presse-papier**. Plus **Tout cocher** / **Tout décocher**. + +Formats : + +| Format | Remarques | +|---|---| +| **PNG (*.png)** | matriciel sans perte, le choix habituel | +| **JPEG (*.jpg)** | avec pertes ; mauvais pour un trait | +| **Bitmap (*.bmp)** | matriciel non compressé | +| **SVG (*.svg)** | vectoriel — s'agrandit sans perte, et peut avoir un fond transparent | +| **DXF (*.dxf)** | vectoriel pour l'échange CAO — voir **[Import et export DXF](dxf)**. Les images ne sont pas incluses dans l'export DXF | + +### Les options de rendu partagées + +Sous **Options de rendu**, avec leurs valeurs par défaut : + +| Option | Par défaut | Remarques | +|---|---|---| +| **Exporter entièrement le folio** | choisi | le folio **avec** son cadre et son cartouche | +| **Exporter seulement les éléments** | — | le dessin seul, rogné sur son contenu | +| **Dessiner la grille** | désactivé | | +| **Dessiner le cadre** | activé | | +| **Dessiner le cartouche** | activé | | +| **Dessiner les bornes** | désactivé | | +| **Dessiner les noms des bornes** | désactivé | | +| **SVG: fond transparent** | désactivé | SVG uniquement | +| **Conserver les couleurs des conducteurs** | activé | sinon les fils sortent en noir | + +Mémorisées sous `export/default/…`. Le **Dossier cible** est par défaut votre +dossier de documents, et y revient si le dossier enregistré n'existe plus. + +> **Les guides ne sont pas une option.** La propriété `draw_guides` existe et +> est écrite dans vos réglages, mais aucune fenêtre ne la propose et +> l'impression la force à l'arrêt. Les guides n'arrivent jamais dans un export. + +--- + +## 3. Quel chemin choisir + +| Situation | Chemin | +|---|---| +| Envoyer un schéma à quelqu'un | le PDF — il garde les renvois cliquables | +| Mettre un folio dans un document ou un courriel | le PNG, à la dimension voulue | +| Passer un dessin à un autre logiciel de CAO | le SVG ou le DXF | +| Un folio pour le web, sur un fond coloré | le SVG à fond transparent | +| Le même export toutes les semaines | la ligne de commande — voir **[Référence de la ligne de commande](cli_reference)** | + +--- + +## 4. Bon à savoir + +- **La grille de l'éditeur n'est jamais dans la sortie.** Elle est désactivée + par défaut à l'export et n'est pas proposée du tout à l'impression. +- **« Adapter le folio à la page » est actif par défaut**, donc un folio imprimé + est mis à l'échelle. Pour l'échelle réelle, désactivez-le et attendez-vous à + plusieurs feuilles. +- **« Exporter seulement les éléments » rogne sur le dessin**, ce qui convient à + une figure dans un document et jamais à un schéma que quelqu'un doit lire + seul. +- **Les réglages d'impression et d'export d'images sont séparés.** Régler l'un + ne règle pas l'autre. +- **Le fond transparent ne vaut que pour le SVG.** Le cocher pour un PNG ne fait + rien. + +--- + +## Voir aussi + +- **[Référence de la ligne de commande](cli_reference)** — les mêmes exports + depuis un script, plus les exports CSV +- **[Import et export DXF](dxf)** — deux fonctions sans rapport, un même format +- **[Conducteurs](conductors-FR)** — les couleurs que ces exports respectent +- **[Manuel utilisateur](user_manual)** — la marche à suivre diff --git a/printing_and_export.md b/printing_and_export.md index 06f4445..9d229e3 100644 --- a/printing_and_export.md +++ b/printing_and_export.md @@ -33,6 +33,21 @@ these options: There is deliberately **no grid option here**: the editor grid is never printed. +### Picking folios by date + +Above the folio list is a date filter — **Toutes les dates**, **À partir de la +date du**, **À la date du**. It does not filter the printout; it **ticks and +unticks the folio list for you**, using each folio's title-block date: + +| Choice | Ticks | +|---|---| +| All dates | every folio | +| From the date | folios dated on or after the date you pick | +| On the date | folios dated exactly that date | + +That makes "print everything revised since the 3rd" one click rather than +forty. You can still tick and untick by hand afterwards. + Settings are remembered under `print/default/…`, separately from the image export's — changing one does not change the other. @@ -74,7 +89,6 @@ These apply to image export, and their out-of-the-box values are: |---|---|---| | **Exported area** | border | the folio **with** its border and title block. The alternative is elements only — the drawing cropped to its content | | **Draw grid** | off | | -| **Draw guides** | off | | | **Draw border** | on | | | **Draw title block** | on | | | **Draw terminals** | off | | @@ -85,6 +99,10 @@ These apply to image export, and their out-of-the-box values are: Remembered under `export/default/…`. The destination folder defaults to your documents folder, and falls back to it if the saved folder no longer exists. +> **Guides are not an option.** `draw_guides` exists as a stored property and +> is written to your settings, but no dialog offers it and the print path forces +> it off. Guides never reach an export. + --- ## 3. Which path to use diff --git a/templates-FR.md b/templates-FR.md new file mode 100644 index 0000000..71e869c --- /dev/null +++ b/templates-FR.md @@ -0,0 +1,197 @@ +# Modèles (l'onglet « Modèles ») + +Un **modèle** — *template* dans les menus, *macro* dans le code et sur le disque +(`.qetmak`) — est un morceau de folio enregistré : les éléments que vous aviez +sélectionnés, avec leurs propres définitions de symboles à l'intérieur du +fichier, que vous pouvez redéposer sur n'importe quel folio, dans n'importe quel +projet, d'un seul bloc. + +C'est l'outil qui convient au bloc de câblage que vous redessinez sans arrêt : +un départ moteur, un circuit d'éclairage, une arrivée type. Un élément est un +symbole ; un modèle est un agencement de symboles. + +> **Un modèle se dépose par glisser-déposer, et uniquement ainsi.** Cliquer ou +> double-cliquer son nom dans la liste ne fait rien du tout — volontairement, +> dans le code — et son menu contextuel n'a pas d'entrée « insérer ». Si vous +> avez sélectionné un modèle en attendant qu'il se passe quelque chose, rien +> n'était cassé : faites-le glisser sur le folio. C'est de loin la confusion la +> plus fréquente à propos de cette fonction. + +Sources : `sources/diagramview.cpp`, +`sources/ElementsCollection/elementscollectionwidget.cpp`, +`sources/diagramevent/diagrameventaddmacro.cpp`. + +--- + +## 1. Créer un modèle + +1. Sur un folio, sélectionnez ce que vous voulez conserver : éléments, + conducteurs, textes, images — tout ce qui se sélectionne convient. +2. **Clic droit sur la sélection → « Créer un template »**. L'entrée n'apparaît + que si quelque chose est sélectionné ; un clic droit dans le vide donne le + menu du folio (propriétés, ajouter ou enlever une ligne ou une colonne). +3. La fenêtre **« Enregistrer un template »** demande où le mettre : + *« Choisissez l'emplacement dans lequel vous souhaitez enregistrer votre + template. »* Choisissez la collection dans l'arbre, saisissez un + **« Nom du nouveau template »**, puis **Save**. +4. Un message confirme le chemin complet du fichier écrit. + +L'extension `.qetmak` est ajoutée pour vous, et masquée de nouveau quand le +modèle apparaît dans le panneau. + +> L'onglet s'appelle **Modèles** mais la collection qu'il contient s'appelle +> **Macros** — c'est la même chose. C'est le dossier des modèles décrit plus bas. + +--- + +## 2. Déposer un modèle + +Ouvrez l'onglet **Modèles** du panneau des éléments (à côté de **Collections**), +puis **faites glisser le modèle sur le folio**. + +| Étape | Ce qui se passe | +|---|---| +| Vous le lâchez sur le folio | un aperçu translucide du modèle entier suit le pointeur, aligné sur la grille | +| **Clic gauche** | le modèle est posé à l'endroit de l'aperçu | +| **Clic droit** | la pose est annulée, rien n'est ajouté | +| **Échap** | annule aussi, dès le lâcher et pas seulement après le premier clic | + +Pendant une pose, le menu contextuel du folio est désactivé : c'est pourquoi le +clic droit annule au lieu d'ouvrir un menu. + +Ce qui ne dépose **pas** un modèle, par conception : + +| Action | Résultat | +|---|---| +| Simple clic sur le nom | sélectionne la ligne, rien de plus | +| Double-clic sur le nom | rien — le code sort immédiatement | +| Menu contextuel du modèle | propose la suppression, jamais l'insertion | + +--- + +## 3. Où sont rangés les modèles + +Les modèles ont leur propre collection, distincte des éléments : + +| | Chemin | +|---|---| +| Par défaut | *(dossier de données de l'application)*`/macros/` | +| Linux | `~/.local/share/QElectroTech/QElectroTech/macros/` | +| Windows | `%APPDATA%\QElectroTech\QElectroTech\macros\` | +| macOS | `~/Library/Application Support/QElectroTech/QElectroTech/macros/` | + +La base est l'emplacement « données d'application » de Qt : une installation +portable ou en bac à sable (Snap, Flatpak, AppImage avec un dossier personnel +dédié) le résoudra à l'intérieur de ce bac à sable. + +Vous pouvez déplacer ce dossier — par exemple sur un partage réseau, pour qu'une +équipe pioche dans la même bibliothèque — depuis +**[Configuration → Général](preferences)**, au même endroit que les collections +d'éléments et de cartouches. Si le chemin configuré n'existe plus, QElectroTech +revient au dossier par défaut : vous vous retrouvez avec une liste vide plutôt +qu'avec une erreur. + +Un modèle est un fichier. Copier un `.qetmak` dans le dossier le fait +apparaître, le supprimer le retire, et vous pouvez créer des sous-dossiers pour +les organiser. + +--- + +## 4. Ce que contient un fichier `.qetmak` + +C'est du XML, et il emporte les définitions des symboles avec lui. C'est ce qui +rend un modèle transportable d'un projet à l'autre et d'une machine à l'autre : +le projet qui le reçoit n'a pas besoin d'avoir les éléments installés. + +```xml + + + + + ...le dessin complet du symbole... + + + + + + + ...ce que vous aviez sélectionné... + + + + +``` + +| Partie | Ce qu'elle contient | +|---|---| +| `` | un `` par symbole **distinct** utilisé, avec sa définition complète — un modèle qui utilise six relais identiques ne stocke le relais qu'une fois | +| `` | le contenu sélectionné lui-même, sous forme de fragment de folio | +| les attributs `type` | réécrits en `macro://…`, pour que les objets posés se résolvent sur les définitions embarquées | + +Un modèle ne contenant qu'une lampe pèse environ 3 ko, presque uniquement la +définition du symbole. + +--- + +## 5. Modèles, éléments et copier-coller + +| | Modèle (`.qetmak`) | Élément (`.elmt`) | Copier-coller | +|---|---|---|---| +| Contient plusieurs objets et leur câblage | oui | non — un symbole | oui | +| Survit à la fermeture du projet | oui | oui | non, presse-papiers seulement | +| Réutilisable d'un projet à l'autre | oui | oui | seulement si les deux sont ouverts | +| Emporte les définitions de symboles | oui | — | non | +| Se dépose par | glisser depuis l'onglet Modèles | glisser depuis l'onglet Collections | Ctrl+V | +| Se modifie après coup | le recréer depuis une nouvelle sélection | éditeur d'élément | — | + +Il n'y a pas d'éditeur de modèles : pour en changer un, déposez-le, corrigez-le +sur un folio, et réenregistrez un modèle sous le même nom. + +--- + +## 6. Limites + +- **Le glisser-déposer est le seul moyen de déposer un modèle.** Pas d'entrée de + menu, pas de raccourci clavier, pas de double-clic — + [issue #931](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/931). +- **Les modèles ne se modifient pas sur place.** Recréez-les depuis une + sélection corrigée. +- **Pas de vignette dans le panneau** : les modèles sont listés par leur nom + seul, donc le nom que vous choisissez est le seul indice de leur contenu — + [issue #932](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/932). +- Si vous utilisez une version de développement antérieure au **13 septembre + 2026**, glisser un modèle sur un folio ne fait rien sur les versions Qt 6 ; + c'est corrigé par la + [PR #853](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/853). + Mettez à jour avant de conclure que la fonction est cassée. + +--- + +## 7. En cas de problème + +**« Je sélectionne mon modèle dans la liste et rien ne se pose sur le folio. »** +C'est normal : sélectionner ne fait rien. Faites-le glisser sur le folio. + +**« Je l'ai fait glisser et il ne se passe toujours rien. »** +Vérifiez la date de la version — voir la note Qt 6 ci-dessus. Vérifiez ensuite +que vous l'avez lâché dans la zone de dessin du folio et non dans la marge +grise. + +**« L'aperçu reste collé au pointeur. »** +Une pose est en cours : clic gauche pour la poser, Échap ou clic droit pour +annuler. + +**« Mes modèles ont disparu. »** +Le dossier des modèles est configurable dans Configuration → Général. S'il +pointe vers un disque non monté, la collection apparaît vide. Vérifiez le +chemin, ou recopiez les `.qetmak` dans le dossier par défaut ci-dessus. + +--- + +## Voir aussi + +- **[Gérer les collections](collection_browser)** — le panneau où vit l'onglet + Modèles +- **[Utiliser l'éditeur d'élément](element_editor)** — pour dessiner les + symboles qu'un modèle assemble +- **[Configuration](preferences)** — où se règle le dossier des modèles