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:escape-markup

      <p:declare-step type="p:escape-markup">
         <p:input port="source"/>
         <p:output port="result"/>
         <p:option name="cdata-section-elements" select="''"/> <!-- ListOfQNames -->
         <p:option name="doctype-public"/> <!-- string -->
         <p:option name="doctype-system"/> <!-- anyURI -->
         <p:option name="escape-uri-attributes" select="'false'"/> <!-- boolean -->
         <p:option name="include-content-type" select="'true'"/> <!-- boolean -->
         <p:option name="indent" select="'false'"/> <!-- boolean -->
         <p:option name="media-type"/> <!-- string -->
         <p:option name="method" select="'xml'"/> <!-- QName -->
         <p:option name="omit-xml-declaration" select="'true'"/> <!-- boolean -->
         <p:option name="standalone" select="'omit'"/><!-- "true" | "false" | "omit" -->
         <p:option name="undeclare-prefixes"/> <!-- boolean -->
         <p:option name="version" select="'1.0'"/> <!-- string -->
      </p:declare-step>
 

Der Step <p:escape-markup> wandelt sämtliche spitze Klammern (die Markups) aller Kind-Elemente des eingelesenen Wurzelelements (“source“), in ihre entsprechenden Entitiy Escape-Zeichen um und gibt dieses Dokument dann am Output-Port (“result“) aus. Darüberhinaus stehen dem Benutzer noch eine ganze Reihe an Optionen offen, die das Escape Verhalten dieses Steps beeinflussen. Auf die Optionen im Einzelnen wird in diesem Zusammenhang nicht näher eingegangen.

Beispiel

Das bekannte Dokument (“filmsammlung.xml“) wird durch einen p:identity Step geschickt. Vorher jedoch durch einen <p:escape-markup Step>.

      <?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:identity/>
      </p:declare-step>
 

Es werden sämtliche Kindelemente von “Filmsammlung“ durch ihre Entity Escape Zeichen ersetzt. Das Resultat dieser Prozedur sieht folgendermaßen aus (Auszug):

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