Bevor Sie ein neues Lokalisierungsprojekt (*.prj) generieren, ist es notwendig eine XML Import Definitionsdatei (*.xid) zu erstellen. Diese XML Import Definitionsdatei wird mit Ihrer XML Datei für die Übersetzung verknüpft.
Ihre XML Import Definitionsdatei definiert, welche XML-Knoten oder -Attribute später übersetzt werden müssen.
Alle anderen XML-Knoten und -Attribute, welche nicht für die Übersetzung bestimmt wurden oder nicht zu Ihrer XID Datei passen, können nicht verändert oder übersetzt werden.
Starten Sie Visual Localize. Die Hauptansicht wird geöffnet
Im Menü Datei wählen Sie den Menüpunkt Neue Import Definitionsdatei… :
Der Dialog XML Dateien zur Auswahl einer XML Datei wird angezeigt:
In diesem Dialog wählen Sie bitte die zu übersetzende XML Datei aus. Drücken Sie die Öffnen-Taste, um Ihren Eintrag zu bestätigen.
Die ausgewählte XML Datei wird für das Erstellen einer entsprechenden XML Import Definitionsdatei (*.xid) geöffnet:
Das linke obere Fenster zeigt die Struktur Ihrer ausgewählten XML Datei. Die Ausprägung eines jedes XML Knoten mit seiner Struktur wird pro Hierarchie-Ebene angezeigt.
(Zur Vereinfachung werden alle sich wiederholenden Knoten mit identischer Struktur / Ausprägung nicht angezeigt.)
Zur Konfiguration Ihrer XML Datei, klicken Sie bitte auf den ersten XML-Hauptknoten (hier: buecher) im Fenster mit der XML Struktur:
Im Konfigurationsfenster auf der rechten Seite werden alle Einstellungen für den ausgewählten Knoten und dessen Attribute angezeigt. (Wurde eine der Check-Boxen aktiviert, wird der Name des entsprechenden XML Knotens im linken Fenster fett gedruckt dargestellt. Somit ist schnell sichtbar welcher XML-Knoten vom Anwender bereits konfiguriert wurde.):
Für die Übersetzung und ein einwandfreies Versionshandling Ihrer XML Datei ist es absolut notwendig für die GESAMTE XML Struktur einen eindeutigen Identifier (ID) festzulegen!
In der Spalte Erstellung der ID definieren Sie, welche XML-Knoten oder Attribute von Ihrer XML Datei verwendet werden sollen, um diesen eindeutigen Identifier (ID) zu erzeugen.
Dabei kann zwischen zwei Vorgehensweisen unterschieden werden:
Die ID eines XML Knotens wird über dessen Position innerhalb der gesamten XML Struktur festgelegt:
Beispiel:
Wenn Sie diese Möglichkeit für das Erstellen der ID bevorzugen, aktivieren Sie bitte die Checkbox Position in der Spalte Erstellung der ID.
Wiederholen Sie bitte diesen Vorgang für JEDEN zu übersetzenden XML Knoten beginnend von Ihrem XML-Root-Knoten (der Einstiegsknoten auf oberster Ebene Ihrer XML Datei).
Die ID eines XML Knotens wird über einen eindeutigen Attributswert festgelegt:
Beispiel:
Wenn Sie diese Möglichkeit für das Erstellen der ID bevorzugen, aktivieren Sie bitte die Checkbox
Wiederholen Sie bitte diesen Vorgang für JEDEN zu übersetzenden XML Knoten beginnend von Ihrem XML-Root-Knoten (der Einstiegsknoten auf oberster Ebene Ihrer XML Datei)
|
Für das Erstellen einer neuen XML Datei empfehlen wir Ihnen immer einen Unique Identifier (ID) in Form eines Attributes zu vergeben. (z.B.. ein Attribute “id=n“, bei dem “n“ eine eindeutige Nummer hat Diese ID erleichtert die Lokalisierung eines einzelnen Knotens innerhalb der gesamten XML-Struktur und vereinfacht das Handling der Version. |
Für ein korrektes Versionshandling in Visual Localize ist es absolut notwendig, dass die ID jedes XML Knotens eindeutig bestimmt werden kann!
Wenn die von Ihnen definierte ID nicht eindeutig ist, wird Sie Visual Localize sobald Ihre XML Import Definitionsdatei (*.xid) gespeichert werden soll, automatisch darauf aufmerksam machen. In diesem Fall sollten Sie Ihre festgelegte ID korrigieren.
Für das Erstellen einer eindeutigen ID kann es in manchen Fällen notwendig sein, einen Wert aus mehreren Attributen zu verwenden, um einen kombinierten Schlüssel zu generieren. Markieren Sie bitte zur Festlegung eines kombinierten Schlüssels (ID) alle Check-Boxen der zur verwendenden Attribute in der Spalte Erstellung der ID.
Falls Attribute in Ihrer XML Datei auftreten, die nicht in jedem XML Knoten mit identischer Hierarchie-Ebene existieren, wird Visual Localize diese Attribute in der Spalte Optional kennzeichnen. In der Spalte Standardwert können Sie für diese optionalen Attribute einen gewünschten Wert festlegen.
Markieren Sie bitte nun die alle zu übersetzenden Bestandteile (Knoteninhalte & Attribute) Ihrer XML Knoten:
Für die Übersetzung des XML- Knoteninhalts, aktivieren Sie bitte die Check-Box Wert von "
Für die Übersetzung eines XML-Attributes, aktivieren Sie bitte die Check-Box Attribut "Name_Ihres_Attributs" in der Spalte Zum Übersetzen.
Es ist nicht möglich einen XML-Knoten oder ein Attribut, welches zur Erstellung der ID verwendet wurde auch zu übersetzen.
Bei der späteren Übersetzung können nur die XML-Knoteninhalte und -Attribute verändert bzw. übersetzt werden, die hier zum Übersetzen definiert wurden.
Speichern Sie Ihre Einstellungen für die XID Datei durch Klicken auf den Button Speichern unter....
Ein Dialog zum Speichern wird geöffnet.
|
Für ein einfacheres Handling empfehlen wir Ihnen, denselben Namen für Ihre XID Datei (z.B. Bücher.xid) zu verwenden wie für Ihre XML Datei (z.B. Bücher.xml). Dies hilft Ihnen beim Erstellens einer neuen XML Projektdatei für jede XML Datei die dazugehörige XID Datei zuzuordnen.
|
Weiterführende Informationen
Über die XML Translation Engine
Optionaler Filter für XML Knoten
Schritt 2: Erstellen eines neuen XML Lokalisierungsprojektes