Add User Manual translations for French and German

- user_manual-FR.md: Complete French translation of User Manual (646 lines) covering all topics from basics through advanced features, keyboard shortcuts, and troubleshooting
- user_manual-DE.md: Complete German translation of User Manual with same comprehensive coverage as English original
- languages.md: Updated translation status matrix showing User Manual now complete in all three languages (English, Français, Deutsch)

Expands multi-language onboarding tier to 4 complete pages (Home, Quick Start, Downloads, FAQ, User Manual) in all three languages.
ispyisail
2026-09-09 15:49:17 +12:00
parent 43cdce921e
commit 0dcaba5602
3 changed files with 1303 additions and 3 deletions
+3 -3
@@ -22,7 +22,7 @@ Commencez par la version française de ce wiki :
- **[Guide de Démarrage Rapide](quick_start_guide-FR)** — Commencez en 10 minutes
- **[Toutes les Pages](Home-FR)** — Voir toute la documentation
**Remarque:** Nous avons actuellement traduit les pages principales. Les autres pages sont disponibles en anglais. Nous travaillons à l'expansion des traductions françaises !
**Remarque:** Nous avons traduit les pages principales d'onboarding. Les autres pages sont disponibles en anglais. Nous travaillons à l'expansion des traductions françaises !
---
@@ -34,7 +34,7 @@ Beginnen Sie mit der deutschen Version dieses Wikis:
- **[Schnellstartanleitung](quick_start_guide-DE)** — Erste Schritte auf Deutsch
- **[Alle Seiten](Home-DE)** — Zur vollständigen Dokumentation
**Hinweis:** Wir haben derzeit die Hauptseiten übersetzt. Weitere Seiten sind auf Englisch verfügbar. Wir arbeiten an der Erweiterung der deutschen Übersetzungen!
**Hinweis:** Wir haben die Hauptseiten zum Onboarding übersetzt. Weitere Seiten sind auf Englisch verfügbar. Wir arbeiten an der Erweiterung der deutschen Übersetzungen!
---
@@ -46,7 +46,7 @@ Beginnen Sie mit der deutschen Version dieses Wikis:
| Quick Start Guide | ✅ | ✅ | ✅ |
| Downloads | ✅ | ✅ | ✅ |
| FAQ | ✅ | ✅ | ✅ |
| User Manual | ✅ | 📋 | 📋 |
| User Manual | ✅ | | |
| Features | ✅ | 📋 | 📋 |
| Community | ✅ | 📋 | 📋 |
| Tips & Tricks | ✅ | 📋 | 📋 |
+649
@@ -0,0 +1,649 @@
# Benutzerhandbuch
Komplette Referenzbeschreibung für die Verwendung von QElectroTech zum Erstellen von Stromlaufplänen, Schaltplänen und Automatisierungszeichnungen.
## Inhaltsverzeichnis
1. [Grundlagen](#grundlagen)
2. [Benutzeroberfläche](#benutzeroberfläche)
3. [Projekte und Folios](#projekte-und-folios)
4. [Mit Elementen arbeiten](#mit-elementen-arbeiten)
5. [Drähte und Leiter zeichnen](#drähte-und-leiter-zeichnen)
6. [Text, Beschriftungen und Anmerkungen](#text-beschriftungen-und-anmerkungen)
7. [Schema-Bearbeitung und Formatierung](#schema-bearbeitung-und-formatierung)
8. [Berichte und Dokumentation](#berichte-und-dokumentation)
9. [Export und Druck](#export-und-druck)
10. [Einstellungen und Voreinstellungen](#einstellungen-und-voreinstellungen)
11. [Fortgeschrittene Themen](#fortgeschrittene-themen)
12. [Fehlerbehebung](#fehlerbehebung)
---
## Grundlagen
### QElectroTech starten
**Linux/macOS/Windows:**
- Doppelklicken Sie auf die QElectroTech-Anwendung
- Oder starten Sie vom Terminal: `qelectrotech`
**Plattformspezifisch:**
- **Linux:** Auch über Paketmanager verfügbar (`apt install qelectrotech`)
- **macOS:** Ziehen Sie die Anwendung vom Anwendungsordner zum Dock für schnellen Zugriff
- **Windows:** Heften Sie ans Startmenü oder Desktop an für schnellen Start
### Anwendung beenden
- **Datei → Beenden** (oder Datei → Beenden)
- Schließen Sie das Hauptfenster
- Speichern Sie Ihre Projekte vor dem Beenden
### Hilfe in QET erhalten
- **Hilfe → Handbuch** — Öffnet das offizielle PDF-Handbuch
- **Hilfe → Über** — Zeigt Version und Credits
- Rechtsklick auf Elemente für Kontexthilfe
---
## Benutzeroberfläche
### Hauptarbeitsbereich
```
┌─────────────────────────────────────────────────────────┐
│ Menüleiste (Datei, Bearbeitung, Ansicht, Einfügen, Werkzeuge, Hilfe) │
├─────────────────────────────────────────────────────────┤
│ Symbolleiste (Auswahl, Draht, Text, Formen, etc.) │
├─────────┬─────────────────────────────┬─────────────────┤
│ Projekt │ │ Elementenpanel │
│ Panel │ DIAGRAMM-LEINWAND │ (Suche & Durchsuchen)
│ │ (Ihr Zeichenbereich) │ │
│ (Folios)│ │ Eigenschaften │
│ │ │ (Markiertes Element)│
├─────────┴─────────────────────────────┴─────────────────┤
│ Statusleiste (Koordinaten, Zoom, Aktueller Modus) │
└─────────────────────────────────────────────────────────┘
```
### Wichtigste Panels
**Elementenpanel (rechte Seite)**
- Suchfeld zum Suchen von Komponenten
- Kategorien zum Durchsuchen
- Ziehen Sie Elemente auf die Leinwand
- Zeigt "Master"-Elemente und Verbindungsinformationen
**Projektpanel (linke Seite)**
- Listet alle Folios (Seiten) in Ihrem Projekt auf
- Neue Folios hinzufügen (Diagramme)
- Folios organisieren und umbenennen
- Rechtsklick für Folio-Eigenschaften
**Symbolleiste**
- **Auswahlwerkzeug** — Objekte auswählen und verschieben
- **Draht-Werkzeug** — Elektrische Verbindungen zeichnen
- **Text-Werkzeug** — Beschriftungen und Anmerkungen hinzufügen
- **Form-Werkzeuge** — Rechtecke, Kreise, Polygone hinzufügen
- **Zoom-Steuerelemente** — Ansicht vergrößern/verkleinern
**Einstellungspanel (Windows-Menü)**
- Seitenpanels anzeigen/verbergen nach Bedarf
- Arbeitsbereich-Layout anpassen
- Benutzerdefinierte Arbeitsbereiche speichern
### Arbeitsbereich anpassen
- **Ansicht → Panels** — Seitenpanels anzeigen/verbergen
- **Ansicht → Symbolleisten** — Symbolleisten anzeigen/verbergen
- Ziehen Sie Panels zum Umpositionieren
- Doppelklicken Sie auf Panel-Tabs zum Dockeln/Abdockeln
---
## Projekte und Folios
### Neues Projekt erstellen
1. **Datei → Neues Projekt**
2. **Projekteinstellungen:**
- **Seitengröße:** Wählen Sie A4, A3, Letter, Legal oder Benutzer definiert
- **Ausrichtung:** Hochformat oder Querformat
- **Randeinstellungen** (falls nötig)
3. Klicken Sie auf **OK**
4. Ihr leeres Projekt ist bereit
### Folios verstehen
Ein **Folio** ist eine einzelne Seite/ein Diagramm in Ihrem Projekt.
**Folio-Typen:**
- **Einschaltliniendarstellung** — Vereinfachte Darstellung (am häufigsten)
- **Mehrschaltliniendarstellung** — Detaillierte Verbindungsdetails
- **Steuerdiagramm** — Logik- und Steuerschaltungen
Neues Folio erstellen:
- Rechtsklick im Projektpanel → **Neues Folio**
- Wählen Sie Folio-Typ
- Legen Sie Titel und Eigenschaften fest
### Ihr Projekt organisieren
- **Folios umbenennen:** Rechtsklick auf Folio → **Umbenennen**
- **Folios neu ordnen:** Ziehen und ablegen im Projektpanel
- **Folios löschen:** Rechtsklick → **Löschen** (bestätigen)
- **Folio-Eigenschaften:** Rechtsklick → **Eigenschaften**
- Titelblöcke-Informationen
- Maßstab und Druckeinstellungen
- Autor und Datum
### Projekte öffnen und speichern
**Öffnen:**
- **Datei → Zuletzt geöffnet** — Schneller Zugriff auf zuletzt verwendete Projekte
- **Datei → Öffnen** — Nach .qet-Dateien durchsuchen
- **Strg+O** (oder Cmd+O) — Tastaturkürzel
**Speichern:**
- **Datei → Speichern** — Aktuelles Projekt speichern (Strg+S)
- **Datei → Speichern unter** — Mit neuem Namen speichern
- **Automatisches Speichern** — In Einstellungen konfigurieren
**Dateiformat:**
- QElectroTech-Projekte werden als `.qet`-Dateien gespeichert
- XML-basiertes Format, menschenleserlich
- Kann bei Bedarf in Texteditor geöffnet werden
---
## Mit Elementen arbeiten
### Elemente finden
**Suchmethode:**
1. Geben Sie im **Suchfeld** oben im Elementenpanel ein
2. Ergebnisse erscheinen sofort während Sie tippen
3. Klicken Sie auf Element zum Auswählen für Platzierung
**Nach Kategorie durchsuchen:**
1. Erweitern Sie Kategorien im Elementenpanel
2. Kategorien organisiert nach Typ (Schalter, Relais, etc.)
3. Unterkategorien für spezifische Komponentenfamilien
**Häufige Kategorien:**
- 01_Misc — Verschiedene Symbole
- 03_Control — Steuergeräte und Logik
- 04_Energy — Stromerzeugung und -verteilung
- 10_Electrical — Standardelektrische Komponenten
### Elemente platzieren
**Drag & Drop:**
1. Klicken und halten Sie ein Element im Elementenpanel
2. Ziehen Sie auf Ihre Leinwand
3. Loslassen zum Platzieren
4. Element erscheint an Cursor-Position
**Mehrfachplatzierung:**
- Nicht im Elementenpanel loslassen, einfach mehrfach auf die Leinwand klicken
- Bequem zum Hinzufügen vieler gleicher Elemente
**Intelligente Drehung:**
- Element in ungefährer Winkelung platzieren
- Rechtsklick → **90° drehen** zum Anpassen
- Oder wählen Sie Element und drücken Sie **R**
### Elemente auswählen
**Einzelauswahl:**
- Klicken Sie auf Element mit Auswahlwerkzeug
**Mehrfachauswahl:**
- Halten Sie **Strg** (oder Cmd auf Mac) und klicken Sie auf Elemente
- Oder ziehen Sie ein Auswahlrechteck um mehrere Elemente
**Alle auswählen:**
- **Bearbeitung → Alles auswählen** (Strg+A)
- Oder verwenden Sie **Strg+A**
### Elemente verschieben und positionieren
**Verschieben:**
1. Klicken Sie auf Element zum Auswählen (Griffe erscheinen)
2. Ziehen Sie an neue Position
3. Halten Sie **Umschalt** um auf horizontal/vertikal beschränkt zu bleiben
**Präzisionspositionierung:**
- Verwenden Sie **Pfeiltasten** um markierte Elemente zu schieben
- Halten Sie **Umschalt** für größere Sprünge
**An Raster einrasten:**
- Elemente rasten standardmäßig an Raster ein
- Rastereinrasten umschalten: **Ansicht → An Raster einrasten**
- Rastergröße anpassen: **Einstellungen → Raster**
### Elemente duplizieren
**Kopieren und Einfügen:**
1. Wählen Sie Element(e) aus
2. **Strg+C** zum Kopieren
3. **Strg+V** zum Einfügen (wird versetzt vom Original angezeigt)
4. Ziehen Sie an endgültige Position
**Schnelles Duplizieren:**
1. Wählen Sie Element aus
2. **Bearbeitung → Duplizieren**
3. Neue Kopie erscheint in der Nähe
### Drehen und Spiegeln
**Drehen:**
- Wählen Sie Element aus
- Rechtsklick → **90° drehen**
- Oder drücken Sie **R** und klicken zum Drehen
**Spiegeln:**
- Rechtsklick → **Horizontal spiegeln** oder **Vertikal spiegeln**
- Oder verwenden Sie **H** oder **V** Tastaturkürzel
### Gruppieren und Sperren
**Position sperren:**
- Wählen Sie Element aus
- Rechtsklick → **Position sperren** (verhindert versehentliches Verschieben)
- Entsperren auf gleiche Weise zum Zulassen von Bewegung
**Erscheinungsbild sperren:**
- Text, Stil oder Verbindungen sperren
- Rechtsklick → **Eigenschaften** für Sperroptionen
### Elemente löschen
- Wählen Sie Element(e) aus
- Drücken Sie **Entfernen** Taste
- Oder Rechtsklick → **Löschen**
- Verwenden Sie **Strg+Z** um Löschen rückgängig zu machen
---
## Drähte und Leiter zeichnen
### Leiter verstehen
Ein **Leiter** ist eine elektrische Verbindung zwischen Elementen (Drähte/Leitungen).
**Typen:**
- **Einleiter** — Vereinfachte Darstellung
- **Mehrleiter** — Einzelne Leiterleitungen angezeigt
### Drähte zeichnen
**Basis-Drahtzeichnung:**
1. Klicken Sie auf das **Draht-Werkzeug** (Blitz-Symbol)
2. Klicken Sie auf einen **Anschluss** (Verbindungspunkt auf Element)
3. Bewegen Sie die Maus zum Zielanschluss
4. Klicken Sie zum Fertigstellen des Drahtes
5. Draht wird gezeichnet, automatisch geroutet
**Mehrschicht-Drähte:**
1. Klicken Sie auf ersten Anschluss (Startpunkt)
2. Klicken Sie auf Zwischenpunkte zum Routing
3. Klicken Sie auf finalen Anschluss (Endpunkt)
4. Drücken Sie **Escape** zum Beenden
**Draht-Routing:**
- Automatisches Routing erstellt typischerweise orthogonale (rechtwinklige) Pfade
- Klicken Sie auf Wegpunkte um Pfad zu kontrollieren
- Drücken Sie **Escape** um Draht abzubrechen
### Drähte bearbeiten
**Draht-Pfad ändern:**
1. Wählen Sie Draht aus (klicken Sie darauf)
2. Ziehen Sie Wegpunkte um Routing anzupassen
3. Rechtsklick auf Wegpunkt um ihn zu entfernen
**Draht löschen:**
- Wählen Sie Draht aus
- Drücken Sie **Entfernen**
**Draht teilen:**
- Klicken Sie mit Draht-Werkzeug auf Draht um Verbindungspunkt hinzuzufügen
- Platzieren Sie Element auf Draht um ihn automatisch zu teilen
**Drähte verbinden:**
- Drähte, die sich am Anschluss verbinden, verbinden sich automatisch
- Keine manuelle Verbindung nötig
### Draht-Eigenschaften
**Draht-Erscheinungsbild ändern:**
1. Rechtsklick auf Draht
2. Wählen Sie **Eigenschaften**
3. **Ändern Sie:**
- Farbe (aus Farbpalette)
- Stil (durchgezogen, gestrichelt, gepunktet)
- Dicke (Linienbreite)
**Leiter-Eigenschaften:**
1. Rechtsklick auf Draht
2. Wählen Sie **Leiter-Eigenschaften**
3. **Legen Sie fest:**
- Leitertyp (Phase, Neutralleiter, Masse, etc.)
- Elektrische Eigenschaften
- Nummerierungsschema
---
## Text, Beschriftungen und Anmerkungen
### Textbeschriftungen hinzufügen
**Text-Werkzeug Methode:**
1. Klicken Sie auf **Text-Werkzeug** (A-Symbol) in der Symbolleiste
2. Klicken Sie auf Leinwand wo Sie Text wünschen
3. Geben Sie Ihren Text ein
4. Klicken Sie anderswo um fertig zu werden
**Schnellbeschriftung auf Elementen/Drähten:**
1. Doppelklicken Sie auf Element oder Draht
2. Geben Sie Text ein (z.B. "S1" für Schalter 1)
3. Drücken Sie **Eingabe**
4. Beschriftung erscheint auf Objekt
### Drähte beschriften
Häufige Drahtbeschriftungen:
- **Signalnamen:** "L1", "L2", "N", "PE" (Masse)
- **Spannung:** "24V AC", "12V DC"
- **Funktion:** "Aktivieren", "Zurücksetzen", "Alarm"
Drahtbeschriftung hinzufügen:
1. Doppelklicken Sie auf Draht
2. Geben Sie Beschriftungstext ein
3. Drücken Sie **Eingabe**
### Elemente beschriften
Häufige Element-Beschriftungen:
- **Referenzbenennung:** "S1" (Schalter 1), "R1" (Relais 1), "M1" (Motor 1)
- **Komponentenwert:** "100kΩ", "10µF"
- **Beschreibung:** "Stromschalter", "Startknopf"
Element beschriften:
1. Doppelklicken Sie auf Element
2. Geben Sie Referenz ein (z.B. "Q1")
3. Drücken Sie **Eingabe**
### Dynamische Textfelder
Verwenden Sie Variablen, die automatisch gefüllt werden:
- **%id** — Element-ID/Referenznummer
- **%label** — Element-Beschriftung
- **%comment** — Kommentar-Text
- **%author** — Projektautor
- **%date** — Aktuelles Datum
- **%filename** — Projektdateiname
Beispiel: Fügen Sie Text "%date" hinzu und es wird automatisch das heutige Datum angezeigt.
### Textformatierung
**Schrift und Stil:**
1. Wählen Sie Textelement aus
2. Rechtsklick → **Eigenschaften**
3. **Konfigurieren Sie:**
- Schriftfamilie (Arial, Times, etc.)
- Größe (Punkte)
- Farbe
- Ausrichtung (horizontal, vertikal, 45°, etc.)
---
## Schema-Bearbeitung und Formatierung
### Auswahl und Organisation
**Alle Objekte auswählen:**
- **Bearbeitung → Alles auswählen** (Strg+A)
**Nach Typ auswählen:**
- **Bearbeitung → Auswählen** (Untermenü zum Auswählen spezifischer Typen)
**Mehrfach-Auswahl-Tipps:**
- Halten Sie **Strg** und klicken um zur Auswahl hinzuzufügen
- Umschalt+Klick um Bereich auszuwählen
- Ziehen Sie Feld um alle darin auszuwählen
### Ausrichtung und Verteilung
**Objekte ausrichten:**
1. Wählen Sie mehrere Objekte aus
2. Rechtsklick → **Ausrichten**
3. Wählen Sie: Links, Rechts, Oben, Unten, Mitte
**Abstände verteilen:**
1. Wählen Sie Objekte aus (3 oder mehr)
2. Rechtsklick → **Verteilen**
3. Gleichmäßig horizontal oder vertikal abstande
### Raster- und Einrastfunktionen
**Rastereinstellungen:**
- **Ansicht → An Raster einrasten** — Einrasten an/aus umschalten
- **Einstellungen → Raster** — Rastergröße anpassen
- Kleineres Raster = feinere Positionierung; größer = schnellere Platzierung
**Ausrichtungs-Tipps:**
- Einrasten für ordentliche, ausgerichtete Diagramme
- Deaktivieren für freie Platzierung
- Mit Tastaturkürzel umschalten
### Rückgängig und Wiederherstellen
**Rückgängig:**
- **Strg+Z** (oder Cmd+Z auf Mac)
- **Bearbeitung → Rückgängig** aus Menü
- Mehrere Schritte wiederholt rückgängig machen
**Wiederherstellen:**
- **Strg+Y** (oder Cmd+Umschalt+Z auf Mac)
- **Bearbeitung → Wiederherstellen** aus Menü
- Mehrere Schritte wiederholt wiederherstellen
### Zoom und Schwenken
**Zoom-Methoden:**
- **Scroll-Rad:** Oben zum Vergrößern, unten zum Verkleinern
- **+/-** Tasten: Vergrößern oder verkleinern
- **Strg+Scroll:** Feinkontroll Zoom
- **Ansicht → Zoom → An Seite anpassen:** Diagramm automatisch anpassen
**Schwenken (Ansicht verschieben):**
- **Mittlere Maustaste:** Klicken und ziehen zum Schwenken
- **Leertaste + Ziehen:** Leertaste halten und ziehen zum Schwenken
- **Pfeiltasten:** Ansicht schieben (wenn nichts ausgewählt)
---
## Berichte und Dokumentation
### Berichte generieren
Berichte erstellen automatisch Dokumentation aus Ihrem Schema:
**Verfügbare Berichte:**
1. **Nomenklatur** — Liste aller Elemente mit Referenznummern
2. **Leiter-Liste** — Alle Drähte mit Verbindungen und Eigenschaften
3. **Ein-/Ausgabe-Dokumentation** — Zusammenfassung von Ein- und Ausgängen
**Bericht erstellen:**
1. **Projekt → Berichte**
2. Wählen Sie Berichtstyp
3. **Konfigurieren Sie Optionen** (was einzubeziehen ist)
4. Generieren (exportiert in Datei)
---
## Export und Druck
### Diagramme drucken
**Druckvorschau:**
1. **Datei → Druckvorschau**
2. Sehen Sie wie Diagramm gedruckt wird
3. Passen Sie Einstellungen an falls nötig
**Druckeinstellungen:**
1. **Datei → Drucken**
2. **Konfigurieren Sie:**
- Seitengröße und Ausrichtung
- Farbe oder Schwarzweiß
- Maßstab (an Seite anpassen, tatsächliche Größe, etc.)
3. Drucken Sie auf Drucker oder PDF
### Diagramme exportieren
**Export-Formate:**
- **PDF** — Professionelle Dokumente, beste zum Teilen
- **PNG** — Rasterbild, gut für Web
- **SVG** — Vektorformat, editierbar in anderer Software
- **DXF** — CAD-Format für Zusammenarbeit
**Export-Prozess:**
1. Wählen Sie Folio(s) zum Exportieren
2. **Datei → Exportieren**
3. Wählen Sie Format und Speicherort
4. Konfigurieren Sie Export-Optionen
5. Klicken Sie auf **Exportieren**
---
## Einstellungen und Voreinstellungen
### Anzeige und Erscheinungsbild
**Einstellungen → Anzeige:**
- Sprachauswahl
- Design (hell/dunkel)
- Schriftgröße und Rendering
- Farbschema
### Projekteinstellungen
**Einstellungen → Projekte:**
- Standardseitengröße
- Randeinstellungen
- Standardleiter
- Auto-Nummerierungsregeln
### Raster und Einrasten
**Einstellungen → Raster:**
- Rastergröße
- Raster anzeigen/verbergen
- Einrast-Abstand
- Rasterlinienstil
---
## Fortgeschrittene Themen
### Benutzerdefinierte Elemente erstellen
Siehe **[Elemente erstellen](elements_XML)** für detaillierte Anweisungen zu:
- Entwerfen von Element-Grafiken
- Definieren von Verbindungsanschlüssen
- Erstellen von Element-Metadaten
- Verpacken zur Verteilung
### Element-Sammlungen und Bibliotheken
- Benutzerdefinierte Elemente organisieren
- Private Bibliotheken erstellen
- Mit Team oder Gemeinschaft teilen
- Zugriff auf Community-Element-Repository
### Multi-Benutzer-Workflows
- .qet-Dateien auf gemeinsamen Speicher speichern (Netzwerk-Laufwerk)
- Versionskontrolle (Git) für Diagramme verwenden
- Mit Team-Mitgliedern zusammenarbeiten
- Änderungen zusammenführen bei paralleler Arbeit
### Scripting und Automatisierung
*Informationen zu Python-Scripting-Unterstützung (wenn vollständig dokumentiert)*
---
## Fehlerbehebung
### Häufige Probleme
**"Element verbindet sich nicht mit Draht"**
- Klicken Sie direkt auf Anschluss (kleiner Punkt)
- Nicht alle Punkte auf Element sind verbindbar
- Überprüfen Sie Element-Eigenschaften für Anschluss-Definitionen
**"Drähte kreuzen sich ohne Verbindung"**
- Drähte verbinden sich nur an Anschlüssen
- Sich kreuzende Linien verbinden sich nicht automatisch
- Verwenden Sie explizite Verbindung an Anschluss-Punkten
**"Diagramm ist langsam/Verzögerung"**
- Große Projekte mit vielen Elementen verlangsamen die Reaktionsfähigkeit
- Reduzieren Sie Zoom-Stufe um Leistung zu verbessern
- Deaktivieren Sie Rasteranzeige falls nicht nötig
- Schließen Sie unnötige Panels
**"Datei lässt sich nicht öffnen"**
- Beschädigte Datei oder Kompatibilitätsproblem
- Versuchen Sie in Texteditor zu öffnen um XML-Gültigkeit zu überprüfen
- Wiederherstellen aus Sicherung falls verfügbar
---
## Tastaturkürzel
| Aktion | Windows/Linux | macOS |
|--------|---|---|
| Neu | Strg+N | Cmd+N |
| Öffnen | Strg+O | Cmd+O |
| Speichern | Strg+S | Cmd+S |
| Drucken | Strg+P | Cmd+P |
| Rückgängig | Strg+Z | Cmd+Z |
| Wiederherstellen | Strg+Y | Cmd+Umschalt+Z |
| Alles auswählen | Strg+A | Cmd+A |
| Kopieren | Strg+C | Cmd+C |
| Einfügen | Strg+V | Cmd+V |
| Löschen | Entfernen | Entfernen |
| Drehen | R | R |
| Vergrößern | + | + |
| Verkleinern | - | - |
| An Seite anpassen | Strg+0 | Cmd+0 |
---
## Weitere Ressourcen
- **[Schnellstartanleitung](quick_start_guide-DE)** — Erste Schritte
- **[Tipps und Tricks](tips_and_tricks)** — Fortgeschrittene Workflows
- **[Häufig gestellte Fragen](faq-DE)** — Häufige Fragen
- **[Offizielles Handbuch](https://qelectrotech.github.io/qelectrotech-doc/)** — Vollständige Dokumentation
- **[Forum](https://forum.qelectrotech.org/)** — Gemeinschaftshilfe
---
## Hilfe erhalten
- **[Häufig gestellte Fragen](faq-DE)** — Schnelle Antworten
- **[Forum](https://forum.qelectrotech.org/)** — Fragen Sie die Gemeinschaft (sehr aktiv!)
- **[Probleme](https://github.com/qelectrotech/qelectrotech-source-mirror/issues)** — Fehler melden
- **[Elemente erstellen](elements_XML)** — Benutzerdefinierte Komponenten erstellen
---
**[🌐 Sprache wählen](languages)** — English · Français · Deutsch
+651
@@ -0,0 +1,651 @@
# Manuel Utilisateur
Guide de référence complet pour utiliser QElectroTech afin de créer des schémas électriques, des plans d'exécution et des dessins d'automatisation.
## Table des Matières
1. [Principes de Base](#principes-de-base)
2. [Aperçu de l'Interface](#aperçu-de-linterface)
3. [Projets et Folios](#projets-et-folios)
4. [Travailler avec les Éléments](#travailler-avec-les-éléments)
5. [Dessiner les Fils et les Conducteurs](#dessiner-les-fils-et-les-conducteurs)
6. [Texte, Étiquettes et Annotations](#texte-étiquettes-et-annotations)
7. [Édition et Formatage du Schéma](#édition-et-formatage-du-schéma)
8. [Rapports et Documentation](#rapports-et-documentation)
9. [Exportation et Impression](#exportation-et-impression)
10. [Préférences et Paramètres](#préférences-et-paramètres)
11. [Sujets Avancés](#sujets-avancés)
12. [Dépannage](#dépannage)
---
## Principes de Base
### Lancer QElectroTech
**Linux/macOS/Windows :**
- Double-cliquez sur l'application QElectroTech
- Ou lancez depuis le terminal : `qelectrotech`
**Spécifique à la Plateforme :**
- **Linux :** Également disponible via gestionnaire de paquets (`apt install qelectrotech`)
- **macOS :** Faites glisser depuis Applications vers Dock pour un accès facile
- **Windows :** Épinglez au Menu Démarrer ou au Bureau pour un lancement rapide
### Quitter l'Application
- **Fichier → Quitter** (ou Fichier → Fermer)
- Fermez la fenêtre principale
- Enregistrez vos projets avant de quitter
### Obtenir de l'Aide dans QET
- **Aide → Manuel** — Ouvre le manuel PDF officiel
- **Aide → À propos** — Affiche la version et les crédits
- Clic droit sur les éléments pour l'aide contextuelle
---
## Aperçu de l'Interface
### Espace de Travail Principal
```
┌─────────────────────────────────────────────────────────┐
│ Barre de Menu (Fichier, Édition, Affichage, Insertion, Outils, Aide) │
├─────────────────────────────────────────────────────────┤
│ Barre d'Outils (Sélection, Fil, Texte, Formes, etc.) │
├─────────┬─────────────────────────────┬─────────────────┤
│ Projet │ │ Panneau │
│ Panel │ CANEVAS DE DIAGRAMME │ Éléments │
│ │ (Votre zone de dessin) │ (Recherche & │
│ (Folios)│ │ Parcourir) │
│ │ │ Propriétés │
│ │ │ (Élément │
│ │ │ sélectionné) │
├─────────┴─────────────────────────────┴─────────────────┤
│ Barre de Statut (Coordonnées, Zoom, Mode Actuel) │
└─────────────────────────────────────────────────────────┘
```
### Panneaux Clés
**Panneau Éléments (Côté Droit)**
- Boîte de recherche pour trouver des composants
- Catégories pour parcourir
- Faites glisser les éléments sur le canevas
- Affiche les informations sur les éléments « Master » et les connexions
**Panneau Projet (Côté Gauche)**
- Liste tous les folios (pages) dans votre projet
- Ajouter de nouveaux folios (diagrammes)
- Organiser et renommer les folios
- Clic droit pour les propriétés du folio
**Barre d'Outils**
- **Outil Sélection** — Sélectionner et déplacer les objets
- **Outil Fil** — Dessiner les connexions électriques
- **Outil Texte** — Ajouter des étiquettes et des annotations
- **Outils de Formes** — Ajouter des rectangles, cercles, polygones
- **Contrôles de Zoom** — Agrandir/réduire la vue
**Panneau Préférences (Menu Fenêtres)**
- Afficher/masquer les panneaux latéraux selon les besoins
- Personnaliser la disposition de l'espace de travail
- Enregistrer les espaces de travail personnalisés
### Personnaliser Votre Espace de Travail
- **Affichage → Panneaux** — Afficher/masquer les panneaux latéraux
- **Affichage → Barres d'Outils** — Afficher/masquer les barres d'outils
- Faites glisser les panneaux pour les repositionner
- Double-cliquez sur les onglets du panneau pour flotter/ancrer
---
## Projets et Folios
### Créer un Nouveau Projet
1. **Fichier → Nouveau Projet**
2. **Paramètres du Projet :**
- **Taille de Page :** Choisissez A4, A3, Lettre, Légal ou Personnalisé
- **Orientation :** Portrait ou Paysage
- **Paramètres de Marge** (si nécessaire)
3. Cliquez sur **OK**
4. Votre projet vierge est prêt
### Comprendre les Folios
Un **folio** est une seule page/un seul diagramme dans votre projet.
**Types de Folios :**
- **Diagramme unifilaire** — Représentation simplifiée (plus courant)
- **Diagramme multifilaire** — Détails de connexion détaillés
- **Diagramme de Contrôle** — Circuits logiques et de contrôle
Pour créer un nouveau folio :
- Clic droit dans le Panneau Projet → **Nouveau Folio**
- Choisissez le type de folio
- Définissez le titre et les propriétés
### Organiser Votre Projet
- **Renommer les folios :** Clic droit sur folio → **Renommer**
- **Réorganiser les folios :** Faites glisser et déposez dans le Panneau Projet
- **Supprimer les folios :** Clic droit → **Supprimer** (confirmer)
- **Propriétés du folio :** Clic droit → **Propriétés**
- Informations sur les blocs de titre
- Paramètres d'échelle et d'impression
- Auteur et date
### Ouvrir et Enregistrer les Projets
**Ouverture :**
- **Fichier → Récent** — Accès rapide aux projets récents
- **Fichier → Ouvrir** — Parcourir les fichiers .qet
- **Ctrl+O** (ou Cmd+O) — Raccourci clavier
**Enregistrement :**
- **Fichier → Enregistrer** — Enregistrer le projet actuel (Ctrl+S)
- **Fichier → Enregistrer Sous** — Enregistrer avec un nouveau nom
- **Auto-sauvegarde** — Configurer dans Préférences
**Format de Fichier :**
- Les projets QElectroTech sont enregistrés en tant que fichiers `.qet`
- Format basé sur XML, lisible par l'homme
- Peut être ouvert dans un éditeur de texte si nécessaire
---
## Travailler avec les Éléments
### Trouver des Éléments
**Méthode de Recherche :**
1. Tapez dans la **boîte de recherche** en haut du Panneau Éléments
2. Les résultats apparaissent instantanément au fur et à mesure que vous tapez
3. Cliquez sur l'élément pour le sélectionner pour le placement
**Parcourir par Catégorie :**
1. Développez les catégories dans le Panneau Éléments
2. Catégories organisées par type électrique (interrupteurs, relais, etc.)
3. Sous-catégories pour les familles de composants spécifiques
**Catégories Courantes :**
- 01_Misc — Symboles divers
- 03_Control — Dispositifs de contrôle et logique
- 04_Energy — Génération et distribution d'énergie
- 10_Electrical — Composants électriques standard
### Placer les Éléments
**Glisser-Déposer :**
1. Cliquez et maintenez un élément dans le Panneau Éléments
2. Faites-le glisser sur votre canevas
3. Relâchez pour placer
4. L'élément apparaît à la position du curseur
**Placements Multiples :**
- Ne relâchez pas dans le Panneau Éléments, cliquez simplement plusieurs fois sur le canevas
- Pratique pour ajouter de nombreux éléments identiques
**Rotation Intelligente :**
- Placer l'élément à un angle approximatif
- Clic droit → **Rotation 90°** pour ajuster
- Ou sélectionnez l'élément et appuyez sur **R**
### Sélectionner les Éléments
**Sélection Unique :**
- Cliquez sur l'élément avec l'outil Sélection
**Multi-Sélection :**
- Maintenez **Ctrl** (ou Cmd sur Mac) et cliquez sur les éléments
- Ou faites glisser une boîte de sélection autour de plusieurs éléments
**Sélectionner Tout :**
- **Édition → Tout Sélectionner** (Ctrl+A)
- Ou utilisez **Ctrl+A**
### Déplacer et Positionner les Éléments
**Déplacer :**
1. Cliquez sur l'élément pour le sélectionner (les poignées apparaissent)
2. Faites-le glisser vers la nouvelle position
3. Maintenez **Maj** pour être limité à horizontal/vertical
**Positionnement Précis :**
- Utilisez les **touches fléchées** pour décaler les éléments sélectionnés
- Maintenez **Maj** pour des sauts plus importants
**Accrochage à la Grille :**
- Les éléments s'accrochent à la grille par défaut
- Basculer l'accrochage à la grille : **Affichage → Accrochage à la Grille**
- Ajuster la taille de la grille : **Préférences → Grille**
### Dupliquer les Éléments
**Copier et Coller :**
1. Sélectionnez l'élément (les éléments)
2. **Ctrl+C** pour copier
3. **Ctrl+V** pour coller (apparaît décalé de l'original)
4. Faites-le glisser à la position finale
**Duplication Rapide :**
1. Sélectionnez l'élément
2. **Édition → Dupliquer**
3. La nouvelle copie apparaît à proximité
### Rotation et Retournement
**Rotation :**
- Sélectionnez l'élément
- Clic droit → **Rotation 90°**
- Ou appuyez sur **R** et cliquez pour tourner
**Retournement :**
- Clic droit → **Retournement Horizontal** ou **Retournement Vertical**
- Ou utilisez les raccourcis **H** ou **V**
### Grouper et Verrouiller
**Verrouiller Position :**
- Sélectionnez l'élément
- Clic droit → **Verrouiller la position** (empêche les mouvements accidentels)
- Déverrouillez de la même manière pour permettre le mouvement
**Verrouiller l'Apparence :**
- Verrouiller le texte, le style ou les connexions
- Clic droit → **Propriétés** pour les options de verrouillage
### Supprimer les Éléments
- Sélectionnez l'élément (les éléments)
- Appuyez sur la touche **Supprimer**
- Ou clic droit → **Supprimer**
- Utilisez **Ctrl+Z** pour annuler la suppression
---
## Dessiner les Fils et les Conducteurs
### Comprendre les Conducteurs
Un **conducteur** est une connexion électrique entre les éléments (les fils/lignes).
**Types :**
- **Unifilaire** — Représentation simplifiée
- **Multifilaire** — Les lignes de conducteurs individuels sont affichées
### Dessiner les Fils
**Dessin Basique du Fil :**
1. Cliquez sur l'**Outil Fil** (icône d'éclair)
2. Cliquez sur une **borne** (point de connexion sur l'élément)
3. Déplacez la souris vers la borne de destination
4. Cliquez pour compléter le fil
5. Le fil est tracé, automatiquement acheminé
**Fils Multi-Segments :**
1. Cliquez sur la première borne (point de départ)
2. Cliquez sur les points intermédiaires pour l'acheminement
3. Cliquez sur la borne finale (point de fin)
4. Appuyez sur **Échap** pour terminer
**Acheminement du Fil :**
- L'acheminement automatique crée généralement des chemins orthogonaux (angles droits)
- Cliquez sur les points de passage pour contrôler le chemin
- Appuyez sur **Échap** pour abandonner le fil
### Éditer les Fils
**Modifier le Chemin du Fil :**
1. Sélectionnez le fil (cliquez dessus)
2. Faites glisser les points de passage pour ajuster l'acheminement
3. Clic droit sur le point de passage pour le supprimer
**Supprimer le Fil :**
- Sélectionnez le fil
- Appuyez sur **Supprimer**
**Diviser le Fil :**
- Cliquez sur le fil avec l'outil Fil pour ajouter un point de connexion
- Placez l'élément sur le fil pour le diviser automatiquement
**Rejoindre les Fils :**
- Les fils se rejoignant à la borne se connectent automatiquement
- Aucune jonction manuelle nécessaire
### Propriétés du Fil
**Changer l'Apparence du Fil :**
1. Clic droit sur le fil
2. Sélectionnez **Propriétés**
3. **Modifiez :**
- Couleur (à partir de la palette de couleurs)
- Style (solide, en tirets, pointillé)
- Épaisseur (largeur de ligne)
**Propriétés du Conducteur :**
1. Clic droit sur le fil
2. Sélectionnez **Propriétés du Conducteur**
3. **Définissez :**
- Type de conducteur (phase, neutre, terre, etc.)
- Propriétés électriques
- Schéma de numérotation
---
## Texte, Étiquettes et Annotations
### Ajouter des Étiquettes de Texte
**Méthode de l'Outil Texte :**
1. Cliquez sur l'**Outil Texte** (icône A) dans la barre d'outils
2. Cliquez sur le canevas où vous voulez du texte
3. Tapez votre texte
4. Cliquez ailleurs pour terminer
**Étiquettes Rapides sur les Éléments/Fils :**
1. Double-cliquez sur l'élément ou le fil
2. Tapez le texte (par exemple, "S1" pour commutateur 1)
3. Appuyez sur **Entrée**
4. L'étiquette apparaît sur l'objet
### Étiquetage des Fils
Étiquettes de fil courantes :
- **Noms de signal :** "L1", "L2", "N", "PE" (terre)
- **Tension :** "24V AC", "12V DC"
- **Fonction :** "Activé", "Réinitialiser", "Alarme"
Pour ajouter une étiquette de fil :
1. Double-cliquez sur le fil
2. Tapez le texte d'étiquette
3. Appuyez sur **Entrée**
### Étiquetage des Éléments
Étiquettes d'élément courantes :
- **Désignateur de référence :** "S1" (interrupteur 1), "R1" (relais 1), "M1" (moteur 1)
- **Valeur du composant :** "100kΩ", "10µF"
- **Description :** "Commutateur Alimentation", "Bouton Démarrage"
Pour ajouter une étiquette d'élément :
1. Double-cliquez sur l'élément
2. Tapez la référence (par exemple, "Q1")
3. Appuyez sur **Entrée**
### Champs de Texte Dynamiques
Utilisez des variables qui se remplissent automatiquement :
- **%id** — ID d'élément/numéro de référence
- **%label** — Étiquette d'élément
- **%comment** — Texte de commentaire
- **%author** — Auteur du projet
- **%date** — Date actuelle
- **%filename** — Nom du fichier projet
Exemple : Ajoutez le texte "%date" et il affiche automatiquement la date d'aujourd'hui.
### Formatage du Texte
**Police et Style :**
1. Sélectionnez l'élément de texte
2. Clic droit → **Propriétés**
3. **Configurez :**
- Famille de police (Arial, Times, etc.)
- Taille (points)
- Couleur
- Orientation (horizontal, vertical, 45°, etc.)
---
## Édition et Formatage du Schéma
### Sélection et Organisation
**Sélectionner Tous les Objets :**
- **Édition → Tout Sélectionner** (Ctrl+A)
**Sélectionner par Type :**
- **Édition → Sélectionner** (sous-menu pour sélectionner des types spécifiques)
**Conseils Multi-Sélection :**
- Maintenez **Ctrl** et cliquez pour ajouter à la sélection
- Maj+clic pour sélectionner la plage
- Faites glisser la boîte pour sélectionner tout dedans
### Alignement et Distribution
**Aligner les Objets :**
1. Sélectionnez plusieurs objets
2. Clic droit → **Aligner**
3. Choisissez : Gauche, Droite, Haut, Bas, Centre
**Distribuer l'Espacement :**
1. Sélectionnez les objets (3 ou plus)
2. Clic droit → **Distribuer**
3. Espacer uniformément horizontalement ou verticalement
### Fonctionnalités Grille et Accrochage
**Paramètres de la Grille :**
- **Affichage → Accrochage à la Grille** — Basculer l'accrochage on/off
- **Préférences → Grille** — Ajuster la taille de la grille
- Grille plus petite = positionnement plus fin ; plus grande = placement plus rapide
**Conseils d'Alignement :**
- Activez l'accrochage pour des diagrammes nets et alignés
- Désactivez pour un placement libre
- Basculer avec le raccourci clavier
### Annuler et Refaire
**Annuler :**
- **Ctrl+Z** (ou Cmd+Z sur Mac)
- **Édition → Annuler** dans le menu
- Annuler plusieurs étapes répétées
**Refaire :**
- **Ctrl+Y** (ou Cmd+Maj+Z sur Mac)
- **Édition → Refaire** dans le menu
- Refaire plusieurs étapes répétées
### Zoom et Panoramique
**Méthodes de Zoom :**
- **Molette de Défilement :** Vers le haut pour agrandir, vers le bas pour réduire
- **Touches +/- :** Agrandir ou réduire
- **Ctrl+Scroll :** Contrôle de zoom fin
- **Affichage → Zoom → Ajuster à la Page :** Diagramme d'ajustement automatique
**Panoramique (Déplacer la Vue) :**
- **Bouton de souris central :** Cliquez et faites glisser pour faire un panoramique
- **Espace + Faites glisser :** Maintenez l'espace et faites glisser pour faire un panoramique
- **Touches fléchées :** Décaler la vue (lorsque rien n'est sélectionné)
---
## Rapports et Documentation
### Générer des Rapports
Les rapports créent automatiquement une documentation à partir de votre schéma :
**Rapports Disponibles :**
1. **Nomenclature** — Liste de tous les éléments avec des numéros de référence
2. **Liste de Conducteurs** — Tous les fils avec les connexions et les propriétés
3. **Documentation E/S** — Résumé des entrées et sorties
**Créer un Rapport :**
1. **Projet → Rapports**
2. Sélectionnez le type de rapport
3. **Configurer les options** (ce qu'il faut inclure)
4. Générer (exporte vers le fichier)
---
## Exportation et Impression
### Imprimer les Diagrammes
**Aperçu Avant Impression :**
1. **Fichier → Aperçu Avant Impression**
2. Voir comment le diagramme s'imprimera
3. Ajuster les paramètres si nécessaire
**Paramètres d'Impression :**
1. **Fichier → Imprimer**
2. **Configurez :**
- Taille et orientation de la page
- Couleur ou noir et blanc
- Mise à l'échelle (ajuster à la page, taille réelle, etc.)
3. Imprimer sur une imprimante ou un PDF
### Exporter les Diagrammes
**Formats d'Exportation :**
- **PDF** — Documents professionnels, meilleur pour le partage
- **PNG** — Image raster, bonne pour le web
- **SVG** — Format vectoriel, éditable dans d'autres logiciels
- **DXF** — Format CAO pour la collaboration
**Processus d'Exportation :**
1. Sélectionnez le ou les folios à exporter
2. **Fichier → Exporter**
3. Choisissez le format et l'emplacement
4. Configurer les options d'exportation
5. Cliquez sur **Exporter**
---
## Préférences et Paramètres
### Affichage et Apparence
**Préférences → Affichage :**
- Sélection de langue
- Thème (clair/sombre)
- Taille de police et rendu
- Schéma de couleurs
### Paramètres du Projet
**Préférences → Projets :**
- Taille de page par défaut
- Paramètres de marge
- Conducteurs par défaut
- Règles de numérotation automatique
### Grille et Accrochage
**Préférences → Grille :**
- Taille de la grille
- Afficher/masquer la grille
- Distance d'accrochage
- Style de ligne de grille
---
## Sujets Avancés
### Créer des Éléments Personnalisés
Voir **[Créer des Éléments](elements_XML)** pour les instructions détaillées sur :
- Concevoir des graphiques d'élément
- Définir les bornes de connexion
- Créer des métadonnées d'élément
- Empaqueter pour la distribution
### Collections d'Éléments et Bibliothèques
- Organiser les éléments personnalisés
- Créer des bibliothèques privées
- Partager avec l'équipe ou la communauté
- Accéder au référentiel d'éléments communautaires
### Workflows Multi-Utilisateurs
- Enregistrer les fichiers .qet sur un stockage partagé (lecteur réseau)
- Utiliser le contrôle de version (Git) pour les diagrammes
- Collaborer avec les membres de l'équipe
- Fusionner les modifications lors du travail en parallèle
### Scripting et Automatisation
*Informations sur le support de script Python (une fois complètement documenté)*
---
## Dépannage
### Problèmes Courants
**"L'élément ne se connecte pas au fil"**
- Cliquez directement sur la borne (petit point)
- Tous les points sur l'élément ne sont pas connectables
- Vérifiez les propriétés de l'élément pour les définitions de borne
**"Les fils se croisent sans connexion"**
- Les fils ne se connectent qu'aux bornes
- Les lignes de croisement ne se connectent pas automatiquement
- Utilisez une connexion explicite aux points de borne
**"Le diagramme est lent/flou"**
- Les grands projets avec de nombreux éléments ralentissent la réactivité
- Réduisez le niveau de zoom pour améliorer les performances
- Désactiver l'affichage de la grille si non nécessaire
- Fermer les panneaux inutiles
**"Le fichier ne s'ouvre pas"**
- Fichier corrompu ou problème de compatibilité
- Essayez d'ouvrir dans un éditeur de texte pour vérifier la validité du XML
- Restaurer à partir de la sauvegarde si disponible
---
## Raccourcis Clavier
| Action | Windows/Linux | macOS |
|--------|---|---|
| Nouveau | Ctrl+N | Cmd+N |
| Ouvrir | Ctrl+O | Cmd+O |
| Enregistrer | Ctrl+S | Cmd+S |
| Imprimer | Ctrl+P | Cmd+P |
| Annuler | Ctrl+Z | Cmd+Z |
| Refaire | Ctrl+Y | Cmd+Maj+Z |
| Sélectionner Tout | Ctrl+A | Cmd+A |
| Copier | Ctrl+C | Cmd+C |
| Coller | Ctrl+V | Cmd+V |
| Supprimer | Suppr | Suppr |
| Rotation | R | R |
| Zoom Avant | + | + |
| Zoom Arrière | - | - |
| Ajuster à la Page | Ctrl+0 | Cmd+0 |
---
## Plus de Ressources
- **[Guide de Démarrage Rapide](quick_start_guide-FR)** — Commencer
- **[Conseils et Astuces](tips_and_tricks)** — Workflows avancés
- **[Questions Fréquentes](faq-FR)** — Questions courantes
- **[Manuel Officiel](https://qelectrotech.github.io/qelectrotech-doc/)** — Documentation complète
- **[Forum](https://forum.qelectrotech.org/)** — Aide communautaire
---
## Obtenir de l'Aide
- **[Questions Fréquentes](faq-FR)** — Réponses rapides
- **[Forum](https://forum.qelectrotech.org/)** — Posez des questions à la communauté (très actif !)
- **[Problèmes](https://github.com/qelectrotech/qelectrotech-source-mirror/issues)** — Signaler les bugs
- **[Créer des Éléments](elements_XML)** — Construire des composants personnalisés
---
**[🌐 Choisir la Langue](languages)** — English · Français · Deutsch