Parser-Regeln beschreiben die Struktur eines XML-Dateityps. Mit jeder Parser-Regel wird festgelegt, wie Studio übereinstimmende XML-Elemente bearbeitet werden. Die Parser-Regel teilt die Elemente in Kategorien ein (beispielsweise in übersetzbare oder nicht übersetzbare) und weist einen Tag-Typ zu. Sie legen diese Regeln für jeden XML-Dateityp mithilfe des Dialogfelds Parser-Regeln fest.
Schlüsselkomponenten einer Parser-Regel
Eine Parser-Regel verfügt über folgende Schlüsselelemente:
- Regelkennung
- Die Spezifikation der Knoten, für die die Regel gilt, ist eine der wichtigsten Eigenschaften einer Parser-Regel. Die Software verwendet XPath, um die entsprechenden Knoten festzulegen. Die Software verwendet diese Spezifikation, um die Regel zu identifizieren. Sie können somit nicht zwei Regeln mit dem gleichen XPath-Speicherort haben.
- Übersetzungseinstellung
- Zu übersetzende Inhalte können bearbeitet werden. Nicht zu übersetzende Inhalte werden möglicherweise nicht angezeigt: dies hängt von ihrem Tag-Typ ab.
Inhalte sind zu übersetzen, wenn eine der folgenden Aussagen zutrifft:
- Der Inhalt unterliegt keiner Parser-Regel.
- Der Inhalt ist in der Parser-Regel als zu übersetzen festgelegt.
- Der Inhalt erbt die Einstellung zu übersetzen von seinem Vorgängerelement.
- Einstellung des Tag-Typs
- Eine Parser-Regel kann erzwingen, dass dem Übersetzer ein Element als Tag dargestellt wird. Ein Tag kann auch zu übersetzenden Text enthalten. Ein Tag kann beliebig wie folgt spezifiziert werden:
- Inline mit dem Text.
- Der Inhalt wird dem Übersetzer angezeigt.
- Struktur-Tag
- Das Element erstellt in der Zieldatei eine neue Absatzeinheit.
- Nicht angegeben
- Das Tag ist als Struktur-Tag markiert.
Anmerkung: Sie können nicht sowohl die Übersetzen-Einstellung als auch den Tag-Typ als
Nicht angegeben festlegen.
- Leerzeichen
- Bei XML-Dateitypen können Sie wählen, ob die Dateifiltersoftware Leerzeichen beibehält oder normalisiert. Beibehaltung bedeutet, dass Leerzeichen nicht geändert werden. Normalisierung bedeutet, dass Leerzeichen mit einem einzelnen Leerzeichen ersetzt werden. Normalisierung erfolgt, wenn die Datei in sdlxliff konvertiert wird. Sie können die Leerzeicheneinstellung insgesamt für einen Dateityp auf der Seite Leerzeichen festlegen. Sie können die Leerzeicheneinstellung auch in einer Parser-Regel festlegen. Dort, wo eine Parser-Regel zur Anwendung kommt, wird die auf der Seite Leerzeichen vorgenommene Einstellung überschrieben.
- Informationen zur Formatierung und Struktur
- Mit den Formatierungs- und Strukturinformationen wird festgelegt, wie Tags und getaggte Inhalte dargestellt werden.
- Formatierung bezieht sich auf Inline-Tags und legt fest, wie der Inhalt eines Inline-Tags dem Übersetzer angezeigt wird. Sie möchten beispielsweise, dass Text innerhalb des Inline-Tag-Paars <b> ... </b> als fettgedruckter Text angezeigt wird.
- Struktur-Info bezieht sich auf Struktur-Tags und bestimmt, wie Text auf dem Bildschirm des Übersetzers angezeigt wird. Die Struktur-Info wird im Dialogfeld Parser-Regel als Kontext bezeichnet.
Beispiel: Wählen Sie auf der Basis eines Attributwerts ein Element für die Übersetzung aus
Die folgende Parser-Regel spezifiziert alle Elemente, die über das Attributwert-Paar translate=yes verfügen, und stellt sicher, dass diese Elemente zur Übersetzung angeboten werden:
- Regelkennung
- Die XPath-Kennung lautet:
//*[@translate="yes"]
Die Regel gilt für alle Elemente, die das Attribut „translate“ mit dem Wert „yes“ haben.
- Übersetzungseinstellung
- Immer zu übersetzen.
Fügen Sie die Übersetzungseinstellung im Dialogfeld Übersetzen in der Gruppe Eigenschaften hinzu.
Beispiel: XPath und äquivalente Element-Spezifikation
Die SDL-Dateityp-Software verwendet XPath, um Elemente zu spezifizieren, und auch Sie können XPath verwenden. Sie können das Element jedoch auch einfach im Dialogfeld Parser-Regel hinzufügen/bearbeiten spezifizieren.
- XPath-Syntax
- //text
- Äquivalente Element-Syntax
- Geben Sie im Gruppenfeld Regel, im Dialogfeld Element den Element-Namen wie folgt ein: text
Beispiel: XPath und Äquivalent für ein Element-Attribut-Paar
- XPath-Syntax
- //diagram/@address
- Äquivalente Element-Syntax
- Geben Sie im Gruppenfeld „Regel“, im Dialogfeld Element den Element-Namen wie folgt ein: diagram
- Geben Sie im Gruppenfeld „Regel“, im Dialogfeld Attribut den Element-Namen wie folgt ein: address
Beispiel: Verwenden Sie XPath, um ein Attributwert-Paar anzugeben
Die XML-Beispieldatei
example-xml-file-letter.xml enthält Elemente, die ein Attribut
translate haben, welches die Werte
yes und
no annehmen kann. Die Absicht ist klar: Inhalt im Bereich eines Attributwerts
translate="yes" soll übersetzt werden.
Der XPath-Ausdruck zur Spezifizierung dieses Bereichs lautet:
//*[@translate="yes"]
Dieser Ausdruck lässt sich in folgende Komponenten untergliedern:
- //*
- Spezifiziert bis zu jeder Tiefe alle Elemente.
- [...]
- Mit eckigen Klammern werden die Auswahlkriterien eingegrenzt. Um Elemente durch Werte eines Attributs zu spezifizieren (z. B. mit =, > oder <), setzen Sie den Ausdruck in eckige Klammern.
- @translate
- Spezifiziert das Attribut translate.
- ="yes"
- Spezifiziert Elemente, deren Attributwert "yes" lautet.