Lokalisierung
Überblick
Lokalisierung ist im Allgemeinen der Prozess der Bereitstellung einer Software mit einer mehrsprachigen Benutzeroberfläche. In FreeCAD kannst du die Sprache der Benutzeroberfläche unter Template:MenuCommand/de einstellen. FreeCAD verwendet Qt, um die Unterstützung mehrerer Sprachen zu ermöglichen. Auf Unix/Linux-Systemen verwendet FreeCAD standardmäßig die aktuellen Gebietsschemaeinstellungen deines Systems.
Helfen, FreeCAD zu übersetzen
Eines der sehr wichtigen Dinge, die Benutzer zu FreeCAD beitragen können (wenn sie z.B. keine Programmierfähigkeiten haben), ist es, die verschiedenen Aspekte (Quellcode, Wiki, Website, Dokumentation usw....) in eine andere Sprache zu übersetzen. Hier sind die Möglichkeiten, dies zu tun
Übersetze den FreeCAD Quellcode
FreeCAD verwendet ein gemeinschaftlich genutztes Online Übersetzungssystem von Drittanbietern namens Crowdin.
Es ist geschützte Software, aber für FOSS Projekte kostenlos. Nachfolgend sind Anweisungen wie es verwendet werden kann:
- Gehe zur FreeCAD Übersetzungsprojektseite auf Crowdin
- Melde Dich an, indem Du ein neues Profil erstellst oder ein Drittanbieterkonto verwendest (GitHub, GitLab, GMail usw....)
- Klicke auf die Sprache, die Du übersetzen möchtest.
- Beginne mit dem Übersetzen, indem Sie auf die Schaltfläche Übersetzen neben einer der Dateien klickst. Beispielsweise enthält FreeCAD.ts die Textzeichenketten für die FreeCAD Haupt GUI.
- Du kannst für bestehende Übersetzungen stimmen oder eigene erstellen.
Hinweis: Details zur Verwendung von Crowdin findest du auf der Seite Crowdin Verwaltung.
Übersetzung externer Arbeitsbereiche
Übersetze das FreeCAD Wiki
Dieses Wiki beherbergt viele Inhalte, von denen die meisten das Handbuch bilden. Du kannst die Dokumentation von der Hauptseite aus durchsuchen, oder einen Blick in das Benutzerhandbuch Online Hilfe Inhaltsverzeichnis werfen.
Um das Wiki zu übersetzen, musst Du über Wiki Bearbeitungsrechte verfügen; siehe Wie kann ich Bearbeitungsrechte für das Wiki erhalten?.
Du solltest auch genügend Kenntnisse über den Wikistil haben und die allgemeinen Gestaltungsrichtlinien befolgen, die unter WikiSeiten beschrieben sind.
Mediawiki Übersetzungserweiterung
Als das Wiki von SourceForge wegging, installierte Yorik MediaWiki's Translation Extension, was die Übersetzung von Seiten erleichtert. Die Übersetzungserweiterung hat den Vorteil, dass der Seitentitel nun übersetzt werden kann, dass sie die Übersetzungen verfolgt, dass dich benachrichtigt, ob die Originalseite aktualisiert wurde, und dass die Übersetzungen synchron mit der englischen Originalseite verwaltet.
Das Werkzeug ist in Help:Extension:Translate dokumentiert und ist ein Teil eines Mediawiki Spracherweiterungsbündels.
Um schnell mit der Vorbereitung einer Seite für die Übersetzung zu beginnen, bitte das Beispiel Seitenübersetzungsbeispiel lesen. Im Wesentlichen ein Paar von
<translate> ... </translate>
Kennzeichen müssen die gesamte Seite umgeben, um das Übersetzungssystem zu aktivieren, und die Seite muss zur Übersetzung markiert werden.
Um ein Beispiel für die Funktionsweise des Übersetzungswerkzeugs zu sehen, besuche die Hauptseite. Du wirst oben eine automatisch generierte Sprachleiste sehen. Klicke auf Deutsch (deutsch), es bringt dich zu Main Page/de. Direkt unter dem Titel "Hauptseite" (engl. "Main Page") kannst du lesen Diese Seite ist eine übersetzte Version der Hauptseite und die Übersetzung ist XX% vollständig, wobei XX der aktuelle Prozentsatz der Übersetzung ist. Klicke oben auf der Seite auf "Übersetzen", um das Übersetzungsprogramm zu starten, mit dem Du die bestehende Übersetzung aktualisieren, korrigieren und überprüfen kannst.
Wenn du zur Hauptseite gehst, wirst du feststellen, dass du die Seite nicht mehr direkt bearbeiten kannst, indem du auf die [Bearbeiten] klickst, und der obere Link "Bearbeiten" wurde durch den Link "Übersetzen" ersetzt, der das Übersetzungsprogramm öffnet.
Wenn ein neuer Inhalt hinzugefügt wird, sollte die englische Seite zuerst erstellt und dann in eine andere Sprache übersetzt werden. Wenn ein Inhalt geändert oder ergänzt werden soll, sollte das zuerst in der englischen Seite gemacht werden.
Wenn Du Dir nicht sicher bist, wie Du mit den Übersetzungen vorgehen sollst, zögere nicht, Dich im Unterforum Entwicklung → Wiki Unterforum oder im Unterforum Unterforum spezifische Sprache im FreeCAD-ForumFreeCAD Forum um Hilfe zu bitten.
Wichtige Anmerkungen
Jeder Wiki Benutzer der Editor Berechtigungen hat, kann das Übersetzungshilfsprogramm aufrufen, um Übersetzungen zu schreiben, zu speichern und zu überprüfen.
Allerdings können nur Benutzer mit Administrator Berechtigungen Seiten für die Übersetzung markieren. Eine Seite, die nicht für die Übersetzung freigegeben ist, kann die Übersetzungserweiterung nicht nutzen und wird nicht korrekt mit den englischen Informationen synchronisiert.
Die linke Seitenleiste ist ebenfalls übersetzbar, aber nur Administratoren können dieses Element der Webseite ändern. Bitte folge den zugehörigen Anweisungen auf Lokalisierungs Seitenleiste.
Wenn du zum ersten Mal auf das neue Übersetzungssystem wechselst, verliert es alle seine alten "manuellen" Übersetzungen. Um eine Übersetzung wiederherzustellen, solltest du eine Offline Kopie des alten Textes vor dem Wechsel speichern. Dann kannst du diesen alten übersetzten Text verwenden, um die Übersetzungseinheiten im neuen System auszufüllen. Du kannst auch eine frühere Version aus der Historie öffnen und so den alten Text erhalten. Dies muss für jede Sprache erfolgen, die eine übersetzte Seite hatte.
Übersetze die FreeCAD Dokumentation
Nach allgemeinem Konsens ist die Referenzseite im Wiki die englische Seite, die zuerst erstellt werden sollte. Wenn du Inhalte zu einer Seite ändern oder hinzufügen möchtest, solltest du dies zuerst auf der englischen Seite tun, und erst wenn das Update abgeschlossen ist, die Änderung auf die übersetzte Seite portieren.
Alte Übersetzungsanweisungen
Diese Anleitung gilt nur für den historischen Hintergrund. Übersetzungen sollten das neue System mit der oben beschriebenen #Mediawiki Translation Extension verwenden. |
Der erste Schritt besteht also darin, zu überprüfen, ob die manuelle Übersetzung für deine Sprache bereits gestartet wurde (siehe linke Seitenleiste, unter "Handbuch").
Seitenbenennungskonvention
#REDIRECT [[Über_FreeCAD/fr]]
{{docnav/fr|[[Online_Hilfe_Startseite/fr|Bienvenue dans l'aide en ligne de FreeCAD]]|[[Feature_list/fr|Funktionnalités]]}} Die Seite "Bienvenue dans l'aide en ligne de FreeCAD" verweist auf Online_Help_Startseite/fr, und die Seite "Fonctionnalités" verweist auf Feature_list/fr. |
Übersetze die FreeCAD Webseite
Die Übersetzung der FreeCAD Webseite erfolgt nun über Crowdin. Die Datei hat den Namen homepage.po.
Entwicklung - Wie man Lokalisierung hinzufügt
Dieser Abschnitt ist für Entwickler, die ihrem Code eine Lokalisierung hinzufügen möchten.
Vorbereitung deiner FreeCAD/Master Module für die Übersetzung
Dies sind die Schritte für den FreeCAD Übersetzungsprozess:
- entnehmen der Textzeichenfolgen aus dem Quellcode in *.ts Dateien
- lade .ts Dateien in FreeCAD Crowdin hoch
- Übersetzung der Zeichenfolgen in Crowdin
- entnehmen geänderter/neuer *.ts Dateien aus Crowdin
- Umwandeln der *.ts Dateien in *.qm Dateien und aktualisieren jeder *.qrc Datei der Module
- aktualisieren des FreeCAD Master
Alle der oberen Schritte werden von den Übersetzungsskripten durchgeführt, die periodisch durch einen Administrator ausgeführt werden.
Die Vorbereitung deines Moduls auf die Übersetzung ist ganz einfach. Zuerst musst du sicherstellen, dass du ein Verzeichnis "translations" in myModule/Gui/Resources hast. Öffne dann ein Terminalfenster (oder ein Windows/OSX Äquivalent) in Deinem Verzeichnis "Übersetzungen" und gib den folgenden Befehl ein:
lupdate -ts myModule.ts
Dies erzeugt eine leere Übersetzungsdatei. Sobald dies geschehen ist, muss sichergestellt sein, dass die Übersetzungsskripte in pull request aktualisiert sind.
Alles danach, soweit es einen Entwickler betrifft, wird automatisch durchgeführt. Der Administrator wird die Texte entnehmen, die Übersetzer werden sie übersetzen und der Administrator wird die Übersetzungen wieder entnehmen und FreeCAD/master aktualisieren.
Vorbereitung deines Drittanbieter Moduls oder Makros für die Übersetzung
Drittanbietermodule oder Makros von werden in ähnlicher Weise übersetzt, nur daß du einen Teil der Arbeit selbst erledigen musst. Diese Forumsdiskussion beschreibt die Details.
- * Aktualisierung: Siehe Übersetzen eines externen Arbeitsbereichs
Ältere Modulübersetzungstechniken
Lokalisierung älterer Methoden beschreibt den Einsatz von Übersetzungswerkzeugen wie Qt Linguist, lupdate, lrelease, pylupdate4, usw. im Detail. Das meiste davon ist für FreeCAD/master Module nicht mehr erforderlich, kann aber bei der Vorbereitung und Aktualisierung von Modulen von Drittanbietern hilfreich sein.
Automatisieren von Crowdin Übersetzungsaktualisierungen
Derzeit verwenden FreeCAD Betreuer die Crowdin API über Crowdin Skripte, um Übersetzungen in Crowdin und zurück in den Github Repo zu ziehen und zu verschieben. Die Crowdin API gibt FreeCAD Betreuern die Möglichkeit, Aspekte des Übersetzungsarbeitsablaufs des Projekts zu automatisieren, weitere Informationen findest Du in der Crowdin API Dokumentation.
Verwandte Seiten
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzliche Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Voreinstellungseditor, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, FreeCAD unterstützen, Spenden
- Hilfe: Anleitungen, Videoanleitungen
- Arbeitsbereiche: Std Base, Arch, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework