GnuGetText-Werkzeuge für Delphi

Grundfunktionen

Das Programm ggdxgettext.exe durchsucht die Quelltexte (dpr, dfm und pas-Dateien) eines Delphi-Projekts nach zu übersetzenden Strings und erstellt daraus ein po-Schablone.

Einstellungen

Nach dem Start des Programms öffnet sich das rechts angezeigte Fenster, in dem an oberster Stelle das Projektverzeichnis (Basisverzeichnis) zu benennen ist. Es kann entweder bereits beim Aufruf des Programms in der Befehlszeile angegeben (s.u.) oder mit einem Klick auf das Symbol rechts in einem Dialog ausgewählt werden. Weitere Optionen:

• Auch Unterverzeichnisse durchsuchen: Es werden alle Dateien der Unterverzeichnisse durchsucht, die nicht als auszuschließende angegeben werden.
• Dateimasken: Je nach verwendeter Programmiersprache wird hier eine Liste mit den Masken (z.B. *.pas *.dfm *.inc *.dpr) der zu durchsuchenden Quelldateien angegeben.
• Text Domäne: GnuGetText for Delphi bietet die Möglichkeit, Übersetzungen in verschiedene Text-Domänen zu unterteilen. Damit ist es möglich, Gruppen von Unterprogrammen (z.B. Units und Dialoge, die in verschiedenen Anwendungen zum Einsatz kommen) getrennt zu übersetzen. Die Standarddomäne für eine Anwendung heißt immer default. Die Namen anderer Domänen sind frei wählbar (z.B. units), müssen in den Quelltexten aber genauso angegeben werden (z.B. dxgettext('units','Hello'); oder TranslateComponent(self,'units');).
• Kodierung der Quelltexte: Diese Einstellung sollte normalerweise auf der Vorgabe US-ASCII belassen werde. Wenn in den Quelltexten Zeichen aus anderen Zeichensätzen vorkommen, z.B. wenn als Ausgangssprache deutsch verwendet wurde, muss die Auswahl der Kodierung entsprechend geändert werden.
• Füge wahrscheinliche Ausnahmen zu ignore.po hinzu: Nach dem Durchsuchen der Quelltexte wird die Liste der Strings auf Ausdrücke geprüft, die offensichtlich kein vom Benutzer angegeben Text ist, z.B. ein Fontname oder ein Zahlenstring. Diese werden dann in der Datei ignore.po gespeichert. Diese Textdatei kann der Benutzer auch selbst durch weitere Einträge ergänzen.
  In Ergänzung dazu kann der Benutzer eine eigene Liste bereit stellen, die bestimmte für die Benennung der Komponenten verwendet Muster vorgibt. Dazu passende Einträge werden dann automatisch nach ignore.po verschoben. Diese Liste hat den Namen IgnoreObjects.txt und befindet im Basisverzeichnis des Projektes (s.o.) Auf Wunsch kann sie vom Benutzer individuell angepasst werden.
  Beispiel: bb_=bit button erkennt alle Einträge (msgid), die mit bb_ beginnen. Sie werden durch den Kommentar # Seems like unrenamed bit button gekennzeichnet.
• Einträge aus ignore.po in der Vorlage löschen: Alle Einträge, die in der Datei ignore.po gefunden wurden, werden aus der Schablone entfernt und sind damit nicht mehr Bestandteil der Übersetzung.
• Einträge nach Originaltexten (msgid) sortieren: Die erzeugte po-Datei kann entweder in der Reihenfolge der Schablone oder alphabetisch nach den Originalstrings (msgid) sortiert abgespeichert werden.
• Schablone immer überschreiben: Eine ältere Schablone wird bei der Aktualisierung ohne Rückfrage überschrieben.
• Einstellungen behalten: Alle Einstellungen werden in einer Ini-Datei (dxgettext.ini) abgespeichert. Diese befindet sich im jeweiligen Basisverzeichnis.

Nach Klick auf OK startet das Durchsuchen der ausgewählten Quelldateien.

Verarbeitung

Im Dialogfenster (siehe Abb. rechts) wird der Verlauf der Suche nach zu übersetzenden Strings angezeigt. Ein besonderes Augenmerk sollte man darauf haben, ob Fehler angezeigt werden, z.B. wenn nicht ASCII-kodierbare Zeichen in den Quelltexten verwendet werden. In diesem Fall muss man entweder diese Zeichen ändern oder eine andere Text-Kodierung auswählen (s.o.).
Die Ausgabe der Schablone erfolgt grundsätzlich immer im UTF-8-Format.

Befehlszeile

Beispiel:
  ggdxgettext.exe "E:\Projects\Translate\sample\" /dom:sample.

Mit dem Programm ggmerge.exe werden die in einer aktualisierten Schablone neuen und geänderten Strings in die po-Datei mit der Übersetzung eingefügt. Diese muss dann mit einem geeigneten Editor (z.B. PoEdit) weiter bearbeitet werden.

Einstellungen

Nach dem Start des Programms öffnet sich das rechts angezeigte Fenster, in dem an oberster Stelle die zu aktualisierende po-Datei anzugeben ist. Sie kann entweder bereits beim Aufruf des Programms in der Befehlszeile angegeben (s.u.) oder mit einem Klick auf das Symbol rechts in einem Dialog ausgewählt werden. Danach wird die zum Abgleich zu verwendende po-Schablone ausgewählt. Weitere Optionen:

• Kodierung der Schablone: Für den Fall, dass die Schablone nicht im UTF-8-Format (Standard, s.o.) erstellt wurde, muss hier die verwendete Kodierung ausgewählt werden.
• Groß-/Kleinschreibung für MsgIds ignorieren: Beim Zusammenführen wird normalerweise auf eine exakte Übereinstimmung der Originaltexte (msgid) geprüft. Wenn diese Option eingeschaltet ist, wird, sofern dies nicht der Fall ist, zusätzlich geprüft, ob es eine Übereinstimmung der Originaltexte gibt, wenn die Groß- und Kleinschreibung nicht beachtet wird. Die Übersetzung wird dann übernommen aber für eine weitere Bearbeitung gekennzeichnet (Fuzzy).
• Automatische Kommentare beibehalten: Beim Erstellen der Schablone mit ggdxgettext werden automatische Kommentare eingefügt, die es dem Programmentwickler erleichtern, die Stelle des jeweiligen Strings im Quelltext wiederzufinden. Bei Auswahl dieser Option werden diese in die Übersetzungsdatei übertragen.
• Veraltete Übersetzungen behalten: Übersetzte Strings, die in der aktuellen Schablone nicht mehr verwendet werden, können optional als Kommentare mit der Kennzeichnung #~ angefügt werden.
• Backup der alten Übersetzung herstellen (empfohlen): Es wird immer eine Vorversion der übersetzten po-Datei behalten (z.B. default.~po).
• Einstellungen behalten: Alle Einstellungen werden in einer Ini-Datei abgespeichert. Diese befindet sich im Verzeichnis der ausgewählten po-Datei. Ihr Name leitet sich aus dem po-Namen ab (hier z.B. default.ini).

Befehlszeile

Beispiel:
  ggmerge.exe "E:\Projects\Translate\sample\languages\de\default.po".

ggfmt.exe ist eine Konsolenprogramm, mit dem po-Dateien (Text) in binäre mo-Dateien und zurück konvertiert werden können.

Mit dem Programm ggassemble.exe kann eine oder auch mehrere Übersetzungen in eine Exe-Datei eingebunden werden. Damit ist es für die Weitergabe des Delphi-Programms nicht mehr erforderlich, die Unterverzeichnisse locale\<Sprach-Id>\LC_MESSAGES\ beizufügen, da die Übersetzungen in die Exe-Datei integriert sind.

Das Programm benötigt die Angabe der zu bearbeitenden Exe-Datei. Diese wird normalerweise in der Befehlszeile angegeben (s.u.). Wenn diese Angabe fehlt, wird der Benutzer aufgefordert, die gewünschte Exe-Datei auszuwählen. Nach dem Start wird im Verzeichnis der exe-Datei in den Unterverzeichnissen vom o.g. Typ nach mo-Dateien gesucht und diese in einer Liste angezeigt. Der Benutzer wählt die einzubettenden Sprachen und Text-Domänen aus und klickt auf Starten. Voraussetzung für ein Funktionieren dieser Funktion ist es, dass in den Quelltexten des Programms die Unit GnuGetText.pas eingebunden ist und die exe-Datei frisch kompiliert ist, d.h. es wurden noch keine Übersetzungen eingebettet. Eine erfolgreiche Aktion wird durch eine entsprechende Nachricht (siehe Abb. rechts unten) angezeigt.

Befehlszeile

Bei der Installation des Programmpakets werden automatisch die erforderlichen Registry-Einträge vorgenommen, um die Windows-Kontextmenüs anzupassen:

1. Rechtsklick auf ein Verzeichnis, z.B. sample		2. Rechtsklick auf eine Quelltextdatei, z.B. GgtUtils.pas
durchsucht alle Programm-Quelltexte in dem ausgewählten Verzeichnis, um eine Übersetzungsschablone (po-Datei) zu erzeugen.		durchsucht die ausgewählte Quelltext-Datei, um daraus eine Übersetzungsschablone (po-Datei) zu erzeugen.
3. Rechtsklick auf eine po-Datei, z.B. default.po		4. Rechtsklick auf eine exe-Datei, z.B. GgtTranslate.exe
führt die Übersetzung mit der aktualisierten Schablone zusammen und startet einen Editor (z.B. PoEdit) für die Nachbearbeitung.		bettet die Übersetzungen in die ausgewählte exe-Datei ein.