XML-Technologien / XProc / Referenz / unescape-markup

XProc-Steps

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

p:unescape-markup

<p:declare-step type="p:unescape-markup">
   <p:input port="source"/>
   <p:output port="result"/>
   <p:option name="namespace"/> <!-- anyURI -->
   <p:option name="content-type" select="'application/xml'"/> <!-- string -->
   <p:option name="encoding"/> <!-- string -->
   <p:option name="charset"/> <!-- string -->
</p:declare-step>

Der Step <p:unescape-markup> ist das Gegenstück zu <p:escape-markup>. Er wandelt sämtliche Entity Escape-Zeichen in ihre entsprechenden Unicode-Zeichen um. Dem Benutzer stehen vier Optionen zu Verfügung, die das Verhalten des Steps steuern. So kann durch die Option “namespace“ ein Standard-Namensraum definiert werden. Die Option “content-type“ teilt dem Prozessor mit, um welche Art von Dokument es sich handelt (Standard ist XML), und somit auch, wie die jeweiligen Umwandlungen vorzunehmen sind. Die Optionen “encoding“ und “charset“ geben an, um welche Kodierung es sich handelt und welcher Zeichensatz verwendet wird. Diese Angaben können je nach Fall relevant für das Umwandlungsverhalten sein. Sämtliche Optionen sind optional. Das initale Dokument wird am Input-Port (“source“) angegeben. Das Resultat wird am Output-Port (“result“) ausgegeben.

Beispiel

Ein zuvor durch <p:escape-markup> umgewandeltes Dokument soll wieder durch <p:unescape-markup> in seinen Urzustand gebracht werden.

<?xml version="1.0" encoding="UTF-8"?>
<p:declare-step xmlns:p="http://www.w3.org/ns/xproc" xmlns:c="http://www.w3.org/ns/xproc-step" version="1.0">
   <p:input port="source">
      <p:document href="filmsammlung.xml"/>
   </p:input>
   <p:output port="result"/>
   <p:escape-markup/>
   <p:unescape-markup/>
</p:declare-step>

Die Ausgabe nach dem <p:escape-markup>-Step sieht so aus (Auszug):

&lt;FilmSammlung&gt;
  &lt;Film&gt;
    &lt;Titel&gt;Star Wars: Episode IV - A New Hope&lt;/Titel&gt;
    &lt;Jahr&gt;1978&lt;/Jahr&gt;
    &lt;Genre&gt;SciFi&lt;/Genre&gt;
[...]

Die Ausgabe nach dem <p:unescape-markup>-Step sieht so aus (Auszug):

<FilmSammlung>
   <Film>
      <Titel>Star Wars: Episode IV - A New Hope</Titel>
      <Jahr>1978</Jahr>
      <Genre>SciFi</Genre>
[...]

Tipp der data2type-Redaktion:
Zum Thema XProc bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: