]> git.stg.codes - stg.git/blob - doc/xslt/slides/keynote/xsltsl/markup.xsl
Fill STG-MIB with real tree branches
[stg.git] / doc / xslt / slides / keynote / xsltsl / markup.xsl
1 <xsl:stylesheet version='1.0'
2   xmlns:xsl='http://www.w3.org/1999/XSL/Transform'
3   xmlns:doc='http://xsltsl.org/xsl/documentation/1.0'
4   xmlns:markup='http://xsltsl.org/markup'
5   xmlns:str='http://xsltsl.org/string'
6   extension-element-prefixes='doc markup str'>
7
8   <doc:reference xmlns=''>
9     <referenceinfo>
10       <releaseinfo role="meta">
11         $Id: markup.xsl 3991 2004-11-10 06:51:55Z balls $
12       </releaseinfo>
13       <author>
14         <surname>Ball</surname>
15         <firstname>Steve</firstname>
16       </author>
17       <copyright>
18         <year>2003</year>
19         <year>2001</year>
20         <holder>Steve Ball</holder>
21       </copyright>
22     </referenceinfo>
23
24     <title>XML Markup Templates</title>
25
26     <partintro>
27       <section>
28         <title>Introduction</title>
29
30         <para>This stylesheet module provides functions for generating literal XML markup.</para>
31
32       </section>
33     </partintro>
34
35   </doc:reference>
36
37   <doc:template name="markup:xml-declaration" xmlns="">
38     <refpurpose>Create an XML Declaration</refpurpose>
39
40     <refdescription>
41       <para>This template returns an XML Declaration.  Although the XSLT standard provides control over the generation of the XML Declaration, this template may be useful in circumstances where the values must be computed at runtime.</para>
42     </refdescription>
43
44     <refparameter>
45       <variablelist>
46         <varlistentry>
47           <term>version</term>
48           <listitem>
49             <para>Version number.</para>
50           </listitem>
51         </varlistentry>
52         <varlistentry>
53           <term>standalone</term>
54           <listitem>
55             <para>Standalone indication.  Must be value "yes" or "no".</para>
56           </listitem>
57         </varlistentry>
58         <varlistentry>
59           <term>encoding</term>
60           <listitem>
61             <para>Character encoding.</para>
62           </listitem>
63         </varlistentry>
64       </variablelist>
65     </refparameter>
66
67     <refreturn>
68       <para>Returns an XML Declaration as a string.</para>
69     </refreturn>
70   </doc:template>
71
72   <xsl:template name='markup:xml-declaration'>
73     <xsl:param name='version' select="'1.0'"/>
74     <xsl:param name='standalone'/>
75     <xsl:param name='encoding'/>
76
77     <xsl:text disable-output-escaping='yes'>&lt;?xml version="</xsl:text>
78     <xsl:copy-of select="$version"/>
79     <xsl:text>"</xsl:text>
80
81     <xsl:choose>
82       <xsl:when test="string-length($standalone) = 0"/>
83       <xsl:when test='$standalone = "yes" or $standalone = "no"'>
84         <xsl:text> standalone="</xsl:text>
85         <xsl:copy-of select="$standalone"/>
86         <xsl:text>"</xsl:text>
87       </xsl:when>
88       <xsl:otherwise>
89         <xsl:message terminate="yes">invalid value "<xsl:value-of select="$standalone"/>" for standalone attribute</xsl:message>
90       </xsl:otherwise>
91     </xsl:choose>
92
93     <xsl:if test='string-length($encoding) &gt; 0'>
94       <xsl:text> encoding="</xsl:text>
95       <xsl:copy-of select='$encoding'/>
96       <xsl:text>"</xsl:text>
97     </xsl:if>
98
99     <xsl:text disable-output-escaping='yes'>?&gt;
100 </xsl:text>
101   </xsl:template>
102
103   <doc:template name="markup:doctype-declaration" xmlns="">
104     <refpurpose>Create a Document Type Declaration</refpurpose>
105
106     <refdescription>
107       <para>This template returns a Document Type Declaration.  Although the XSLT standard provides control over the generation of a Document Type Declaration, this template may be useful in circumstances where the values for the identifiers or the internal subset must be computed at runtime.</para>
108     </refdescription>
109
110     <refparameter>
111       <variablelist>
112         <varlistentry>
113           <term>docel</term>
114           <listitem>
115             <para>The name of the document element.</para>
116           </listitem>
117         </varlistentry>
118         <varlistentry>
119           <term>publicid</term>
120           <listitem>
121             <para>The public identifier for the external DTD subset.</para>
122           </listitem>
123         </varlistentry>
124         <varlistentry>
125           <term>systemid</term>
126           <listitem>
127             <para>The system identifier for the external DTD subset.</para>
128           </listitem>
129         </varlistentry>
130         <varlistentry>
131           <term>internaldtd</term>
132           <listitem>
133             <para>The internal DTD subset.</para>
134           </listitem>
135         </varlistentry>
136       </variablelist>
137     </refparameter>
138
139     <refreturn>
140       <para>Returns a Document Type Declaration as a string.</para>
141     </refreturn>
142   </doc:template>
143
144   <xsl:template name='markup:doctype-declaration'>
145     <xsl:param name='docel'/>
146     <xsl:param name='publicid'/>
147     <xsl:param name='systemid'/>
148     <xsl:param name='internaldtd'/>
149
150     <xsl:if test='string-length($docel) = 0'>
151       <xsl:message terminate='yes'>No document element specified</xsl:message>
152     </xsl:if>
153
154     <xsl:text disable-output-escaping='yes'>&lt;!DOCTYPE </xsl:text>
155     <xsl:copy-of select="$docel"/>
156
157     <xsl:call-template name='markup:external-identifier'>
158       <xsl:with-param name='publicid' select='$publicid'/>
159       <xsl:with-param name='systemid' select='$systemid'/>
160       <xsl:with-param name='leading-space' select='true()'/>
161     </xsl:call-template>
162
163     <xsl:if test='string-length($internaldtd) &gt; 0'>
164       <xsl:text> [</xsl:text>
165       <xsl:copy-of select='$internaldtd'/>
166       <xsl:text>]</xsl:text>
167     </xsl:if>
168
169     <xsl:text disable-output-escaping='yes'>&gt;
170 </xsl:text>
171   </xsl:template>
172
173   <doc:template name="markup:element-declaration" xmlns="">
174     <refpurpose>Create an Element Declaration</refpurpose>
175
176     <refdescription>
177       <para>This template returns an element declaration..</para>
178     </refdescription>
179
180     <refparameter>
181       <variablelist>
182         <varlistentry>
183           <term>type</term>
184           <listitem>
185             <para>The element type.</para>
186           </listitem>
187         </varlistentry>
188         <varlistentry>
189           <term>content-spec</term>
190           <listitem>
191             <para>The content specification.</para>
192           </listitem>
193         </varlistentry>
194       </variablelist>
195     </refparameter>
196
197     <refreturn>
198       <para>Returns an element declaration as a string.</para>
199     </refreturn>
200   </doc:template>
201
202   <xsl:template name='markup:element-declaration'>
203     <xsl:param name='type'/>
204     <xsl:param name='content-spec' select="'ANY'"/>
205
206     <xsl:if test='string-length($type) = 0'>
207       <xsl:message terminate='yes'>element type must be specified</xsl:message>
208     </xsl:if>
209     <xsl:if test='string-length($content-spec) = 0'>
210       <xsl:message terminate='yes'>content specification must be specified</xsl:message>
211     </xsl:if>
212
213     <xsl:text disable-output-escaping='yes'>&lt;!ELEMENT </xsl:text>
214     <xsl:copy-of select='$type'/>
215     <xsl:text> </xsl:text>
216     <xsl:copy-of select='$content-spec'/>
217     <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
218   </xsl:template>
219
220   <doc:template name="markup:attlist-declaration" xmlns="">
221     <refpurpose>Create an Attribute List Declaration</refpurpose>
222
223     <refdescription>
224       <para>This template returns an attribute list declaration.</para>
225     </refdescription>
226
227     <refparameter>
228       <variablelist>
229         <varlistentry>
230           <term>type</term>
231           <listitem>
232             <para>The element type.</para>
233           </listitem>
234         </varlistentry>
235         <varlistentry>
236           <term>attr-defns</term>
237           <listitem>
238             <para>Attribute definitions.</para>
239           </listitem>
240         </varlistentry>
241       </variablelist>
242     </refparameter>
243
244     <refreturn>
245       <para>Returns an attribute list declaration as a string.</para>
246     </refreturn>
247   </doc:template>
248
249   <xsl:template name='markup:attlist-declaration'>
250     <xsl:param name='type'/>
251     <xsl:param name='attr-defns'/>
252
253     <xsl:if test='string-length($type) = 0'>
254       <xsl:message terminate='yes'>element type must be specified</xsl:message>
255     </xsl:if>
256
257     <xsl:text disable-output-escaping='yes'>&lt;!ATTLIST </xsl:text>
258     <xsl:copy-of select='$type'/>
259     <xsl:text> </xsl:text>
260     <xsl:copy-of select='$attr-defns'/>
261     <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
262   </xsl:template>
263
264   <doc:template name="markup:attribute-definition" xmlns="">
265     <refpurpose>Create an Attribute Definition</refpurpose>
266
267     <refdescription>
268       <para>This template returns an attribute definition.</para>
269     </refdescription>
270
271     <refparameter>
272       <variablelist>
273         <varlistentry>
274           <term>name</term>
275           <listitem>
276             <para>The attribute name.</para>
277           </listitem>
278         </varlistentry>
279         <varlistentry>
280           <term>type</term>
281           <listitem>
282             <para>The attribute type.</para>
283           </listitem>
284         </varlistentry>
285         <varlistentry>
286           <term>default</term>
287           <listitem>
288             <para>The attribute default.</para>
289           </listitem>
290         </varlistentry>
291       </variablelist>
292     </refparameter>
293
294     <refreturn>
295       <para>Returns an attribute definition as a string.</para>
296     </refreturn>
297   </doc:template>
298
299   <xsl:template name='markup:attribute-definition'>
300     <xsl:param name='name'/>
301     <xsl:param name='type'/>
302     <xsl:param name='default'/>
303
304     <xsl:if test='string-length($name) = 0'>
305       <xsl:message terminate='yes'>attribute name must be specified</xsl:message>
306     </xsl:if>
307     <xsl:if test='string-length($type) = 0'>
308       <xsl:message terminate='yes'>attribute type must be specified</xsl:message>
309     </xsl:if>
310     <xsl:if test='string-length($default) = 0'>
311       <xsl:message terminate='yes'>attribute default must be specified</xsl:message>
312     </xsl:if>
313
314     <xsl:text> </xsl:text>
315     <xsl:copy-of select='$name'/>
316     <xsl:text> </xsl:text>
317     <xsl:copy-of select='$type'/>
318     <xsl:text> </xsl:text>
319     <xsl:copy-of select='$default'/>
320   </xsl:template>
321
322   <doc:template name="markup:entity-declaration" xmlns="">
323     <refpurpose>Create an Entity Declaration</refpurpose>
324
325     <refdescription>
326       <para>This template returns an entity declaration.</para>
327       <para>If the 'text' parameter is given a value, then an internal entity is created.  If either the 'publicid' or 'systemid' parameters are given a value then an external entity is created.  It is an error for the 'text' parameter to have value as well as the 'publicid', 'systemid' or 'notation' parameters.</para>
328     </refdescription>
329
330     <refparameter>
331       <variablelist>
332         <varlistentry>
333           <term>name</term>
334           <listitem>
335             <para>The entity name.</para>
336           </listitem>
337         </varlistentry>
338         <varlistentry>
339           <term>parameter</term>
340           <listitem>
341             <para>Boolean value to determine whether a parameter entity is created.  Default is 'false()'.</para>
342           </listitem>
343         </varlistentry>
344         <varlistentry>
345           <term>text</term>
346           <listitem>
347             <para>The replacement text.  Must be a string.</para>
348           </listitem>
349         </varlistentry>
350         <varlistentry>
351           <term>nodes</term>
352           <listitem>
353             <para>The replacement text as a nodeset.  The nodeset is formatted as XML using the as-xml template.  If both text and nodes are specified then nodes takes precedence.</para>
354           </listitem>
355         </varlistentry>
356         <varlistentry>
357           <term>publicid</term>
358           <listitem>
359             <para>The public identifier for an external entity.</para>
360           </listitem>
361         </varlistentry>
362         <varlistentry>
363           <term>systemid</term>
364           <listitem>
365             <para>The system identifier for an external entity.</para>
366           </listitem>
367         </varlistentry>
368         <varlistentry>
369           <term>notation</term>
370           <listitem>
371             <para>The notation for an external entity.</para>
372           </listitem>
373         </varlistentry>
374       </variablelist>
375     </refparameter>
376
377     <refreturn>
378       <para>Returns an entity declaration as a string.</para>
379     </refreturn>
380   </doc:template>
381
382   <xsl:template name='markup:entity-declaration'>
383     <xsl:param name='name'/>
384     <xsl:param name='parameter' select='false()'/>
385     <xsl:param name='text'/>
386     <xsl:param name='nodes'/>
387     <xsl:param name='publicid'/>
388     <xsl:param name='systemid'/>
389     <xsl:param name='notation'/>
390
391     <xsl:if test='string-length($name) = 0'>
392       <xsl:message terminate='yes'>entity name must be specified</xsl:message>
393     </xsl:if>
394     <xsl:if test='string-length($text) &gt; 0 and 
395                   (string-length($publicid) &gt; 0 or
396                    string-length($systemid) &gt; 0 or
397                    string-length($notation) &gt; 0)'>
398       <xsl:message terminate='yes'>both replacement text and external identifier specified</xsl:message>
399     </xsl:if>
400
401     <xsl:text disable-output-escaping='yes'>&lt;!ENTITY </xsl:text>
402     <xsl:copy-of select='$name'/>
403     <xsl:text> </xsl:text>
404     <xsl:if test="$parameter">
405       <xsl:text>% </xsl:text>
406     </xsl:if>
407
408     <xsl:choose>
409       <xsl:when test="$nodes">
410         <xsl:call-template name='markup:quote-value'>
411           <xsl:with-param name='value'>
412             <xsl:call-template name="markup:as-xml">
413               <xsl:with-param name="nodes" select="$nodes"/>
414             </xsl:call-template>
415           </xsl:with-param>
416         </xsl:call-template>
417       </xsl:when>
418       <xsl:when test='$text'>
419         <xsl:call-template name='markup:quote-value'>
420           <xsl:with-param name='value' select='$text'/>
421         </xsl:call-template>
422       </xsl:when>
423       <xsl:otherwise>
424         <xsl:call-template name='markup:external-identifier'>
425           <xsl:with-param name='publicid' select='$publicid'/>
426           <xsl:with-param name='systemid' select='$systemid'/>
427         </xsl:call-template>
428       </xsl:otherwise>
429     </xsl:choose>
430
431     <xsl:if test='$notation'>
432       <xsl:text> NDATA "</xsl:text>
433       <xsl:copy-of select='$notation'/>
434       <xsl:text>"</xsl:text>
435     </xsl:if>
436
437     <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
438   </xsl:template>
439
440   <doc:template name="markup:quote-value" xmlns="">
441     <refpurpose>Quote an Attribute Value</refpurpose>
442
443     <refdescription>
444       <para>This template returns a quoted value.</para>
445     </refdescription>
446
447     <refparameter>
448       <variablelist>
449         <varlistentry>
450           <term>value</term>
451           <listitem>
452             <para>The value to quote.</para>
453           </listitem>
454         </varlistentry>
455       </variablelist>
456     </refparameter>
457
458     <refreturn>
459       <para>Returns a quote value as a string.</para>
460     </refreturn>
461   </doc:template>
462
463   <xsl:template name='markup:quote-value'>
464     <xsl:param name='value'/>
465
466     <xsl:variable name="quoted">
467       <xsl:call-template name='markup:quote-value-aux'>
468         <xsl:with-param name='value' select='$value'/>
469       </xsl:call-template>
470     </xsl:variable>
471
472     <xsl:choose>
473       <xsl:when test="contains($value, '&lt;')">
474         <xsl:call-template name='str:subst'>
475           <xsl:with-param name='text' select='$quoted'/>
476           <xsl:with-param name='replace'>&lt;</xsl:with-param>
477           <xsl:with-param name='with'>
478             <xsl:text disable-output-escaping='yes'>&amp;lt;</xsl:text>
479           </xsl:with-param>
480         </xsl:call-template>
481       </xsl:when>
482       <xsl:otherwise>
483         <xsl:copy-of select='$quoted'/>
484       </xsl:otherwise>
485     </xsl:choose>
486   </xsl:template>
487
488   <xsl:template name='markup:quote-value-aux'>
489     <xsl:param name='value'/>
490
491     <!-- Quoting hell! -->
492     <xsl:variable name="quot">&quot;</xsl:variable>
493     <xsl:variable name="apos">&apos;</xsl:variable>
494
495     <xsl:choose>
496       <xsl:when test='contains($value, $quot) and contains($value, $apos)'>
497         <xsl:text>"</xsl:text>
498         <xsl:call-template name='str:subst'>
499           <xsl:with-param name='text' select='$value'/>
500           <xsl:with-param name='replace'>"</xsl:with-param>
501           <xsl:with-param name='with'>
502             <xsl:text disable-output-escaping='yes'>&amp;quot;</xsl:text>
503           </xsl:with-param>
504         </xsl:call-template>
505         <xsl:text>"</xsl:text>
506       </xsl:when>
507       <xsl:when test='contains($value, $quot)'>
508         <xsl:text>'</xsl:text>
509         <xsl:value-of select='$value'/>
510         <xsl:text>'</xsl:text>
511       </xsl:when>
512       <xsl:otherwise>
513         <xsl:text>"</xsl:text>
514         <xsl:value-of select='$value'/>
515         <xsl:text>"</xsl:text>
516       </xsl:otherwise>
517     </xsl:choose>
518   </xsl:template>
519
520   <doc:template name="markup:external-identifier" xmlns="">
521     <refpurpose>Create an External Identifier</refpurpose>
522
523     <refdescription>
524       <para>This template returns an external identifier.</para>
525     </refdescription>
526
527     <refparameter>
528       <variablelist>
529         <varlistentry>
530           <term>publicid</term>
531           <listitem>
532             <para>The public identifier.</para>
533           </listitem>
534         </varlistentry>
535         <varlistentry>
536           <term>systemid</term>
537           <listitem>
538             <para>The system identifier.</para>
539           </listitem>
540         </varlistentry>
541       </variablelist>
542     </refparameter>
543
544     <refreturn>
545       <para>Returns an external identifier as a string.</para>
546     </refreturn>
547   </doc:template>
548
549   <xsl:template name='markup:external-identifier'>
550     <xsl:param name='publicid'/>
551     <xsl:param name='systemid'/>
552     <xsl:param name='leading-space' select='false()'/>
553
554     <xsl:choose>
555       <xsl:when test='string-length($publicid) &gt; 0'>
556         <xsl:if test='$leading-space'>
557           <xsl:text> </xsl:text>
558         </xsl:if>
559         <xsl:text disable-output-escaping='yes'>PUBLIC "</xsl:text>
560         <xsl:value-of select='$publicid' disable-output-escaping='yes'/>
561         <xsl:text disable-output-escaping='yes'>"</xsl:text>
562         <xsl:if test='string-length($systemid) &gt; 0'>
563           <xsl:text disable-output-escaping='yes'> "</xsl:text>
564           <xsl:value-of select='$systemid' disable-output-escaping='yes'/>
565           <xsl:text disable-output-escaping='yes'>"</xsl:text>
566         </xsl:if>
567       </xsl:when>
568       <xsl:when test="string-length($systemid) &gt; 0">
569         <xsl:if test='$leading-space'>
570           <xsl:text> </xsl:text>
571         </xsl:if>
572         <xsl:text disable-output-escaping='yes'>SYSTEM "</xsl:text>
573         <xsl:value-of select='$systemid' disable-output-escaping='yes'/>
574         <xsl:text disable-output-escaping='yes'>"</xsl:text>
575       </xsl:when>
576     </xsl:choose>
577   </xsl:template>
578
579   <doc:template name="markup:entity-reference" xmlns="">
580     <refpurpose>Create an Entity Reference</refpurpose>
581
582     <refdescription>
583       <para>This template returns an entity reference.</para>
584     </refdescription>
585
586     <refparameter>
587       <variablelist>
588         <varlistentry>
589           <term>name</term>
590           <listitem>
591             <para>The name of the entity.</para>
592           </listitem>
593         </varlistentry>
594       </variablelist>
595     </refparameter>
596
597     <refreturn>
598       <para>Returns an entity reference as a string.</para>
599     </refreturn>
600   </doc:template>
601
602   <xsl:template name='markup:entity-reference'>
603     <xsl:param name='name'/>
604
605     <xsl:text disable-output-escaping='yes'>&amp;</xsl:text>
606     <xsl:value-of select='$name'/>
607     <xsl:text>;</xsl:text>
608
609   </xsl:template>
610
611   <doc:template name="markup:notation-declaration" xmlns="">
612     <refpurpose>Create a Notation Declaration</refpurpose>
613
614     <refdescription>
615       <para>This template returns a notation declaration.</para>
616     </refdescription>
617
618     <refparameter>
619       <variablelist>
620         <varlistentry>
621           <term>name</term>
622           <listitem>
623             <para>The notation name.</para>
624           </listitem>
625         </varlistentry>
626         <varlistentry>
627           <term>publicid</term>
628           <listitem>
629             <para>The public identifier for the notation.</para>
630           </listitem>
631         </varlistentry>
632         <varlistentry>
633           <term>systemid</term>
634           <listitem>
635             <para>The system identifier for the notation.</para>
636           </listitem>
637         </varlistentry>
638       </variablelist>
639     </refparameter>
640
641     <refreturn>
642       <para>Returns a notation declaration as a string.</para>
643     </refreturn>
644   </doc:template>
645
646   <xsl:template name='markup:notation-declaration'>
647     <xsl:param name='name'/>
648     <xsl:param name='publicid'/>
649     <xsl:param name='systemid'/>
650
651     <xsl:if test='string-length($name) = 0'>
652       <xsl:message terminate='yes'>notation name must be specified</xsl:message>
653     </xsl:if>
654     <xsl:if test='string-length($publicid) = 0 and string-length($systemid) = 0'>
655       <xsl:message terminate='yes'>external identifier must be specified</xsl:message>
656     </xsl:if>
657
658     <xsl:text disable-output-escaping='yes'>&lt;!NOTATION </xsl:text>
659     <xsl:copy-of select='$name'/>
660
661     <xsl:call-template name='markup:external-identifier'>
662       <xsl:with-param name='publicid' select='$publicid'/>
663       <xsl:with-param name='systemid' select='$systemid'/>
664       <xsl:with-param name='leading-space' select='true()'/>
665     </xsl:call-template>
666
667     <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
668   </xsl:template>
669
670   <doc:template name="markup:cdata-section" xmlns="">
671     <refpurpose>Create a CDATA Section</refpurpose>
672
673     <refdescription>
674       <para>This template returns a CDATA Section.  The XSLT specification provides a mechanism for instructing the XSL processor to output character data in a CDATA section for certain elements, but this template may be useful in those circumstances where not all instances of an element are to have their content placed in a CDATA section.</para>
675     </refdescription>
676
677     <refparameter>
678       <variablelist>
679         <varlistentry>
680           <term>text</term>
681           <listitem>
682             <para>The content of the CDATA section.</para>
683           </listitem>
684         </varlistentry>
685       </variablelist>
686     </refparameter>
687
688     <refreturn>
689       <para>Returns a CDATA section as a string.</para>
690     </refreturn>
691   </doc:template>
692
693   <xsl:template name='markup:cdata-section'>
694     <xsl:param name='text'/>
695
696     <xsl:if test="contains($text, ']]&gt;')">
697       <xsl:message terminate="yes">CDATA section contains "]]&gt;"</xsl:message>
698     </xsl:if>
699
700     <xsl:text disable-output-escaping='yes'>&lt;![CDATA[</xsl:text>
701     <xsl:copy-of select='$text'/>
702     <xsl:text disable-output-escaping='yes'>]]&gt;</xsl:text>
703   </xsl:template>
704
705   <doc:template name="markup:as-xml" xmlns="">
706     <refpurpose>Format Nodeset As XML Markup</refpurpose>
707
708     <refdescription>
709       <para>This template returns XML markup.  Each node in the given nodeset is converted to its equivalent XML markup.</para>
710
711       <para>BUG: This version may not adequately handle XML Namespaces.</para>
712     </refdescription>
713
714     <refparameter>
715       <variablelist>
716         <varlistentry>
717           <term>nodes</term>
718           <listitem>
719             <para>Nodeset to format as XML.</para>
720           </listitem>
721         </varlistentry>
722       </variablelist>
723     </refparameter>
724
725     <refreturn>
726       <para>Returns XML markup.</para>
727     </refreturn>
728   </doc:template>
729
730   <xsl:template name='markup:as-xml'>
731     <xsl:param name='nodes'/>
732
733     <xsl:if test="$nodes">
734       <xsl:choose>
735         <xsl:when test="$nodes[1]/self::*">
736           <xsl:text disable-output-escaping='yes'>&lt;</xsl:text>
737           <xsl:value-of select="name($nodes[1])"/>
738           <xsl:for-each select="$nodes[1]/@*">
739             <xsl:text> </xsl:text>
740             <xsl:value-of select="name()"/>
741             <xsl:text>=</xsl:text>
742             <xsl:call-template name='markup:quote-value'>
743               <xsl:with-param name='value' select='.'/>
744             </xsl:call-template>
745           </xsl:for-each>
746
747           <xsl:choose>
748             <xsl:when test='$nodes[1]/node()'>
749               <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
750               <xsl:call-template name='markup:as-xml'>
751                 <xsl:with-param name='nodes' select='$nodes[1]/node()'/>
752               </xsl:call-template>
753               <xsl:text disable-output-escaping='yes'>&lt;/</xsl:text>
754               <xsl:value-of select="name($nodes[1])"/>
755               <xsl:text disable-output-escaping='yes'>&gt;</xsl:text>
756             </xsl:when>
757             <xsl:otherwise>
758               <xsl:text disable-output-escaping='yes'>/&gt;</xsl:text>
759             </xsl:otherwise>
760           </xsl:choose>
761         </xsl:when>
762         <xsl:when test="$nodes[1]/self::text()">
763           <xsl:value-of select="$nodes[1]"/>
764         </xsl:when>
765         <xsl:when test="$nodes[1]/self::comment()">
766           <xsl:text disable-output-escaping='yes'>&lt;!--</xsl:text>
767           <xsl:value-of select="$nodes[1]"/>
768           <xsl:text disable-output-escaping='yes'>--&gt;</xsl:text>
769         </xsl:when>
770         <xsl:when test="$nodes[1]/self::processing-instruction()">
771           <xsl:text disable-output-escaping='yes'>&lt;?</xsl:text>
772           <xsl:value-of select="name($nodes[1])"/>
773           <xsl:text> </xsl:text>
774           <xsl:value-of select="$nodes[1]"/>
775           <xsl:text disable-output-escaping='yes'>?&gt;</xsl:text>
776         </xsl:when>
777
778         <xsl:when test="not($nodes[1]/parent::*)"/> <!-- root node -->
779         <xsl:when test="count($nodes[1] | $nodes[1]/../namespace::*) = count($nodes[1]/../namespace::*)"/> <!-- namespace node -->
780         <xsl:when test="count($nodes[1] | $nodes[1]/../@*) = count($nodes[1]/../@*)"/> <!-- attribute node -->
781       </xsl:choose>
782
783       <xsl:call-template name="markup:as-xml">
784         <xsl:with-param name="nodes" select="$nodes[position() &gt; 1]"/>
785       </xsl:call-template>
786     </xsl:if>
787   </xsl:template>
788
789 </xsl:stylesheet>