diff --git a/conductors-FR.md b/conductors-FR.md new file mode 100644 index 0000000..e77cd27 --- /dev/null +++ b/conductors-FR.md @@ -0,0 +1,242 @@ +# Conducteurs (fils) + +Un **conducteur** est le trait qui relie deux bornes d'éléments. C'est l'objet +que l'on pose le plus souvent et que l'on configure le moins : sa fenêtre de +propriétés comporte une vingtaine de champs, dont plusieurs n'existent que pour +remplir une colonne d'export, et deux qui ne servent aujourd'hui à rien. + +Cette page est la référence de ces champs : ce que fait chacun, où il est +enregistré, et quel export le lit. Pour apprendre à *tracer* des fils, voir +**[Manuel utilisateur](user_manual)**. + +> **Vocabulaire.** Cette page dit *conducteur*, comme la fenêtre de propriétés ; +> on dit aussi *fil* dans le métier. C'est la même chose. + +Sources : `sources/conductorproperties.{h,cpp}`, +`sources/ui/conductorpropertieswidget.ui`, `sources/wiringlistexport.cpp`, +`sources/dataBase/projectdatabase.cpp`. + +--- + +## 1. Deux types de conducteur + +Chaque conducteur est de l'un des deux types, et ce choix décide quelle moitié +de la fenêtre de propriétés s'applique. + +| Type | Affiche | Sert à | +|---|---|---| +| **Multifilaire** (par défaut) | un trait avec un **texte** | les schémas développés ordinaires, un conducteur par fil | +| **Unifilaire** | un trait avec des **symboles** — phases, neutre, terre — et pas de texte | les schémas unifilaires, où un trait représente tout un circuit | + +Changer de type ne perd pas les réglages de l'autre : les deux sont +enregistrés, seul celui qui correspond est dessiné. + +--- + +## 2. D'où viennent les réglages d'un conducteur + +Il y a trois niveaux, et ce sont trois endroits différents dans l'interface. Un +nouveau conducteur prend le réglage du folio ; modifier ce réglage ne réécrit +pas les conducteurs déjà tracés. + +| Niveau | Où | S'applique à | +|---|---|---| +| Défaut de l'application | **Configuration → Nouveau projet** | les conducteurs des projets créés ensuite | +| Défaut du folio | propriétés du folio | les conducteurs tracés ensuite sur ce folio | +| Un conducteur | double-clic sur le conducteur | ce conducteur seulement | + +Pour modifier beaucoup de conducteurs existants d'un coup, sélectionnez-les et +utilisez **[Chercher & remplacer](search_and_replace)**. + +--- + +## 3. Les propriétés, champ par champ + +Enregistrées dans le fichier `.qet` sur chaque élément ``, sous +l'attribut indiqué en dernière colonne. + +### Identification et documentation + +| Champ | Ce que c'est | Attribut XML | +|---|---|---| +| **Texte** | le numéro de fil affiché sur le schéma | `num` | +| **Formule du texte** | l'expression dont le numéro est tiré, pour l'autonumérotation | `formula` | +| **Fonction** | texte libre : à quoi sert le fil | `function` | +| **Tension / Protocole** | texte libre : tension ou protocole, par exemple `24VDC`, `Profibus` | `tension_protocol` | +| Couleur du fil | texte libre **nommant** la couleur physique du fil, par exemple `BN`, `bleu` — ce n'est pas la couleur de tracé | `conductor_color` | +| **Section du conducteur** | texte libre : la section, par exemple `1.5mm²` | `conductor_section` | +| **cable** | texte libre | `cable` | +| **bus** | texte libre | `bus` | + +> **cable et bus sont enregistrés mais inutilisés.** Ils sont sauvegardés dans +> le projet, relus à l'ouverture et affichés dans la fenêtre — mais rien ne les +> lit : aucun export, aucun rapport, aucun tracé. Remplissez-les si vous voulez +> que l'information figure dans le fichier ; n'attendez pas qu'elle ressorte +> quelque part. + +### Apparence + +| Champ | Ce qu'il fait | Attribut XML | +|---|---|---| +| **Couleur** | la couleur de tracé du trait | `color` | +| **Couleur secondaire** | trace le fil en deux couleurs alternées | `bicolor`, `color2` | +| **Taille de trait** | longueur de chaque segment de couleur en bicolore | `dash-size` | +| **Style** | continu, tirets, pointillés, tiret-point | `style` | +| **Taille** | épaisseur du trait | `condsize` | + +### Le texte + +| Champ | Ce qu'il fait | Attribut XML | +|---|---|---| +| **Texte visible** | afficher le numéro, ou le masquer | `displaytext` | +| **Un texte par potentiel** | n'afficher le numéro **qu'une fois par potentiel et par folio**, sur le conducteur le plus long, et le masquer sur les autres | `onetextperfolio` | +| **Taille du texte** | 9 par défaut | `numsize` | +| **Couleur du texte** | — | `text_color` | +| **Position et rotation** | *Horizontal en haut / en bas*, *Vertical à gauche / à droite* : angle du texte sur les tronçons horizontaux et verticaux, 0° et 270° par défaut | `horizrotatetext`, `vertirotatetext`, `horizontal-alignment`, `vertical-alignment` | + +Les conducteurs reliés à travers les éléments forment un **potentiel**. L'option +« un texte par potentiel » est ce qui évite de répéter dix fois le même numéro +le long d'un potentiel. + +### Mode unifilaire + +Dessiné uniquement quand le type est *Unifilaire* : + +| Champ | Ce qu'il dessine | Attribut XML | +|---|---|---| +| **Nombre de phase** | autant de marques de phase sur le trait | `phase` | +| **Neutre** | le symbole du neutre | `neutral` | +| **Terre** | le symbole de terre | `ground` | +| **PEN** | le symbole PEN (*Protective Earth Neutral*) | `pen` | + +--- + +## 4. Quel champ alimente quel export + +C'est la réponse pratique à « à quoi sert ce champ ». Un champ vide donne une +colonne vide. + +**`--export-cables`** — la liste de câblage, une ligne par conducteur : + +| Colonne | Vient de | +|---|---| +| Page | le folio du conducteur | +| Composant 1 / Borne 1 | l'élément et la borne d'un bout | +| Composant 2 / Borne 2 | l'élément et la borne de l'autre bout | +| Tension / Protocole | **Tension / Protocole** | +| Couleur du fil | le champ texte de couleur de fil, pas la couleur de tracé | +| Section du fil | **Section du conducteur** — la colonne et le champ ne portent pas le même nom | +| Fonction | **Fonction** | + +**`--export-wires`** produit la liste des numéros de fil. + +**`--export-wiring`** produit aussi une liste point à point, mais depuis la +**base de données du projet** — dont la table `conductor` ne contient que les +deux bornes et le numéro de fil. Aucun des champs de documentation ci-dessus +n'y existe, donc cet export ne peut pas porter la tension, la couleur, la +section ni la fonction. Pour ces colonnes, utilisez `--export-cables`. + +### Voir la liste sans l'exporter + +**Projet → Liste de câblage (base de données)** affiche la même liste dans une +fenêtre : **Fil**, **Composant 1 / Borne 1**, **Composant 2 / Borne 2**, +**Folio**. + +Les lignes sont triées par folio puis par numéro de fil — les numéros +numériques d'abord et dans l'ordre des valeurs, donc `9` avant `10`, puis le +reste comme du texte. + +Deux choses que cette fenêtre dit et que le CSV ne dit pas : + +- elle **rafraîchit la base avant d'interroger**, donc un numéro modifié plus + tôt dans la séance y figure déjà ; +- elle **compte ce qu'elle a écarté**. Un conducteur dont une extrémité n'est + rattachée à aucun élément ne peut pas figurer dans une liste point à point, et + la fenêtre annonce combien ont été exclus. Si ce nombre n'est pas zéro, + quelque chose n'est pas raccordé là où vous le croyez. + +--- + +## 5. À propos des câbles + +QElectroTech n'a **pas d'objet câble**. Il n'y a pas de câble dans le modèle de +données, pas de table de câbles dans la base du projet, et aucun moyen de +regrouper plusieurs conducteurs en un câble pour lui donner un repère, un type +ou un nombre de conducteurs. + +Ce qui existe est plus petit que le nom ne le laisse croire : + +| Ce que c'est | En réalité | +|---|---| +| Le champ **cable** d'un conducteur | du texte libre, enregistré et relu, lu par rien | +| La commande **`--export-cables`** | la liste de câblage — une ligne par *conducteur*, pas par câble | + +Un conducteur peut donc noter à quel câble vous comptez le rattacher, et ce +texte survit dans le fichier, mais rien ne regroupe les conducteurs en câbles, +ne vérifie un nombre de conducteurs, ni n'en fait de rapport. La gestion des +câbles doit vivre dans la convention de numérotation, ou hors de QElectroTech. +Une proposition est ouverte : +[discussion #934](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/934). + +--- + +## 6. Tracés et cheminement + +Un conducteur se route tout seul entre ses deux bornes. Tirez n'importe quel +tronçon pour lui donner une forme à la main : cette forme est enregistrée avec +le projet. + +**Ctrl+K — « Réinitialiser les conducteurs »** abandonne le tracé manuel des +conducteurs sélectionnés et recalcule leur chemin. C'est la sortie de secours +quand tout est emmêlé, et elle ne se rattrape pas en retirant les tronçons : la +forme d'origine est perdue. + +Les formes tracées à la main sont enregistrées comme des tronçons explicites. Si +une forme enregistrée ne correspond plus à la position de ses bornes — parce que +quelque chose a bougé sans que le tracé suive — QElectroTech l'abandonne +silencieusement à l'ouverture et re-route automatiquement. Le schéma paraît +correct ; le tracé manuel, lui, est perdu. + +--- + +## 7. Mettre une couleur rapidement + +Sélectionnez **un seul** conducteur et appuyez sur **F2** pour ouvrir un +sélecteur de couleur. Le raccourci ne fait rien si plusieurs conducteurs sont +sélectionnés, ou aucun. + +> Un bouton de couleur dans la barre d'outils, appliqué à tous les conducteurs +> sélectionnés et servant aussi au prochain conducteur tracé, est proposé dans +> la [PR #929](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/929). +> En attendant : F2 un par un, ou Chercher & remplacer pour un lot. + +Il n'existe **pas de préréglages de conducteur nommés**. Un projet a un seul jeu +de propriétés par défaut, pas une bibliothèque de jeux nommés ; la demande est +l'[issue #461](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/461). +Une documentation ancienne évoquant une « liste des conducteurs du projet » +décrit quelque chose qui n'existe pas. + +--- + +## 8. Ce qui se fait tout seul pendant le tracé + +| Réglage | Où | Ce qu'il fait | +|---|---|---| +| **Création automatique de conducteur(s)** | menu Projet / barre d'outils | quand vous posez un élément dont les bornes tombent sur des bornes existantes, les raccorde pour vous | +| **Coupure automatique de conducteur(s)** | menu Projet / barre d'outils | poser un élément sur un conducteur existant le coupe et raccorde les deux moitiés | + +Les deux sont propres au projet, et les deux peuvent rester désactivés. + +--- + +## Voir aussi + +- **[Manuel utilisateur](user_manual)** — comment tracer les fils +- **[Autonumérotation](autonumbering)** — comment les numéros de fil sont + générés et figés +- **[Lier des fils d'une page à l'autre](folio_links-FR)** — les renvois de folio +- **[Borniers](terminal_strips)** — là où les conducteurs arrivent sur de vraies + bornes +- **[Chercher & remplacer](search_and_replace)** — modifier beaucoup de + conducteurs d'un coup +- **[Référence de la ligne de commande](cli_reference)** — les exports ci-dessus diff --git a/languages.md b/languages.md index bf1f04f..c662a2c 100644 --- a/languages.md +++ b/languages.md @@ -71,6 +71,10 @@ Beginnen Sie mit der deutschen Version dieses Wikis: | Managing collections | ✅ | ✅ | ✅ | | Search & Replace | ✅ | ✅ | ✅ | | Building a nomenclature query | ✅ | ✅ | ✅ | +| Conductors | ✅ | ✅ | ❌ | +| Printing and exporting | ✅ | ❌ | ❌ | +| Mouse modifiers | ✅ | ❌ | ❌ | +| Templates | ✅ | ❌ | ❌ | **Legend:** ✅ Translated | 📋 Planned | ❌ Not yet started