Was sind SchlüsselPaar (KeyPair) Dateien?
SchlüsselPaar Dateien sind stark strukturierte Textdateien (ANSI oder UNICODE kodiert) mit einer eindeutigen Bezeichnung für jede Zeile. Die Dateierweiterung für SchlüsselPaar Dateien ist nicht begrenzt und kann vom Softwareentwickler ausgewählt werden (z.B. *.txt, *.xyz,...).
Allgemeiner Syntax für SchlüsselPaar Dateien:
[Unique ID] [Delimiter] [Phrase für die Übersetzung]
Zum Beispiel:
1=Öffnen
2=Schließen
3=Beenden
...
oder
ID1:Öffnen
ID2:Fehlermeldung
ID3:Schließen
...
und viele Möglichkeiten mehr...
Klicken Sie auf die Durchsuchen-Taste des SchlüsselPaar-Kartenreiters (siehe oben) um den SchlüsselPaar (KeyPair) Import Assistent zu öffnen:
Fügen Sie den Pfad und Dateinamen Ihrer Quelldatei in das Textfeld Dateiname ein oder wählen Sie eine Datei über die Durchsuchen-Taste aus. Ein Dialog 'SchlüsselPaar Dateien' wird geöffnet.
NOTIZ: Versichern Sie sich bitte, dass Sie eine Datei gewählt haben, die mit dem oben aufgeführten Syntax für SchlüsselPaar Dateien übereinstimmt oder eine gültige JAVA Ressource Datei (*.java, *.properties) ist!
Falls Sie eine JAVA Ressource Datei ausgewählt haben, so müssen Sie zusätzlich die Checkbox Datei ist eine JAVA Datei (*.java, *.properties) aktivieren. Alle anderen Konfigurationseinstellungen (Schritt 2 bis 7) werden deaktiviert und Sie können mit Schritt 8 fortfahren.
In der Elementengruppe Zeichen zur Definition einer Kommentarzeile definieren Sie bitte alle Zeichenketten, die eine Kommentarzeile in Ihrer SchüsselPaar Datei markiert.
NOTIZ: Die Kommentarzeile wird später nicht übersetzt, jedoch kann die Kommentarzeile wichtige Hinweise für den Übersetzer enthalten.
SchlüsselPaar Beispielstruktur:
// Diese Phrase wird verwendet um einen Dialog zu öffnen
1=Öffnen
2=Nächste
// Diese Phrase wird verwendet um die Applikation zu beenden
3=Beenden
In unserem Beispiel wird die Kommentarzeile am Anfange jeder Zeile mit der Zeichenfolge "//" gekennzeichnet.
Zum Festlegen der Kommentarzeile fügen Sie bitte // in das Textfeld Zeichen ein. Anschließend klicken Sie auf den Button . Das Zeichen wird nun in die Liste Verwend. Zeichen verschoben.
Wiederholen Sie diesen Schritt für alle (Kommentar) Zeilen innerhalb Ihrer SchlüsselPaar Datei, welche nicht mit dem Syntax für SchlüsselPaar Dateien übereinstimmen (siehe oben).
Falls Sie vergessen haben eine Zeile zu konfigurieren, wird Visual Localize sobald die SchlüsselPaar Datei importiert werden soll, eine Fehlermeldung anzeigen.
Um ein bereits definiertes Zeichen der Kommentarzeile wieder zu entfernen, wählen Sie bitte das gewünschte Zeichen in der Liste Verwendete Zeichen aus und drücken den Button .
In der Kontrollgruppe Kommentarzeile(n) hinzufügen können Sie auswählen wie die zuvor definierten Kommentarzeilen den zu übersetzenden Phrasen zugeordnet werden soll:
Mit dem Radio Button nur zum direkt darunterliegenden SchlüsselPaar werden alle Kommentarzeilen NUR zu der einen Übersetzungszeile hinzugefügt, welche sich direkt unter dem Kommentar befindet.
In unserem Beispiel oben, wir die Kommentarzeile "Diese Phrase wird verwendet um einen Dialog zu öffnen" nur der direkt darunterliegenden Übersetzungszeile "Öffnen" hinzugefügt.
Die Kommentarzeile "Diese Phrase wird verwendet um die Applikation zu beenden" wird nur der direkt darunterliegenden Übersetzungszeile "Beenden"hinzugefügt.
Mit dem Radio Button zu allen darunterliegenden SchlüsselPaaren werden die Kommentarzeilen allen nachfolgenden Übersetzungszeilen hinzugefügt bis eine neue Kommentarzeile gefunden wird.
In unserem Beispiel oben, würde die Kommentarzeile "Diese Phrase wird verwendet um einen Dialog zu öffnen" zu den Übersetzungszeilen "Öffnen" und "Nächste" hinzugefügt werden.
Die Kommentarzeile "Diese Phrase wird benutzt um die Applikation zu beenden" würde zu der Übersetzungszeilen "Beenden" und allen weiteren Übersetzungszeilen hinzugefügt werden bis eine neue Kommentarzeile gefunden wird.
In der Kontrollgruppe Trennzeichen definieren Sie die Zeichen(kette), welche die eindeutigen IDs (auf der linken Seite des Trennzeichens) von der zu übersetzenden Textphrase (auf der rechten Seite des Trennzeichens) abtrennt. In unserem Schlüsselpaar Beispiel wurde als Trennzeichen das Gleichheitszeichen benutzt (=).
Falls Ihre SchlüsselPaar Datei eine Kopfzeile hat, die nicht übersetzt werden soll oder kann, können Sie über Import ab Zeile die Zeile festlegen, ab der ein korrekter Syntax für Schlüsselpaar Dateien (siehe oben) vorliegt.
In der Combo-Box Dateiursprung wählen Sie bitte das Kodierungsformat (Windows ANSI, UNICODE oder UTF-8) aus, in der Ihre zu übersetzende SchlüsselPaar Datei gespeichert wurde.
In der Combo-Box Speichern wählen Sie bitte das Kodierungsformat (Windows ANSI, UNICODE oder UTF-8) aus, in der Ihre übersetzte SchlüsselPaar Datei später gespeichert werden soll.
Bestätigen Sie alle Einstellungen über die OK-Taste. Visual Localize wird alle Einstellungen für die gewählte SchlüsselPaar Datei speichern.
Falls eine Fehlermeldung angezeigt wird, prüfen Sie bitte, ob Sie alle Kommentarzeilen korrekt konfiguriert haben und der Syntax für SchlüsselPaar Dateien eingehalten wird.
Weiterführende Informationen