Die vier neuen Seiten ins Deutsche übersetzen

conductors-DE, templates-DE, mouse_modifiers-DE und
printing_and_export-DE. Die Beschriftungen stammen nicht aus dem Gefühl,
sondern aus lang/qet_de.ts: Mehrpolig und Einpolig, „Spannung /
Protokoll:“, „Leiterquerschnitt:“, „Sichtbarer Text“, „Textformel:“,
„Linienstärke:“, „Phasenanzahl“, „Neutralleiter“, „Erde“, „Leiter
zurücksetzen“, „Automatische Leiterverbindung aktivieren“, „Zu druckende
Seiten:“, „Seite an Seitengröße anpassen“, „Gesamte Blattfläche
verwenden“, „Ganze Seite exportieren“, „Nur Bauteile exportieren“,
„Vorlage erstellen“, „Name der neuen Vorlage“.

Beim Übersetzen sind zwei Lücken der deutschen Oberfläche aufgefallen,
die auf den Seiten stehen, weil sie dort gebraucht werden:

- Der Menüeintrag „Liste de câblage (base de données)“ ist in qet_de.ts
  als unfinished markiert; deutsche Nutzer sehen die französische
  Beschriftung. conductors-DE sagt das und nennt die Spalten trotzdem.
- Sämtliche Statuszeilen-Hinweise zu den Maustasten sind unübersetzt --
  also genau die Hinweise, die diese Tasten erklären würden. Deutsche
  Nutzer lesen dort „Maj = carré, Ctrl = depuis le centre“.
  mouse_modifiers-DE stellt das an den Anfang und übersetzt die Hinweise
  mit.

Im Deutschen heißen Register und Sammlung beide „Vorlagen“; die
französische Doppelbenennung entfällt damit, was templates-DE vermerkt.

languages.md: alle vier Seiten stehen jetzt in drei Sprachen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CaKympWT3owLotCpEN2CFj
ispyisail
2026-09-19 17:48:06 +12:00
parent 7335a2c66e
commit d19511304c
5 changed files with 740 additions and 4 deletions
+229
@@ -0,0 +1,229 @@
# Leiter (Drähte)
Ein **Leiter** ist die Linie zwischen zwei Anschlüssen von Bauteilen. Er ist das
Objekt, das man am häufigsten setzt und am seltensten einstellt: sein
Eigenschaftsfenster hat rund zwanzig Felder, von denen mehrere nur existieren,
um eine Spalte in einem Export zu füllen — und zwei, die derzeit gar nichts tun.
Diese Seite ist die Referenz zu diesen Feldern: was jedes bewirkt, wo es
gespeichert wird und welcher Export es liest. Zum *Zeichnen* von Drähten siehe
das **[Benutzerhandbuch](user_manual)**.
> **Sprachhinweis.** Diese Seite verwendet die deutschen Beschriftungen aus der
> Oberfläche. Wo eine Übersetzung fehlt, zeigt QElectroTech die französische
> Originalzeichenkette an; das ist unten vermerkt.
Quellen: `sources/conductorproperties.{h,cpp}`,
`sources/ui/conductorpropertieswidget.ui`, `sources/wiringlistexport.cpp`,
`sources/dataBase/projectdatabase.cpp`, `lang/qet_de.ts`.
---
## 1. Zwei Arten von Leiter
| Art | Zeigt | Wofür |
|---|---|---|
| **Mehrpolig** (Standard) | eine Linie mit **Text** | gewöhnliche Stromlaufpläne, ein Leiter pro Draht |
| **Einpolig** | eine Linie mit **Symbolen** — Phasen, Neutralleiter, Erde — ohne Text | einpolige Darstellungen, bei denen eine Linie einen ganzen Stromkreis vertritt |
Ein Wechsel der Art verwirft die Einstellungen der anderen nicht: beide werden
gespeichert, gezeichnet wird nur die passende.
---
## 2. Woher die Einstellungen eines Leiters kommen
Drei Ebenen, an drei verschiedenen Stellen der Oberfläche. Ein neuer Leiter
übernimmt die Vorgabe der Seite; das Ändern dieser Vorgabe schreibt bereits
gezeichnete Leiter **nicht** um.
| Ebene | Wo | Gilt für |
|---|---|---|
| Programmvorgabe | **Einstellungen → Neues Projekt** | Leiter in künftig angelegten Projekten |
| Seitenvorgabe | Eigenschaften der Seite | ab dann auf dieser Seite gezeichnete Leiter |
| Ein Leiter | Doppelklick auf den Leiter | nur diesen Leiter |
Um viele vorhandene Leiter auf einmal zu ändern, markieren Sie sie und
verwenden **[Suchen & Ersetzen](search_and_replace)**.
---
## 3. Die Eigenschaften, Feld für Feld
Gespeichert in der `.qet`-Datei an jedem `<conductor>`-Element, unter dem in der
letzten Spalte genannten Attribut.
### Kennzeichnung und Dokumentation
| Feld | Was es ist | XML-Attribut |
|---|---|---|
| **Text:** | die auf dem Plan angezeigte Drahtnummer | `num` |
| **Textformel:** | der Ausdruck, aus dem die Nummer entsteht (automatische Nummerierung) | `formula` |
| **Funktion:** | freier Text: wozu der Draht dient | `function` |
| **Spannung / Protokoll:** | freier Text, z. B. `24VDC`, `Profibus` | `tension_protocol` |
| Leiterfarbe (Textfeld) | freier Text, der die **physische** Drahtfarbe benennt, z. B. `BN`, `blau` — nicht die Zeichenfarbe | `conductor_color` |
| **Leiterquerschnitt:** | freier Text, z. B. `1.5mm²` | `conductor_section` |
| **cable** | freier Text | `cable` |
| **bus** | freier Text | `bus` |
> **cable und bus werden gespeichert, aber nicht gelesen.** Sie landen im
> Projekt, kommen beim Öffnen zurück und stehen im Fenster — doch nichts liest
> sie: kein Export, kein Bericht, keine Zeichnung. Füllen Sie sie aus, wenn die
> Angabe in der Datei stehen soll; erwarten Sie nicht, dass sie irgendwo
> auftaucht.
### Darstellung
| Feld | Wirkung | XML-Attribut |
|---|---|---|
| **Farbe:** | die Zeichenfarbe der Linie | `color` |
| **Zweite Farbe:** | zeichnet die Linie zweifarbig abwechselnd | `bicolor`, `color2` |
| **Linienstärke:** | Länge jedes Farbabschnitts im Zweifarbmodus | `dash-size` |
| **Stil:** | durchgezogen, gestrichelt, gepunktet, Strichpunkt | `style` |
| **Größe:** | Strichdicke | `condsize` |
### Der Text
| Feld | Wirkung | XML-Attribut |
|---|---|---|
| **Sichtbarer Text** | die Nummer anzeigen oder verbergen | `displaytext` |
| Ein Text je Potential | die Nummer **einmal je Potential und Seite** zeigen, am längsten Leiter, und an den übrigen verbergen | `onetextperfolio` |
| **Textgröße:** | Standard 9 | `numsize` |
| **Textfarbe:** | — | `text_color` |
| Lage und Drehung | Winkel des Textes auf waagerechten und senkrechten Abschnitten, Standard 0° und 270°, sowie die Ausrichtung | `horizrotatetext`, `vertirotatetext`, `horizontal-alignment`, `vertical-alignment` |
Über Bauteile verbundene Leiter bilden ein **Potential**. „Ein Text je
Potential“ verhindert, dass dieselbe Drahtnummer entlang eines Potentials
zehnmal wiederholt wird.
### Einpolige Darstellung
Nur gezeichnet, wenn die Art *Einpolig* ist:
| Feld | Was gezeichnet wird | XML-Attribut |
|---|---|---|
| **Phasenanzahl** | so viele Phasenmarken auf der Linie | `phase` |
| **Neutralleiter** | das Neutralleitersymbol | `neutral` |
| **Erde** | das Erdungssymbol | `ground` |
| **PEN** | das PEN-Symbol | `pen` |
---
## 4. Welches Feld welchen Export füllt
Das ist die praktische Antwort auf „wozu ist dieses Feld da“. Ein leeres Feld
ergibt eine leere Spalte.
**`--export-cables`** — die Verdrahtungsliste, eine Zeile je Leiter:
| Spalte | Kommt aus |
|---|---|
| Seite | die Seite des Leiters |
| Bauteil 1 / Anschluss 1 | Bauteil und Anschluss am einen Ende |
| Bauteil 2 / Anschluss 2 | Bauteil und Anschluss am anderen Ende |
| Spannung/Protokoll | **Spannung / Protokoll:** |
| Leiterfarbe | das Textfeld für die Drahtfarbe, nicht die Zeichenfarbe |
| Leiterquerschnitt | **Leiterquerschnitt:** |
| Funktion | **Funktion:** |
**`--export-wires`** liefert die Liste der Drahtnummern.
**`--export-wiring`** liefert ebenfalls eine Von-Nach-Liste, jedoch aus der
**Projektdatenbank** — deren Tabelle `conductor` nur die beiden Anschlüsse und
die Drahtnummer enthält. Keines der obigen Dokumentationsfelder existiert dort,
also kann dieser Export weder Spannung noch Farbe, Querschnitt oder Funktion
mitführen. Für diese Spalten `--export-cables` verwenden.
### Die Liste ansehen, ohne zu exportieren
**Projekt → Liste de câblage (base de données)** zeigt dieselbe Liste in einem
Fenster. Der Menüeintrag ist in `qet_de.ts` als *unfinished* markiert und daher
**auf Deutsch nicht übersetzt** — Sie sehen die französische Beschriftung.
Spalten: Drahtnummer, Bauteil 1 / Anschluss 1, Bauteil 2 / Anschluss 2, Seite.
Sortiert nach Seite, dann nach Drahtnummer — numerische zuerst und nach Wert, so
dass `9` vor `10` steht, anschließend alles Übrige als Text.
Zwei Dinge, die dieses Fenster sagt und die CSV-Datei nicht:
- Es **aktualisiert die Datenbank vor der Abfrage**, eine früher in der Sitzung
geänderte Nummer steht also bereits darin.
- Es **zählt, was es weggelassen hat.** Ein Leiter, dessen Ende an keinem
Bauteil hängt, kann in einer Von-Nach-Liste nicht vorkommen; das Fenster nennt
die Anzahl der ausgeschlossenen Leiter. Ist sie nicht null, ist irgendwo etwas
nicht so verbunden, wie Sie denken.
---
## 5. Zu Kabeln
QElectroTech kennt **kein Kabelobjekt**. Es gibt kein Kabel im Datenmodell,
keine Kabeltabelle in der Projektdatenbank und keine Möglichkeit, mehrere Leiter
zu einem Kabel zusammenzufassen und ihm Bezeichnung, Typ oder Aderzahl zu geben.
| Das | Ist in Wirklichkeit |
|---|---|
| Das Feld **cable** am Leiter | freier Text, gespeichert und zurückgelesen, von nichts ausgewertet |
| Der Befehl **`--export-cables`** | die Verdrahtungsliste — eine Zeile je *Leiter*, nicht je Kabel |
Ein Leiter kann also festhalten, zu welchem Kabel er gehören soll, und dieser
Text überlebt in der Datei — aber nichts fasst Leiter zu Kabeln zusammen, prüft
Aderzahlen oder berichtet darüber. Ein Vorschlag liegt vor:
[Diskussion #934](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/934).
---
## 6. Verlauf und Führung
Ein Leiter führt sich selbst zwischen seinen beiden Anschlüssen. Ziehen Sie
einen Abschnitt, um ihm von Hand eine Form zu geben; diese Form wird mit dem
Projekt gespeichert.
**Strg+K — „Leiter zurücksetzen“** verwirft die von Hand gezogene Führung der
markierten Leiter und berechnet ihren Weg neu. Das ist der Ausweg aus einem
Knäuel — und er lässt sich nicht durch erneutes Ziehen rückgängig machen: die
ursprüngliche Form ist weg.
Von Hand gezogene Formen werden als ausdrückliche Abschnitte gespeichert. Passt
eine gespeicherte Form nicht mehr zur Lage ihrer Anschlüsse — weil sich etwas
bewegt hat, ohne dass der Verlauf nachgeführt wurde — verwirft QElectroTech sie
beim Laden stillschweigend und führt neu. Die Zeichnung sieht richtig aus; die
Handführung ist verloren.
---
## 7. Schnell eine Farbe setzen
Markieren Sie **genau einen** Leiter und drücken Sie **F2**. Mit mehreren oder
ohne Auswahl tut die Taste nichts.
> Eine Farbschaltfläche in der Werkzeugleiste, die auf alle markierten Leiter
> wirkt und zugleich die Farbe des nächsten gezeichneten Leiters setzt, wird in
> [PR #929](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/929)
> vorgeschlagen. Bis dahin: F2 einzeln, oder Suchen & Ersetzen für viele.
**Benannte Leiter-Voreinstellungen gibt es nicht.** Ein Projekt hat einen
einzigen Satz Standardeigenschaften, keine Bibliothek benannter Sätze; die
Anforderung ist
[Issue #461](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/461).
---
## 8. Was beim Zeichnen von selbst geschieht
| Einstellung | Wo | Wirkung |
|---|---|---|
| **Automatische Leiterverbindung aktivieren** | Menü Projekt / Werkzeugleiste | setzen Sie ein Bauteil so, dass seine Anschlüsse auf vorhandene treffen, werden sie verbunden |
| **Automatische Unterbrechung der Leitung(en)** | Menü Projekt / Werkzeugleiste | ein auf einen Leiter gesetztes Bauteil trennt ihn und verbindet beide Hälften |
Beide gelten je Projekt und dürfen ausgeschaltet bleiben.
---
## Siehe auch
- **[Benutzerhandbuch](user_manual)** — Drähte zeichnen
- **[Automatische Nummerierung](autonumbering)** — wie Drahtnummern entstehen
- **[Klemmleisten](terminal_strips)** — wo Leiter auf echte Klemmen treffen
- **[Suchen & Ersetzen](search_and_replace)** — viele Leiter auf einmal ändern
- **[Kommandozeilenreferenz](cli_reference)** — die obigen Exporte
+4 -4
@@ -71,10 +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 | ✅ | ✅ | |
| Conductors | ✅ | ✅ | |
| Printing and exporting | ✅ | ✅ | |
| Mouse modifiers | ✅ | ✅ | |
| Templates | ✅ | ✅ | |
**Legend:** ✅ Translated | 📋 Planned | ❌ Not yet started
+188
@@ -0,0 +1,188 @@
# Maustasten-Modifikatoren: Umschalt, Strg und Alt
Eine Taste festzuhalten, während Sie ziehen, ändert, was das Ziehen tut: eine
Form auf ein Quadrat zwingen, ein Objekt vom Raster lösen, aus der Mitte heraus
skalieren, eine Drehung auf 15° rasten lassen oder den Text eines Bauteils statt
des Bauteils verschieben.
Fast nichts davon ist in der Oberfläche sichtbar. Ein paar dieser Tasten stehen
in der Statusleiste, wenn das Ziehen bereits läuft; der Rest ist nirgends
festgehalten. Diese Seite ist die Liste.
> **Für deutsche Oberflächen besonders wichtig.** Genau jene Hinweise in der
> Statusleiste, die diese Tasten erklären würden, sind in `qet_de.ts` als
> *unfinished* markiert und **nicht übersetzt**: Sie erscheinen auf Französisch,
> etwa *„Clic gauche : positionner le coin opposé (Maj = carré, Ctrl = depuis le
> centre + position libre, Ctrl+Maj = carré centré)“*. Dabei ist **Maj** die
> Umschalttaste. Diese Seite sagt, was dort stünde.
**[Steuerung nur per Tastatur](keyboard_control)** ist die Schwesterseite zum
umgekehrten Problem: ganz ohne Maus arbeiten.
Quellen: `sources/diagram.cpp`, `sources/diagramevent/diagrameventaddshape.cpp`,
`sources/qetgraphicsitem/qetshapeitem.cpp`,
`sources/qetgraphicsitem/dynamicelementtextitem.cpp`, `lang/qet_de.ts`.
---
## 1. Die Regel, die die halbe Seite erklärt: Strg heißt „Raster ignorieren“
Strg wird nicht je Werkzeug behandelt. Die Abfrage steckt **in der Rasterfunktion
selbst**, gilt also überall dort, wo eine Position gefangen wird: ein Bauteil
setzen, eine Form zeichnen, ein Objekt ziehen, einen Griff bewegen.
Mit gedrückter Taste runden Positionen auf das nächste **Pixel** statt auf das
Raster. Das ist Feinpositionierung, keine völlige Freiheit — ganze Koordinaten
bleiben es trotzdem.
Zwei Folgen, über die man leicht stolpert:
- Strg **schaltet außerdem die Auswahl um**, wenn Sie ein Objekt *anklicken*.
Strg+Klick nimmt es in die Auswahl auf oder heraus; Strg während eines
*Ziehens* löst es vom Raster. Dieselbe Taste, zwei Aufgaben, unterschieden
danach, ob Sie die Maus bewegt haben.
- **Strg+Umschalt steht nicht zur Verfügung.** Die Seitenansicht reserviert diese
Kombination für ihren eigenen Moduswechsel.
---
## 2. Verschieben
| Sie ziehen | Ohne Taste | Mit Taste |
|---|---|---|
| Ein Bauteil, ein Bild, eine Form | fängt am Raster | **Strg** — Feinpositionierung |
| Ein freies Textfeld | fängt am Raster | **Strg** — Feinpositionierung |
| Den Text eines Leiters | fängt am Raster | **Strg** — Feinpositionierung |
| **Den Text eines Bauteils** (Beschriftung, Querverweis, Informationsfeld) | verschiebt **das ganze Bauteil** | **Umschalt** — verschiebt nur den Text, das Bauteil bleibt stehen |
| Eine Gruppe von Bauteiltexten | fängt am Raster | **Strg** — Feinpositionierung |
Die Umschalt-Zeile ist die, nach der am häufigsten gefragt wird: Die
Beschriftung eines Bauteils anzuklicken und zu ziehen verschiebt das Bauteil,
weil die Beschriftung das Ereignis an ihr übergeordnetes Objekt weiterreicht.
Halten Sie beim Drücken **Umschalt**, und die Beschriftung bewegt sich allein.
> **Hinweis.** Der Text eines Bauteils ist das einzige Objekt auf der Seite, das
> beim Ziehen nicht am Raster fängt; er rückt in Einzelschritten. Das wird in
> [PR #927](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/927)
> geändert; bis dahin landen Beschriftungen neben dem Raster.
---
## 3. Eine Form zeichnen
Beim Aufziehen eines Rechtecks oder einer Ellipse:
| Taste | Ergebnis |
|---|---|
| *keine* | von Ecke zu Ecke, am Raster |
| **Umschalt** | ein exaktes Quadrat bzw. ein Kreis — die längere Seite gewinnt |
| **Strg** | **aus der Mitte heraus** gezeichnet, und ohne Raster |
| **Strg+Umschalt** | ein zentriertes Quadrat bzw. ein Kreis |
Umschalt wirkt nicht auf Linien, Polygone und Pfade, nur auf Rechtecke und
Ellipsen.
Ob eine Form aus der Mitte wächst, wird **beim ersten Klick** entschieden und
während des Ziehens nicht erneut geprüft. Strg zwischendurch loszulassen holt
die Form nicht zur Eckvariante zurück — absichtlich, damit eine müde Hand keine
bereits getroffene Entscheidung aufhebt.
---
## 4. Umformen: skalieren, drehen, neigen
| Griff | Taste | Ergebnis |
|---|---|---|
| Skalieren | **Strg** | symmetrisch aus der Mitte statt von der Gegenecke |
| Skalieren | **Umschalt** | Seitenverhältnis halten — bei einem Bild sein **ursprüngliches**, kein erzwungenes Quadrat |
| Eckgriff (Formen) | **Alt** | löst diese Ecke heraus: Rechteck oder Ellipse werden zu einem frei formbaren Polygon. Kantengriffe ignorieren Alt |
| Drehen | **Umschalt** | rastet den Winkel in 15°-Schritten |
| Neigen | **Umschalt** | rastet die Neigung in 15°-Schritten |
| Bogenanfang/-ende | **Umschalt** | rastet den Bogenwinkel in 15°-Schritten |
| Pfadknoten (Knotenbearbeitung) | **Alt** | gibt dem Knoten symmetrische Kurvengriffe |
| Kurvengriff | **Alt** | bricht die Symmetrie: der Knoten wird zur Ecke, statt den gegenüberliegenden Griff zu spiegeln |
Strg löst auch hier vom Raster, wie überall sonst.
---
## 5. Auswählen
| Aktion | Ergebnis |
|---|---|
| **Strg**+Klick auf Objekt oder Leiter | nimmt es in die Auswahl auf oder heraus |
| Ziehen im Leeren | Gummiband-Auswahl, Bauteiltexte eingeschlossen |
| **Tab** / **Umschalt+Tab** | zum nächsten / vorigen Objekt, ohne Maus |
---
## 6. Mit den Pfeiltasten verschieben
Bei vorhandener Auswahl und ohne laufende Textbearbeitung:
| Tasten | Verschieben um |
|---|---|
| Pfeiltasten | das Bewegungsraster — standardmäßig 10 Einheiten |
| **Alt**+Pfeiltasten | das Feinraster — standardmäßig 1 Einheit |
| **Strg**+Pfeiltasten | nichts bewegt sich; richtet eine markierte Textgruppe aus |
Beide Raster sind unter **[Einstellungen → Allgemein](preferences)** einstellbar,
unabhängig von dem, an dem die Maus fängt.
---
## 7. Ansicht und Navigation
| Aktion | Ergebnis |
|---|---|
| **Strg**+Mausrad | vergrößern und verkleinern (Gesten-/Touchpad-Modus) |
| **Strg**+**+** / **Strg**+**** | vergrößern und verkleinern |
| **Strg**+Mausrad über den Seitenreitern | Seite wechseln |
---
## 8. Etwas Begonnenes abbrechen
Sobald ein Werkzeug gewählt ist — ein Bauteil, eine Form, eine Vorlage, ein
Einfügen — läuft ein Absetzen und folgt dem Zeiger, bis Sie es beenden.
| Taste | Ergebnis |
|---|---|
| **Linksklick** | setzt ab |
| **Rechtsklick** | bricht ab. Das Kontextmenü der Seite ist währenddessen abgeschaltet, daher bricht der Rechtsklick ab, statt ein Menü zu öffnen |
| **Esc** | bricht ab, ab Beginn des Absetzens |
> Das **Text**-Werkzeug ist die Ausnahme: weder Esc noch Rechtsklick brechen es
> ab, und der nächste Klick setzt ein Textfeld, das Sie vielleicht nicht wollten.
> Behoben in
> [PR #928](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/928);
> bis dahin hilft nur, ein anderes Werkzeug zu wählen.
---
## 9. Im Bauteil-Editor
Der Bauteil-Editor folgt derselben Regel **Strg = Raster ignorieren** für Teile,
Texte und Griffe und derselben Regel **Umschalt = 15°-Schritte** beim Drehen. Er
hat eigene Rastereinstellungen, getrennt von denen des Schaltplans.
---
## 10. Was überrascht
- **Strg+Klick und Strg+Ziehen** tun Verschiedenes, siehe oben.
- **Strg+Umschalt ist reserviert** und lässt sich nicht frei kombinieren.
- **Umschalt auf dem Text eines Bauteils** ist die einzige Möglichkeit, eine
Beschriftung ohne ihr Bauteil zu verschieben — einen Menüeintrag dafür gibt es
nicht.
- **Alt auf einer Formecke ist nützlich destruktiv**: die Umwandlung in ein
Polygon ist eine echte Änderung am Objekt, keine vorübergehende Ansicht.
---
## Siehe auch
- **[Steuerung nur per Tastatur](keyboard_control)** — ohne Maus arbeiten
- **[Einstellungen](preferences)** — Raster- und Bewegungseinstellungen
- **[Vorlagen](templates-DE)** — die per Ziehen abgesetzt werden, und nur so
- **[Leiter](conductors-DE)** — die Eigenschaften der Drähte
+148
@@ -0,0 +1,148 @@
# Drucken und exportieren
Eine Zeichnung aus QElectroTech herauszubekommen führt über einen von drei
Wegen — und das sind nicht dieselben Optionen mit anderen Schaltflächen: sie
haben unterschiedliche Einstellungen und unterschiedliche Vorgaben.
| Sie wollen | Nehmen Sie | Was es ist |
|---|---|---|
| Papier oder ein PDF | **Datei → Drucken** oder **Datei → Als PDF speichern** | dasselbe Fenster, nur mit anderem Ausgabeformat |
| PNG, JPEG, BMP, SVG oder DXF | **Datei → Exportieren** | ein Fenster mit einer Zeile je Seite und eigenen Maßen |
| dasselbe aus einem Skript | `qelectrotech --export-pdf` / `--export-png` / `--export-svg` | siehe **[Kommandozeilenreferenz](cli_reference)** |
Quellen: `sources/print/projectprintwindow.{ui,cpp}`,
`sources/exportpropertieswidget.cpp`, `sources/exportproperties.cpp`,
`lang/qet_de.ts`.
---
## 1. Drucken und PDF sind dasselbe Fenster
**Datei → Als PDF speichern** öffnet das Druckfenster mit dem Ausgabeformat PDF.
Alles Folgende gilt für beides.
Sie sehen die Liste **Zu druckende Seiten:** mit **Alles auswählen** /
**Auswahl aufheben**, eine Vorschau und diese Optionen:
| Option | Vorgabe | Wirkung |
|---|---|---|
| **Seite an Seitengröße anpassen** | ein | skaliert jede Seite auf das Papier. Ausschalten für Originalmaßstab — dann ggf. über mehrere Blätter |
| **Gesamte Blattfläche verwenden** | aus | ignoriert den nicht bedruckbaren Rand des Druckers. Nur einschalten, wenn der Drucker das wirklich kann |
| **Zeichnungsrahmen zeichnen** | ein | der Rahmen mit Zeilen- und Spaltenköpfen |
| **Schriftfeld zeichnen** | ein | das Schriftfeld |
| **Leiterfarben erhalten** | ein | druckt Drähte farbig statt schwarz |
| **Anschlüsse zeichnen** | aus | die Anschlussmarken an Bauteilen |
| **Klemmenbezeichnungen einzeichnen** | aus | deren Beschriftungen |
| **Angaben zu den Komponenten eintragen** | aus | **nur PDF** — siehe unten |
Eine Rasteroption gibt es hier bewusst **nicht**: das Raster des Editors wird nie
gedruckt.
Die Einstellungen werden unter `print/default/…` gemerkt, getrennt von denen des
Bildexports — das eine einzustellen stellt das andere nicht ein.
### Seiten nach Datum auswählen
Über der Liste steht ein Datumsfilter — **Alle Daten**, **Ab Datum:**, sowie die
Variante für ein genaues Datum. Er filtert nicht den Ausdruck, sondern **setzt
und entfernt die Haken in der Seitenliste** anhand des Datums im Schriftfeld
jeder Seite.
| Auswahl | Hakt an |
|---|---|
| Alle Daten | jede Seite |
| Ab Datum | Seiten mit diesem oder späterem Datum |
| Zu diesem Datum | Seiten mit genau diesem Datum |
„Alles drucken, was seit dem 3. überarbeitet wurde“ wird so zu einem Klick statt
vierzig. Von Hand nachhaken können Sie weiterhin.
### Zwei Dinge, die ein QElectroTech-PDF tut, mit denen niemand rechnet
- **Querverweise werden anklickbar.** Seitenverweise und Querverweise werden zu
internen Verknüpfungen: ein Klick im PDF springt auf die gemeinte Seite. Das
geschieht automatisch, sowohl über die Oberfläche als auch über die
Kommandozeile — nichts einzuschalten.
- **Komponentenangaben lassen sich als Notiz anhängen.** Mit **Angaben zu den
Komponenten eintragen** — nur sichtbar, wenn die Ausgabe ein PDF ist — werden
die Informationsfelder jedes Bauteils als aufklappbare PDF-Anmerkung
angehängt. Seitenverweise und Slave-Bauteile werden dabei übersprungen.
---
## 2. Bilder exportieren
**Datei → Exportieren** ist ein anderes Fenster: eine Zeile je Seite, jeweils mit
**Dateiname**, **Maße** (Breite × Höhe), **Verhältnis beibehalten**,
**Größe zurücksetzen**, **Vorschau** und **In die Zwischenablage kopieren**.
Dazu **Alles auswählen** / **Auswahl aufheben**.
Formate:
| Format | Anmerkungen |
|---|---|
| **PNG (*.png)** | verlustfrei, der übliche Fall |
| **JPEG (*.jpg)** | verlustbehaftet; für Strichzeichnungen schlecht |
| **Bitmap (*.bmp)** | unkomprimiert |
| **SVG (*.svg)** | vektoriell — verlustfrei skalierbar, transparenter Hintergrund möglich |
| **DXF (*.dxf)** | vektoriell für den CAD-Austausch — siehe **[DXF-Import und -Export](dxf)**. Bilder sind im DXF-Export nicht enthalten |
### Die gemeinsamen Renderoptionen
Unter **Renderoptionen**, mit ihren Vorgaben:
| Option | Vorgabe | Anmerkungen |
|---|---|---|
| **Ganze Seite exportieren** | gewählt | die Seite **mit** Rahmen und Schriftfeld |
| **Nur Bauteile exportieren** | — | nur die Zeichnung, auf ihren Inhalt beschnitten |
| **Raster zeichnen** | aus | |
| **Zeichnungsrahmen zeichnen** | ein | |
| **Schriftfeld zeichnen** | ein | |
| **Anschlüsse zeichnen** | aus | |
| **Klemmenbezeichnungen einzeichnen** | aus | |
| **SVG: transparenter Hintergrund** | aus | nur SVG |
| **Leiterfarben erhalten** | ein | sonst werden Drähte schwarz ausgegeben |
Gemerkt unter `export/default/…`. Der **Zielordner:** ist voreingestellt Ihr
Dokumentenordner — und fällt darauf zurück, wenn der gespeicherte Ordner nicht
mehr existiert.
> **Hilfslinien sind keine Option.** Die Eigenschaft `draw_guides` existiert und
> wird in den Einstellungen gespeichert, aber kein Fenster bietet sie an, und der
> Druckweg erzwingt „aus“. Hilfslinien erscheinen nie in einem Export.
---
## 3. Welcher Weg wofür
| Situation | Weg |
|---|---|
| Einen Plan verschicken | PDF — es behält die anklickbaren Querverweise |
| Eine Seite in ein Dokument oder eine E-Mail | PNG in der gewünschten Größe |
| Eine Zeichnung an ein anderes CAD-Programm | SVG oder DXF |
| Eine Seite fürs Web über farbigem Hintergrund | SVG mit transparentem Hintergrund |
| Denselben Export jede Woche | die Kommandozeile — siehe **[Kommandozeilenreferenz](cli_reference)** |
---
## 4. Gut zu wissen
- **Das Raster des Editors landet nie in der Ausgabe.** Beim Export ist es
vorgabemäßig aus, beim Drucken wird es gar nicht angeboten.
- **„Seite an Seitengröße anpassen“ ist vorgabemäßig ein**, eine gedruckte Seite
wird also skaliert. Für Originalmaßstab ausschalten und mit mehreren Blättern
rechnen.
- **„Nur Bauteile exportieren“ beschneidet auf die Zeichnung** — richtig für eine
Abbildung in einem Dokument, falsch für einen Plan, den jemand allein lesen
muss.
- **Druck- und Bildexporteinstellungen sind getrennt.**
- **Der transparente Hintergrund gilt nur für SVG.**
---
## Siehe auch
- **[Kommandozeilenreferenz](cli_reference)** — dieselben Exporte aus einem Skript
- **[DXF-Import und -Export](dxf)** — zwei unabhängige Funktionen, ein Format
- **[Leiter](conductors-DE)** — die Farben, die diese Exporte berücksichtigen
- **[Benutzerhandbuch](user_manual)** — die Schritt-für-Schritt-Anleitung
+171
@@ -0,0 +1,171 @@
# Vorlagen (das Register „Vorlagen“)
Eine **Vorlage** — im Menü *template*, im Code und auf der Festplatte *Makro*
(`.qetmak`) — ist ein gespeichertes Stück Seite: die Bauteile, die Sie markiert
hatten, mitsamt ihren eigenen Symboldefinitionen in derselben Datei. Sie lässt
sich auf jeder Seite und in jedem Projekt als Block wieder absetzen.
Das ist das richtige Werkzeug für den Verdrahtungsblock, den Sie immer wieder
zeichnen: einen Motorabgang, einen Beleuchtungsstromkreis, eine
Standardeinspeisung. Ein Bauteil ist ein Symbol; eine Vorlage ist eine Anordnung
davon.
> **Eine Vorlage wird ausschließlich per Ziehen und Ablegen abgesetzt.** Ihren
> Namen in der Liste anzuklicken oder doppelt anzuklicken bewirkt gar nichts —
> absichtlich, im Code — und ihr Kontextmenü hat keinen Eintrag zum Einfügen.
> Wenn Sie eine Vorlage ausgewählt und darauf gewartet haben, dass etwas
> geschieht: nichts war kaputt. Ziehen Sie sie auf die Seite. Das ist mit
> Abstand das häufigste Missverständnis zu dieser Funktion.
> **Sprachhinweis.** Auf Deutsch heißen sowohl das Register als auch die
> Sammlung darin **Vorlagen** — im Französischen tragen sie zwei verschiedene
> Namen.
Quellen: `sources/diagramview.cpp`,
`sources/ElementsCollection/elementscollectionwidget.cpp`,
`sources/diagramevent/diagrameventaddmacro.cpp`, `lang/qet_de.ts`.
---
## 1. Eine Vorlage erstellen
1. Markieren Sie auf einer Seite, was erhalten bleiben soll: Bauteile, Leiter,
Texte, Bilder — alles Markierbare geht.
2. **Rechtsklick auf die Auswahl → „Vorlage erstellen“**. Der Eintrag erscheint
nur bei vorhandener Auswahl; ein Rechtsklick ins Leere liefert das Seitenmenü.
3. Das Fenster **„Vorlage speichern“** fragt nach dem Ort. Wählen Sie die
Sammlung im Baum, tragen Sie einen **„Name der neuen Vorlage“** ein und
bestätigen Sie mit **Save**.
4. Eine Meldung nennt den vollständigen Pfad der geschriebenen Datei.
Die Endung `.qetmak` wird angehängt — und im Panel wieder ausgeblendet.
---
## 2. Eine Vorlage absetzen
Öffnen Sie das Register **Vorlagen** des Bauteil-Panels (neben **Sammlungen**)
und **ziehen Sie die Vorlage auf die Seite**.
| Schritt | Was geschieht |
|---|---|
| Sie lassen sie auf der Seite los | eine halbtransparente Vorschau der ganzen Vorlage folgt dem Zeiger, am Raster ausgerichtet |
| **Linksklick** | die Vorlage wird an der Stelle der Vorschau abgesetzt |
| **Rechtsklick** | bricht ab, nichts wird eingefügt |
| **Esc** | bricht ebenfalls ab, und zwar ab dem Loslassen |
Während des Absetzens ist das Kontextmenü der Seite abgeschaltet; deshalb bricht
der Rechtsklick ab, statt ein Menü zu öffnen.
Was eine Vorlage **nicht** absetzt, von Haus aus:
| Aktion | Ergebnis |
|---|---|
| Einfacher Klick auf den Namen | markiert die Zeile, sonst nichts |
| Doppelklick auf den Namen | nichts — der Code steigt sofort aus |
| Kontextmenü der Vorlage | bietet Löschen an, nie Einfügen |
---
## 3. Wo Vorlagen liegen
| | Pfad |
|---|---|
| Standard | *(Anwendungsdatenordner)*`/macros/` |
| Linux | `~/.local/share/QElectroTech/QElectroTech/macros/` |
| Windows | `%APPDATA%\QElectroTech\QElectroTech\macros\` |
| macOS | `~/Library/Application Support/QElectroTech/QElectroTech/macros/` |
Grundlage ist Qts Ort für Anwendungsdaten; eine portable oder gekapselte
Installation (Snap, Flatpak, AppImage mit eigenem Benutzerordner) löst ihn
innerhalb dieser Kapsel auf.
Den Ordner können Sie verlegen — etwa auf eine Netzfreigabe, damit ein Team aus
derselben Bibliothek arbeitet — unter
**[Einstellungen → Allgemein](preferences)**. Existiert der eingestellte Pfad
nicht mehr, fällt QElectroTech auf den Standardordner zurück: Sie sehen eine
leere Liste statt einer Fehlermeldung.
Jede Vorlage ist eine Datei. Eine `.qetmak` in den Ordner zu kopieren lässt sie
erscheinen, sie zu löschen entfernt sie; Unterordner sind möglich.
---
## 4. Was in einer `.qetmak` steht
XML — und die Symboldefinitionen reisen mit. Genau das macht eine Vorlage
zwischen Projekten und Rechnern übertragbar: das empfangende Projekt muss die
Bauteile nicht bereits installiert haben.
```xml
<qet_macro>
<collection>
<element path="import/lampe_pe.elmt">
<definition height="50" hotspot_x="15" hotspot_y="25" ...>
...die vollständige Symbolzeichnung...
</definition>
</element>
</collection>
<diagram_content>
<diagram projectId="0" ...>
<elements>
...was Sie markiert hatten...
</elements>
</diagram>
</diagram_content>
</qet_macro>
```
| Teil | Inhalt |
|---|---|
| `<collection>` | ein `<element>` je **verschiedenem** Symbol, mit vollständiger Definition — eine Vorlage mit sechs gleichen Relais speichert das Relais einmal |
| `<diagram_content>` | der markierte Inhalt selbst, als Seitenfragment |
| die `type`-Attribute | zu `macro://…` umgeschrieben, damit die abgesetzten Objekte auf die mitgelieferten Definitionen zeigen |
Eine Vorlage mit einer einzigen Lampe ist rund 3 kB groß, fast ausschließlich
Symboldefinition.
---
## 5. Grenzen
- **Ziehen und Ablegen ist der einzige Weg.** Kein Menüeintrag, keine
Tastenkombination, kein Doppelklick —
[Issue #931](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/931).
- **Vorlagen lassen sich nicht an Ort und Stelle bearbeiten.** Neu erstellen aus
einer korrigierten Auswahl.
- **Keine Miniaturansicht im Panel** — Vorlagen stehen nur mit Namen da, der
Name ist also der einzige Hinweis auf den Inhalt —
[Issue #932](https://github.com/qelectrotech/qelectrotech-source-mirror/issues/932).
- Bei Entwicklungsversionen **vor dem 13. September 2026** bewirkt das Ziehen
einer Vorlage unter Qt 6 nichts; behoben durch
[PR #853](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/853).
Aktualisieren, bevor Sie die Funktion für defekt halten.
---
## 6. Wenn etwas nicht klappt
**„Ich wähle meine Vorlage aus und es landet nichts auf der Seite.“**
So ist es vorgesehen: Auswählen tut nichts. Ziehen Sie sie auf die Seite.
**„Ich habe gezogen und es passiert trotzdem nichts.“**
Prüfen Sie das Versionsdatum — siehe den Qt-6-Hinweis oben. Prüfen Sie dann, ob
Sie innerhalb der Zeichenfläche losgelassen haben und nicht im grauen Rand.
**„Die Vorschau klebt am Zeiger.“**
Ein Absetzen läuft: Linksklick setzt ab, Esc oder Rechtsklick bricht ab.
**„Meine Vorlagen sind verschwunden.“**
Der Vorlagenordner ist unter Einstellungen → Allgemein einstellbar. Zeigt er auf
ein nicht eingehängtes Laufwerk, erscheint die Sammlung leer. Pfad prüfen oder
die `.qetmak`-Dateien in den Standardordner kopieren.
---
## Siehe auch
- **[Sammlungen verwalten](collection_browser)** — das Panel mit dem Register
- **[Den Bauteil-Editor benutzen](element_editor)** — für die Symbole, aus denen
eine Vorlage zusammengesetzt wird
- **[Einstellungen](preferences)** — wo der Vorlagenordner festgelegt wird