XLIFF

Aktualisiere unterstützte XLIFF-Zieltexte, ohne den Ausgangstext oder die Identität der Übersetzungseinheiten zu verändern.

XLIFF enthält Ausgangstext, Zieltext und die Kennungen, die beide miteinander verknüpfen. Der xliff-Dateihandler übersetzt <source>-Inhalte in <target>-Werte in XLIFF-1.2- und XLIFF-2.x-Dokumenten. Er unterstützt einfachen Text und Inline-Codes. Ausgangstext und Einheitenkennungen bleiben dabei für den Import in dein Übersetzungssystem erhalten.

Unterstützte Einheitenstrukturen #

Diese XLIFF-1.2-Einheit enthält einen Ausgangstext ohne Formatierung:

xml
<xliff version="1.2">
  <file source-language="en" datatype="plaintext" original="checkout">
    <body>
      <trans-unit id="delivery">
        <source>Choose delivery</source>
      </trans-unit>
    </body>
  </file>
</xliff>

Bei XLIFF 1.2 liest der Handler trans-unit-Einträge, auch in verschachtelten Gruppen. Bei 2.x liest er jedes unit und die zugehörigen segment-Einträge. Enthält eine Einheit mehrere Segmente, wird jedes Segment separat zur Übersetzung verarbeitet.

Gepaarte Inline-Codes wie <g> und <pc> behalten ihre Struktur bei, während der enthaltene Text übersetzt wird. Eigenständige Codes wie <ph> bleiben geschützt. Halte die Kennungen von Einheiten und Inline-Codes stabil und eindeutig: Wiederholt vorkommende Einheiten-IDs werden anhand der Reihenfolge ihres Auftretens zugeordnet, mehrere Segmente innerhalb einer Einheit anhand ihrer Position. translate="no" schließt eine Einheit oder Gruppe von der Übersetzung aus.

Zieltexte und Sprachmetadaten #

Der aktuelle Ausgangstext ist für das Dokument maßgeblich. Unveränderte Einheiten können vorhandene, nicht leere Zieltexte beibehalten, wenn Ausgangstext und Inline-Codes weiterhin übereinstimmen. Bei fehlenden oder leeren Zieltexten ist eine Übersetzung erforderlich. Der Handler erstellt <target>-Elemente für übersetzte Einheiten, die noch kein solches Element haben.

Bei der XLIFF-1.2-Ausgabe wird für jede Datei target-language gesetzt; bei der 2.x-Ausgabe wird trgLang am Wurzelelement gesetzt. Die XML-Serialisierung kann die Formatierung vereinheitlichen. Ein ersetztes <target> wird als neues Element geschrieben. Kontrolliere daher neben dem Wortlaut auch die importerspezifischen Attribute und den Prüfungsstatus.

Ergebnis konfigurieren und importieren #

Die CLI leitet xliff aus .xlf und .xliff ab. Wähle Dateien über die CLI-Konfiguration oder GitHub aus.

Validiere das Ergebnis mit dem vorgesehenen Importer. Vergleiche Ausgangstext, Metadaten der Zielsprache, Inline-Codes und Segmentabdeckung. Sieh dir wiederholt vorkommende Kennungen und alle bewusst von der Übersetzung ausgeschlossenen Einheiten an. Führe anschließend eine Prüfung des importierten Zieltexts durch.