XML-Dateityp „XML-Letter“ erstellen – Beispiel

Wir werden einen XML-Dateityp „XML-Letter“ erstellen, welchen die SDL Dateityp-Software auf *.xml-Dateien anwendet, die über ein Stammelement (<letter>) verfügen. Ein Beispiel für eine Datei in diesem Dateityp ist example-xml-file-letter.xml (im ZIP-Archiv example-xml-files.zip). Für unser Beispiel erstellen wir den Dateityp in der Standard-Projektvorlage.

Warum und wann dieser Vorgang ausgeführt wird

Wir legen den Elementinhalt wie folgt fest:
XML-ElementZu übersetzenHinweise
<letter>Nein

Das ist das Stammelement und repräsentiert die Briefstruktur.

<title maxlength="50">Ja

Diese Elemente wurden eingefügt, um zu zeigen, wie Sie Textabschnitte behandeln können, die Längenbeschränkungen aufweisen.

<title maxlength="40">Ja

„Dear Daniel“ soll übersetzt werden.

<salutation>Ja
<text>Ja

Der Text des Briefs soll übersetzt werden.

<component translate="yes">Ja

Diese Elemente wurden eingefügt, um zu zeigen, wie Sie Textabschnitte behandeln können, die als zu übersetzen bzw. nicht zu übersetzen markiert wurden.

<component translate="no">Nein

Mit dem Hervorhebungs-Tag wird das Format des Textes geändert, aber der Text soll übersetzt werden.

<emphasis>Ja
<signature>Nein

Der Name oder die Adresse einer Person wird nicht übersetzt.

<address>Nein

Die Webadresse wird nicht verändert.

<weblink>Nein
<logo alt>Ja

Der alternative Text des Logos sollte in der Landessprache verfasst sein.

Alt ist ein Attribut, also geben Sie in der Parser-Regel Regeltyp als Attribut an. Immer wenn Sie eine Parser-Regel des Typs Attribut angeben, wird die Übersetzen-Eigenschaft des Attributs auf Immer übersetzen gesetzt.

<logo address>Nein

Die Webadresse wird nicht verändert. Fügen Sie keine Parser-Regel hinzu. (Standardmäßig ist die Übersetzungseigenschaft für Attribute Nicht zu übersetzen.)

Prozedur

  1. Starten Sie den Assistenten Dateityp anlegen.
  2. Ändern Sie auf der Seite Dateityp-Informationen des Assistenten den Namen des Dateityps zu XML-Letter. Geben Sie einen eindeutigen Namen für die Dateityp-ID an. Lassen Sie die Daten in den übrigen Feldern unverändert. Belassen Sie insbesondere die Dateierweiterung als *.xml.
  3. Definieren Sie auf der Seite XML-Einstellungen importieren die Einstellungen der Parser-Regeln auf Basis einer Regel-Datei und spezifizieren Sie die XML-Regeldatei example-xml-file-letter.xml. Diese Datei ist im ZIP-Archiv example-xml-files.zip enthalten, das Sie im Inhaltsverzeichnis der Hilfe finden. Der Assistent importiert die Parser-Regeln aus der Letter-Datei. Besitzt eine XML-Datei unter diesen Regeln einen <letter>-Stamm, stimmt die Datei mit diesem Dateityp überein, und der Inhalt der Datei wird im Einklang mit obiger Tabelle behandelt.
  4. Klicken Sie auf Weiter, um den Dateityp an einem bekannten Speicherort zu speichern.
  5. Klicken Sie auf Fertig stellen, um den Assistenten zur Dateityp-Erstellung zu schließen. Sie verfügen nun über den neuen Dateityp.
  6. Um die Vorschau-Einstellungen für den neuen Dateityp zu definieren, damit Sie eine sinnvolle formatierte Version der XML-Datei sehen können, verwenden Sie die Datei example-xml-transform-file.xslt wie folgt:
    1. Extrahieren und speichern Sie example-xml-transform-files.xslt aus dem ZIP-Archiv example-xml-files.zip.
    2. Klicken Sie in den Vorschau-Einstellungen für den Dateityp XML-Letter auf Stylesheet transformieren und geben Sie die gespeicherte Kopie von example-xml-transform-file.xslt an.

Beispiel – Die in XML-Letter verwendeten Parser-Regeln

Warum und wann dieser Vorgang ausgeführt wird

Mit den Parser-Regeln wird festgelegt, wie der Dateityp „XML-Letter“ durch die Dateityp-Support-Software verarbeitet wird.

Beispiel – Formateigenschaften für „XML-Letter“ konfigurieren

Warum und wann dieser Vorgang ausgeführt wird

Ein Beispiel für die Erstellung einer Parser-Regel für die Formatierung von Text innerhalb eines Tag-Paares, wenn das Dokument im Editor geöffnet wird. Als Beispiel werden der Dateityp „XML-Letter“ und die Datei example-xml-file-letter.xml verwendet. Das Tag-Paar ist <emphasis>...</emphasis>.

Beispiel – Elementlänge in XML beschränken

Warum und wann dieser Vorgang ausgeführt wird

Die Länge von Elementen und übersetzbaren Attributen lässt sich beschränken. Nachfolgend wird beschrieben, wie Sie Längenbeschränkungen für das Element <title> des Dateityps XML-Letter festlegen können. Wir verwenden dazu die XML-Beispieldatei example-xml-file-letter.xml. Sie baut auf dem folgenden Muster auf. Beispiel: Erstellen eines XML-Dateityps, XML-Letter.