Changeset 681 for rfc2629xslt


Ignore:
Timestamp:
Aug 13, 2009, 6:08:47 AM (10 years ago)
Author:
julian.reschke@…
Message:

update to latest version of rfc2629.xslt package (suppresses new PIs for xml2rfc)

Location:
rfc2629xslt
Files:
7 edited

Legend:

Unmodified
Added
Removed
  • rfc2629xslt/clean-for-DTD.xslt

    r588 r681  
    8484
    8585<xsl:template match="processing-instruction('rfc-ext')" mode="cleanup"/>
     86<xsl:template match="processing-instruction('BEGININC')" mode="cleanup"/>
     87<xsl:template match="processing-instruction('ENDINC')" mode="cleanup"/>
    8688
    8789<!-- add issues appendix -->
  • rfc2629xslt/rfc2629toHhk.xslt

    r571 r681  
    2424<html>
    2525  <head>
    26     <meta name="generator" content="rfc2629toHhk.xslt $Id: rfc2629toHhk.xslt,v 1.6 2003/11/16 14:52:40 jre Exp $" />
     26    <meta name="generator" content="rfc2629toHhk.xslt $Id: rfc2629toHhk.xslt,v 1.6 2003-11-16 14:52:40 jre Exp $" />
    2727  </head>
    2828  <body>
  • rfc2629xslt/rfc2629xslt.html

    r662 r681  
    370370   --param xml2rfc-ext-support-rfc2731 '"no"' \
    371371   rfc2629.xslt source.xml &gt; result.html
    372 </pre>  <p>(note the required quoting of string parameters)<span id="rfc.iref.x.1"></span></p> <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;Supported xml2rfc-compatible PIs</h2><div id="rfc.table.u.1"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>comment</th></tr></thead><tbody><tr><td>rfc</td><td>background<div id="rfc.iref.b.1"></div><div id="rfc.iref.p.1"></div></td><td>xml2rfc-background<div id="rfc.iref.x.2"></div>  <div id="rfc.iref.p.2"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>compact<div id="rfc.iref.c.1"></div><div id="rfc.iref.p.3"></div></td><td>xml2rfc-compact<div id="rfc.iref.x.3"></div>  <div id="rfc.iref.p.4"></div></td><td>"no"</td><td>only applies to HTML output method when printing</td></tr><tr><td>rfc</td><td>comments<div id="rfc.iref.c.2"></div><div id="rfc.iref.p.5"></div></td><td>xml2rfc-comments<div id="rfc.iref.x.4"></div>  <div id="rfc.iref.p.6"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>editing<div id="rfc.iref.e.1"></div><div id="rfc.iref.p.7"></div></td><td>xml2rfc-editing<div id="rfc.iref.x.5"></div>  <div id="rfc.iref.p.8"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>footer<div id="rfc.iref.f.1"></div><div id="rfc.iref.p.9"></div></td><td>xml2rfc-footer<div id="rfc.iref.x.6"></div>  <div id="rfc.iref.p.10"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>header<div id="rfc.iref.h.1"></div><div id="rfc.iref.p.11"></div></td><td>xml2rfc-header<div id="rfc.iref.x.7"></div>  <div id="rfc.iref.p.12"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>inline<div id="rfc.iref.i.1"></div><div id="rfc.iref.p.13"></div></td><td>xml2rfc-inline<div id="rfc.iref.x.8"></div>  <div id="rfc.iref.p.14"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>iprnotified<div id="rfc.iref.i.2"></div><div id="rfc.iref.p.15"></div></td><td>xml2rfc-iprnotified<div id="rfc.iref.x.9"></div>  <div id="rfc.iref.p.16"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>linkmailto<div id="rfc.iref.l.1"></div><div id="rfc.iref.p.17"></div></td><td>xml2rfc-linkmailto<div id="rfc.iref.x.10"></div>  <div id="rfc.iref.p.18"></div></td><td>"yes"</td><td></td></tr><tr><td>rfc</td><td>private<div id="rfc.iref.p.19"></div><div id="rfc.iref.p.20"></div></td><td>xml2rfc-private<div id="rfc.iref.x.11"></div>  <div id="rfc.iref.p.21"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>rfcedstyle<div id="rfc.iref.r.1"></div><div id="rfc.iref.p.22"></div></td><td>xml2rfc-rfcedstyle<div id="rfc.iref.x.12"></div>  <div id="rfc.iref.p.23"></div></td><td>(not set)</td><td>(limited support)</td></tr><tr><td>rfc</td><td>sortrefs<div id="rfc.iref.s.1"></div><div id="rfc.iref.p.24"></div></td><td>xml2rfc-sortrefs<div id="rfc.iref.x.13"></div>  <div id="rfc.iref.p.25"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>symrefs<div id="rfc.iref.s.2"></div><div id="rfc.iref.p.26"></div></td><td>xml2rfc-symrefs<div id="rfc.iref.x.14"></div>  <div id="rfc.iref.p.27"></div></td><td>"yes"</td><td>The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</td></tr><tr><td>rfc</td><td>toc<div id="rfc.iref.t.1"></div><div id="rfc.iref.p.28"></div></td><td>xml2rfc-toc<div id="rfc.iref.x.15"></div>  <div id="rfc.iref.p.29"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>tocdepth<div id="rfc.iref.t.2"></div><div id="rfc.iref.p.30"></div></td><td>xml2rfc-tocdepth<div id="rfc.iref.x.16"></div>  <div id="rfc.iref.p.31"></div></td><td>99</td><td></td></tr><tr><td>rfc</td><td>topblock<div id="rfc.iref.t.3"></div><div id="rfc.iref.p.32"></div></td><td>xml2rfc-topblock<div id="rfc.iref.x.17"></div>  <div id="rfc.iref.p.33"></div></td><td>"yes"</td><td></td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;Unsupported xml2rfc-compatible PIs</h2><div id="rfc.table.u.2"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>comment</th></tr></thead><tbody><tr><td>rfc</td><td>include<div id="rfc.iref.i.3"></div><div id="rfc.iref.p.34"></div></td><td>incompatible with XML/XSLT processing model, please use external entities instead</td></tr><tr><td>rfc</td><td>needLines<div id="rfc.iref.n.1"></div><div id="rfc.iref.p.35"></div></td><td></td></tr><tr><td>rfc</td><td>slides<div id="rfc.iref.s.3"></div><div id="rfc.iref.p.36"></div></td><td></td></tr><tr><td>rfc</td><td>strict<div id="rfc.iref.s.4"></div><div id="rfc.iref.p.37"></div></td><td></td></tr><tr><td>rfc</td><td>subcompact<div id="rfc.iref.s.5"></div><div id="rfc.iref.p.38"></div></td><td></td></tr><tr><td>rfc</td><td>tocindent<div id="rfc.iref.t.4"></div><div id="rfc.iref.p.39"></div></td><td>(defaults to "yes")</td></tr><tr><td>rfc</td><td>tocompact<div id="rfc.iref.t.5"></div><div id="rfc.iref.p.40"></div></td><td></td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;Extension PIs</h2><div id="rfc.table.u.3"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>description</th></tr></thead><tbody><tr><td>rfc-ext</td><td>allow-markup-in-artwork<div id="rfc.iref.a.1"></div><div id="rfc.iref.p.41"></div></td><td>xml2rfc-allow-markup-in-artwork<div id="rfc.iref.x.18"></div>  <div id="rfc.iref.p.42"></div></td><td>"no"</td><td>Enables support for specific elements inside abstract elements (using this extension makes the document incompatible to the RFC2629bis DTD; see description of conversion XSLT in <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;11.4</a>).</td></tr><tr><td>rfc-ext</td><td>authors-section<div id="rfc.iref.a.2"></div><div id="rfc.iref.p.43"></div></td><td>xml2rfc-ext-authors-section<div id="rfc.iref.x.19"></div>  <div id="rfc.iref.p.44"></div></td><td></td><td>When "end", place the authors section at the end (just before the copyright statements). This seems to be the preferred order in the newest RFCs.</td></tr><tr><td>rfc-ext</td><td>duplex<div id="rfc.iref.d.1"></div><div id="rfc.iref.p.45"></div></td><td>xml2rfc-ext-duplex<div id="rfc.iref.x.20"></div>  <div id="rfc.iref.p.46"></div></td><td>no</td><td>When set to "yes", format the PDF output for doublesided printing.</td></tr><tr><td>rfc-ext</td><td>include-references-in-index<div id="rfc.iref.i.4"></div><div id="rfc.iref.p.47"></div></td><td>xml2rfc-ext-include-references-in-index<div id="rfc.iref.x.21"></div>  <div id="rfc.iref.p.48"></div></td><td></td><td>When set to "yes", index entries are generated for all references.</td></tr><tr><td>rfc-ext</td><td>justification<div id="rfc.iref.j.1"></div><div id="rfc.iref.p.49"></div></td><td>xml2rfc-ext-justification<div id="rfc.iref.x.22"></div>  <div id="rfc.iref.p.50"></div></td><td>"never"</td><td>"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</td></tr><tr><td>rfc-ext</td><td>parse-xml-in-artwork<div id="rfc.iref.p.51"></div><div id="rfc.iref.p.52"></div></td><td>xml2rfc-parse-xml-in-artwork<div id="rfc.iref.x.23"></div>  <div id="rfc.iref.p.53"></div></td><td>"no"</td><td>May be used to enable parsing of XML content in figures (MSXML only).</td></tr><tr><td>rfc-ext</td><td>support-rfc2731<div id="rfc.iref.s.6"></div><div id="rfc.iref.p.54"></div></td><td>xml2rfc-ext-support-rfc2731<div id="rfc.iref.x.24"></div>  <div id="rfc.iref.p.55"></div></td><td>"yes"</td><td>Decides whether the HTML transformation should generate META tags according <a href="#rfc2731.properties" title="Dublin Core (RFC2731) metadata">Section&nbsp;6.4</a>.</td></tr><tr><td>rfc-ext</td><td>sec-no-trailing-dots<div id="rfc.iref.s.7"></div><div id="rfc.iref.p.56"></div></td><td>xml2rfc-ext-sec-no-trailing-dots<div id="rfc.iref.x.25"></div>  <div id="rfc.iref.p.57"></div></td><td></td><td>When set to "yes", add trailing dots to section numbers. This seems to be the preferred format in the newest RFCs.</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;<a id="anchors" href="#anchors">Anchors</a></h1><p id="rfc.section.4.p.1">The transformation automatically generates anchors that are supposed to be stable and predictable and that can be used to identify specific parts of the document. Anchors are generated both in HTML and XSL-FO content (but the latter will only be used for PDF output when the XSL-FO engine supports producing PDF anchors).</p><div id="rfc.table.u.4"><p>The following anchors get auto-generated:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>Anchor name</th><th>Description</th></tr></thead><tbody><tr><td>rfc.abstract <div id="rfc.iref.r.2"></div><div id="rfc.iref.a.3"></div></td><td>Abstract</td></tr><tr><td>rfc.authors <div id="rfc.iref.r.3"></div><div id="rfc.iref.a.4"></div></td><td>Authors section</td></tr><tr><td>rfc.copyright <div id="rfc.iref.r.4"></div><div id="rfc.iref.a.5"></div></td><td>Copyright section</td></tr><tr><td>rfc.copyrightnotice <div id="rfc.iref.r.5"></div><div id="rfc.iref.a.6"></div></td><td>Copyright notice</td></tr><tr><td>rfc.figure.<em>n</em>  <div id="rfc.iref.r.6"></div><div id="rfc.iref.a.7"></div></td><td>Figures (titled)</td></tr><tr><td>rfc.figure.u.<em>n</em>  <div id="rfc.iref.r.7"></div><div id="rfc.iref.a.8"></div></td><td>Figures (untitled)</td></tr><tr><td>rfc.index <div id="rfc.iref.r.8"></div><div id="rfc.iref.a.9"></div></td><td>Index</td></tr><tr><td>rfc.ipr <div id="rfc.iref.r.9"></div><div id="rfc.iref.a.10"></div></td><td>Intellectual Property</td></tr><tr><td>rfc.iref.<em>n</em>  <div id="rfc.iref.r.10"></div><div id="rfc.iref.a.11"></div></td><td>Internal references</td></tr><tr><td>rfc.note.<em>n</em>  <div id="rfc.iref.r.11"></div><div id="rfc.iref.a.12"></div></td><td>Notes (from front section)</td></tr><tr><td>rfc.references <div id="rfc.iref.r.12"></div><div id="rfc.iref.a.13"></div></td><td>References</td></tr><tr><td>rfc.references.<em>n</em>  <div id="rfc.iref.r.13"></div><div id="rfc.iref.a.14"></div></td><td>Additional references</td></tr><tr><td>rfc.section.<em>n</em>  <div id="rfc.iref.r.14"></div><div id="rfc.iref.a.15"></div></td><td>Section <em>n</em></td></tr><tr><td>rfc.section.<em>n</em>.p.<em>m</em>  <div id="rfc.iref.r.15"></div><div id="rfc.iref.a.16"></div></td><td>Section <em>n</em>, paragraph <em>m</em></td></tr><tr><td>rfc.status <div id="rfc.iref.r.16"></div><div id="rfc.iref.a.17"></div></td><td>Status of memo</td></tr><tr><td>rfc.table.<em>n</em>  <div id="rfc.iref.r.17"></div><div id="rfc.iref.a.18"></div></td><td>Tables (titled)</td></tr><tr><td>rfc.table.u.<em>n</em>  <div id="rfc.iref.r.18"></div><div id="rfc.iref.a.19"></div></td><td>Tables (untitled)</td></tr><tr><td>rfc.toc <div id="rfc.iref.r.19"></div><div id="rfc.iref.a.20"></div></td><td>Table of contents</td></tr><tr><td>rfc.xref.<em>name</em>.<em>n</em>  <div id="rfc.iref.r.20"></div><div id="rfc.iref.a.21"></div></td><td>References to reference <em>n</em> to <em>name</em></td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.5" class="np"><a href="#rfc.section.5">5.</a>&nbsp;<a id="xslt.engines" href="#xslt.engines">Supported XSLT engines</a></h1><p id="rfc.section.5.p.1">The transformation requires a non-standard extension function (see <a href="http://www.exslt.org/exsl/functions/node-set/exsl.node-set.html">exsl:node-set</a>) which is however widely available. XSLT processors that do not support this extension (or a functional equivalent) currently are not supported.</p><h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;Standalone Engines</h2><p id="rfc.section.5.1.p.1">The following XSLT engines are believed to work well: </p><ul><li>Windows: <span id="rfc.iref.m.1"></span><span id="rfc.iref.m.2"></span>MSXML3 and MSXML4 (&lt;<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>&gt;; command line processor "msxsl" is available from <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41">Microsoft Download Center</a>)</li><li>Java: <span id="rfc.iref.s.8"></span>Saxon (&lt;<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>&gt;)</li><li>Java: <span id="rfc.iref.x.26"></span>Xalan (&lt;<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>&gt;)</li><li>C/C++: <span id="rfc.iref.x.27"></span>xsltproc (libxslt) (&lt;<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>&gt;, make sure that you have a current version)</li></ul><h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a id="xslt.engines.browser" href="#xslt.engines.browser">In-Browser Engines</a></h2><p id="rfc.section.5.2.p.1">The following browsers seem to work fine: </p><ul><li><p><span id="rfc.iref.i.5"></span>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</p></li><li><p><span id="rfc.iref.i.6"></span><span id="rfc.iref.i.7"></span><span id="rfc.iref.i.8"></span>Internet Explorer 6 and newer</p></li><li><div id="firefox3"><p><span id="rfc.iref.m.3"></span><span id="rfc.iref.f.2"></span>Firefox 3.0 and newer</p></div><p> </p><ul><li>Be aware that XSLT execution can be suppressed using <span id="rfc.iref.n.2"></span><a href="https://addons.mozilla.org/de/firefox/addon/722">NoScript</a></li><li>Firefox does not load external DTDs, see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</a>, thus entities like &amp;nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix&nbsp;C.1</a>)</li></ul></li><li><p><span id="rfc.iref.s.9"></span><span id="rfc.iref.s.10"></span>Safari 3 (starting with version 3.0.4)</p></li><li><p><span id="rfc.iref.g.1"></span>Google Chrome (beta available)</p></li><li><p><span id="rfc.iref.o.1"></span>Opera 10 (beta version available)</p></li></ul><p id="rfc.section.5.2.p.2">The following browsers are known not to work properly: </p><ul><li id="firefox12"><span id="rfc.iref.m.4"></span><span id="rfc.iref.f.3"></span>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</a>)</li><li id="opera"><span id="rfc.iref.o.2"></span>Opera 9.21: execution fails, potentially to a somewhat complex XPath expression (reported to Opera as bug 245725).</li><li>Opera 9.5 and 9.6: transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</li><li id="safari"><span id="rfc.iref.s.11"></span>Safari 2.* supports client-side XSLT as of MacOS X 10.4, but misses required extension functions. A problem with stylesheets producing non-ASCII output (such as NBSP characters) has been fixed as of OSX 10.4.4. Both problems have been reported through Apple's bug tracking system, see &lt;<a href="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html">http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html</a>&gt; and &lt;<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;.</li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a>&nbsp;<a id="output.html" href="#output.html">Transforming to HTML</a></h1><p id="rfc.section.6.p.1">Transformation to HTML can be done inside the browser if it supports XSLT. To enable this, add the following processing instruction to the start of the source file:</p><div id="rfc.iref.x.28"></div><div id="rfc.figure.u.4"></div><pre class="text">  &lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?&gt;
     372</pre>  <p>(note the required quoting of string parameters)<span id="rfc.iref.x.1"></span></p> <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a>&nbsp;Supported xml2rfc-compatible PIs</h2><div id="rfc.table.u.1"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>comment</th></tr></thead><tbody><tr><td>rfc</td><td>background<div id="rfc.iref.b.1"></div><div id="rfc.iref.p.1"></div></td><td>xml2rfc-background<div id="rfc.iref.x.2"></div>  <div id="rfc.iref.p.2"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>compact<div id="rfc.iref.c.1"></div><div id="rfc.iref.p.3"></div></td><td>xml2rfc-compact<div id="rfc.iref.x.3"></div>  <div id="rfc.iref.p.4"></div></td><td>"no"</td><td>only applies to HTML output method when printing</td></tr><tr><td>rfc</td><td>comments<div id="rfc.iref.c.2"></div><div id="rfc.iref.p.5"></div></td><td>xml2rfc-comments<div id="rfc.iref.x.4"></div>  <div id="rfc.iref.p.6"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>editing<div id="rfc.iref.e.1"></div><div id="rfc.iref.p.7"></div></td><td>xml2rfc-editing<div id="rfc.iref.x.5"></div>  <div id="rfc.iref.p.8"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>footer<div id="rfc.iref.f.1"></div><div id="rfc.iref.p.9"></div></td><td>xml2rfc-footer<div id="rfc.iref.x.6"></div>  <div id="rfc.iref.p.10"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>header<div id="rfc.iref.h.1"></div><div id="rfc.iref.p.11"></div></td><td>xml2rfc-header<div id="rfc.iref.x.7"></div>  <div id="rfc.iref.p.12"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>inline<div id="rfc.iref.i.1"></div><div id="rfc.iref.p.13"></div></td><td>xml2rfc-inline<div id="rfc.iref.x.8"></div>  <div id="rfc.iref.p.14"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>iprnotified<div id="rfc.iref.i.2"></div><div id="rfc.iref.p.15"></div></td><td>xml2rfc-iprnotified<div id="rfc.iref.x.9"></div>  <div id="rfc.iref.p.16"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>linkmailto<div id="rfc.iref.l.1"></div><div id="rfc.iref.p.17"></div></td><td>xml2rfc-linkmailto<div id="rfc.iref.x.10"></div>  <div id="rfc.iref.p.18"></div></td><td>"yes"</td><td></td></tr><tr><td>rfc</td><td>private<div id="rfc.iref.p.19"></div><div id="rfc.iref.p.20"></div></td><td>xml2rfc-private<div id="rfc.iref.x.11"></div>  <div id="rfc.iref.p.21"></div></td><td>(not set)</td><td></td></tr><tr><td>rfc</td><td>rfcedstyle<div id="rfc.iref.r.1"></div><div id="rfc.iref.p.22"></div></td><td>xml2rfc-rfcedstyle<div id="rfc.iref.x.12"></div>  <div id="rfc.iref.p.23"></div></td><td>(not set)</td><td>(limited support)</td></tr><tr><td>rfc</td><td>sortrefs<div id="rfc.iref.s.1"></div><div id="rfc.iref.p.24"></div></td><td>xml2rfc-sortrefs<div id="rfc.iref.x.13"></div>  <div id="rfc.iref.p.25"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>symrefs<div id="rfc.iref.s.2"></div><div id="rfc.iref.p.26"></div></td><td>xml2rfc-symrefs<div id="rfc.iref.x.14"></div>  <div id="rfc.iref.p.27"></div></td><td>"yes"</td><td>The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</td></tr><tr><td>rfc</td><td>toc<div id="rfc.iref.t.1"></div><div id="rfc.iref.p.28"></div></td><td>xml2rfc-toc<div id="rfc.iref.x.15"></div>  <div id="rfc.iref.p.29"></div></td><td>"no"</td><td></td></tr><tr><td>rfc</td><td>tocdepth<div id="rfc.iref.t.2"></div><div id="rfc.iref.p.30"></div></td><td>xml2rfc-tocdepth<div id="rfc.iref.x.16"></div>  <div id="rfc.iref.p.31"></div></td><td>99</td><td></td></tr><tr><td>rfc</td><td>topblock<div id="rfc.iref.t.3"></div><div id="rfc.iref.p.32"></div></td><td>xml2rfc-topblock<div id="rfc.iref.x.17"></div>  <div id="rfc.iref.p.33"></div></td><td>"yes"</td><td></td></tr></tbody></table></div><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;Unsupported xml2rfc-compatible PIs</h2><div id="rfc.table.u.2"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>comment</th></tr></thead><tbody><tr><td>rfc</td><td>include<div id="rfc.iref.i.3"></div><div id="rfc.iref.p.34"></div></td><td>incompatible with XML/XSLT processing model, please use external entities instead</td></tr><tr><td>rfc</td><td>needLines<div id="rfc.iref.n.1"></div><div id="rfc.iref.p.35"></div></td><td></td></tr><tr><td>rfc</td><td>slides<div id="rfc.iref.s.3"></div><div id="rfc.iref.p.36"></div></td><td></td></tr><tr><td>rfc</td><td>strict<div id="rfc.iref.s.4"></div><div id="rfc.iref.p.37"></div></td><td></td></tr><tr><td>rfc</td><td>subcompact<div id="rfc.iref.s.5"></div><div id="rfc.iref.p.38"></div></td><td></td></tr><tr><td>rfc</td><td>tocindent<div id="rfc.iref.t.4"></div><div id="rfc.iref.p.39"></div></td><td>(defaults to "yes")</td></tr><tr><td>rfc</td><td>tocompact<div id="rfc.iref.t.5"></div><div id="rfc.iref.p.40"></div></td><td></td></tr></tbody></table></div><h2 id="rfc.section.3.3"><a href="#rfc.section.3.3">3.3</a>&nbsp;Extension PIs</h2><div id="rfc.table.u.3"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>PI target</th><th>PI pseudo-attribute</th><th>XSLT parameter name</th><th>default</th><th>description</th></tr></thead><tbody><tr><td>rfc-ext</td><td>allow-markup-in-artwork<div id="rfc.iref.a.1"></div><div id="rfc.iref.p.41"></div></td><td>xml2rfc-allow-markup-in-artwork<div id="rfc.iref.x.18"></div>  <div id="rfc.iref.p.42"></div></td><td>"no"</td><td>Enables support for specific elements inside abstract elements (using this extension makes the document incompatible to the RFC2629bis DTD; see description of conversion XSLT in <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section&nbsp;11.4</a>).</td></tr><tr><td>rfc-ext</td><td>authors-section<div id="rfc.iref.a.2"></div><div id="rfc.iref.p.43"></div></td><td>xml2rfc-ext-authors-section<div id="rfc.iref.x.19"></div>  <div id="rfc.iref.p.44"></div></td><td></td><td>When "end", place the authors section at the end (just before the copyright statements). This seems to be the preferred order in the newest RFCs.</td></tr><tr><td>rfc-ext</td><td>duplex<div id="rfc.iref.d.1"></div><div id="rfc.iref.p.45"></div></td><td>xml2rfc-ext-duplex<div id="rfc.iref.x.20"></div>  <div id="rfc.iref.p.46"></div></td><td>no</td><td>When set to "yes", format the PDF output for doublesided printing.</td></tr><tr><td>rfc-ext</td><td>include-references-in-index<div id="rfc.iref.i.4"></div><div id="rfc.iref.p.47"></div></td><td>xml2rfc-ext-include-references-in-index<div id="rfc.iref.x.21"></div>  <div id="rfc.iref.p.48"></div></td><td></td><td>When set to "yes", index entries are generated for all references.</td></tr><tr><td>rfc-ext</td><td>justification<div id="rfc.iref.j.1"></div><div id="rfc.iref.p.49"></div></td><td>xml2rfc-ext-justification<div id="rfc.iref.x.22"></div>  <div id="rfc.iref.p.50"></div></td><td>"never"</td><td>"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</td></tr><tr><td>rfc-ext</td><td>parse-xml-in-artwork<div id="rfc.iref.p.51"></div><div id="rfc.iref.p.52"></div></td><td>xml2rfc-parse-xml-in-artwork<div id="rfc.iref.x.23"></div>  <div id="rfc.iref.p.53"></div></td><td>"no"</td><td>May be used to enable parsing of XML content in figures (MSXML only).</td></tr><tr><td>rfc-ext</td><td>support-rfc2731<div id="rfc.iref.s.6"></div><div id="rfc.iref.p.54"></div></td><td>xml2rfc-ext-support-rfc2731<div id="rfc.iref.x.24"></div>  <div id="rfc.iref.p.55"></div></td><td>"yes"</td><td>Decides whether the HTML transformation should generate META tags according <a href="#rfc2731.properties" title="Dublin Core (RFC2731) metadata">Section&nbsp;6.4</a>.</td></tr><tr><td>rfc-ext</td><td>sec-no-trailing-dots<div id="rfc.iref.s.7"></div><div id="rfc.iref.p.56"></div></td><td>xml2rfc-ext-sec-no-trailing-dots<div id="rfc.iref.x.25"></div>  <div id="rfc.iref.p.57"></div></td><td></td><td>When set to "yes", add trailing dots to section numbers. This seems to be the preferred format in the newest RFCs.</td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.4" class="np"><a href="#rfc.section.4">4.</a>&nbsp;<a id="anchors" href="#anchors">Anchors</a></h1><p id="rfc.section.4.p.1">The transformation automatically generates anchors that are supposed to be stable and predictable and that can be used to identify specific parts of the document. Anchors are generated both in HTML and XSL-FO content (but the latter will only be used for PDF output when the XSL-FO engine supports producing PDF anchors).</p><div id="rfc.table.u.4"><p>The following anchors get auto-generated:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>Anchor name</th><th>Description</th></tr></thead><tbody><tr><td>rfc.abstract <div id="rfc.iref.r.2"></div><div id="rfc.iref.a.3"></div></td><td>Abstract</td></tr><tr><td>rfc.authors <div id="rfc.iref.r.3"></div><div id="rfc.iref.a.4"></div></td><td>Authors section</td></tr><tr><td>rfc.copyright <div id="rfc.iref.r.4"></div><div id="rfc.iref.a.5"></div></td><td>Copyright section</td></tr><tr><td>rfc.copyrightnotice <div id="rfc.iref.r.5"></div><div id="rfc.iref.a.6"></div></td><td>Copyright notice</td></tr><tr><td>rfc.figure.<em>n</em>  <div id="rfc.iref.r.6"></div><div id="rfc.iref.a.7"></div></td><td>Figures (titled)</td></tr><tr><td>rfc.figure.u.<em>n</em>  <div id="rfc.iref.r.7"></div><div id="rfc.iref.a.8"></div></td><td>Figures (untitled)</td></tr><tr><td>rfc.index <div id="rfc.iref.r.8"></div><div id="rfc.iref.a.9"></div></td><td>Index</td></tr><tr><td>rfc.ipr <div id="rfc.iref.r.9"></div><div id="rfc.iref.a.10"></div></td><td>Intellectual Property</td></tr><tr><td>rfc.iref.<em>n</em>  <div id="rfc.iref.r.10"></div><div id="rfc.iref.a.11"></div></td><td>Internal references</td></tr><tr><td>rfc.note.<em>n</em>  <div id="rfc.iref.r.11"></div><div id="rfc.iref.a.12"></div></td><td>Notes (from front section)</td></tr><tr><td>rfc.references <div id="rfc.iref.r.12"></div><div id="rfc.iref.a.13"></div></td><td>References</td></tr><tr><td>rfc.references.<em>n</em>  <div id="rfc.iref.r.13"></div><div id="rfc.iref.a.14"></div></td><td>Additional references</td></tr><tr><td>rfc.section.<em>n</em>  <div id="rfc.iref.r.14"></div><div id="rfc.iref.a.15"></div></td><td>Section <em>n</em></td></tr><tr><td>rfc.section.<em>n</em>.p.<em>m</em>  <div id="rfc.iref.r.15"></div><div id="rfc.iref.a.16"></div></td><td>Section <em>n</em>, paragraph <em>m</em></td></tr><tr><td>rfc.status <div id="rfc.iref.r.16"></div><div id="rfc.iref.a.17"></div></td><td>Status of memo</td></tr><tr><td>rfc.table.<em>n</em>  <div id="rfc.iref.r.17"></div><div id="rfc.iref.a.18"></div></td><td>Tables (titled)</td></tr><tr><td>rfc.table.u.<em>n</em>  <div id="rfc.iref.r.18"></div><div id="rfc.iref.a.19"></div></td><td>Tables (untitled)</td></tr><tr><td>rfc.toc <div id="rfc.iref.r.19"></div><div id="rfc.iref.a.20"></div></td><td>Table of contents</td></tr><tr><td>rfc.xref.<em>name</em>.<em>n</em>  <div id="rfc.iref.r.20"></div><div id="rfc.iref.a.21"></div></td><td>References to reference <em>n</em> to <em>name</em></td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.5" class="np"><a href="#rfc.section.5">5.</a>&nbsp;<a id="xslt.engines" href="#xslt.engines">Supported XSLT engines</a></h1><p id="rfc.section.5.p.1">The transformation requires a non-standard extension function (see <a href="http://www.exslt.org/exsl/functions/node-set/exsl.node-set.html">exsl:node-set</a>) which is however widely available. XSLT processors that do not support this extension (or a functional equivalent) currently are not supported.</p><h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a>&nbsp;Standalone Engines</h2><p id="rfc.section.5.1.p.1">The following XSLT engines are believed to work well: </p><ul><li>Windows: <span id="rfc.iref.m.1"></span><span id="rfc.iref.m.2"></span>MSXML3 and MSXML4 (&lt;<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>&gt;; command line processor "msxsl" is available from <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41">Microsoft Download Center</a>)</li><li>Java: <span id="rfc.iref.s.8"></span>Saxon (&lt;<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>&gt;)</li><li>Java: <span id="rfc.iref.x.26"></span>Xalan (&lt;<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>&gt;)</li><li>C/C++: <span id="rfc.iref.x.27"></span>xsltproc (libxslt) (&lt;<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>&gt;, make sure that you have a current version)</li></ul><h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a>&nbsp;<a id="xslt.engines.browser" href="#xslt.engines.browser">In-Browser Engines</a></h2><p id="rfc.section.5.2.p.1">The following browsers seem to work fine: </p><ul><li><p><span id="rfc.iref.i.5"></span>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</p></li><li><p><span id="rfc.iref.i.6"></span><span id="rfc.iref.i.7"></span><span id="rfc.iref.i.8"></span>Internet Explorer 6 and newer</p></li><li><div id="firefox3"><p><span id="rfc.iref.m.3"></span><span id="rfc.iref.f.2"></span>Firefox 3.0 and newer</p></div><p> </p><ul><li>Be aware that XSLT execution can be suppressed using <span id="rfc.iref.n.2"></span><a href="https://addons.mozilla.org/de/firefox/addon/722">NoScript</a></li><li>Firefox does not load external DTDs nor external entities, see <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</a>, thus entities like &amp;nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix&nbsp;C.1</a>)</li></ul></li><li><p><span id="rfc.iref.s.9"></span><span id="rfc.iref.s.10"></span>Safari 3 (starting with version 3.0.4)</p></li><li><p><span id="rfc.iref.g.1"></span>Google Chrome (beta available)</p></li><li><p><span id="rfc.iref.o.1"></span>Opera 10 (beta version available)</p></li></ul><p id="rfc.section.5.2.p.2">The following browsers are known not to work properly: </p><ul><li><div id="firefox12"><p><span id="rfc.iref.m.4"></span><span id="rfc.iref.f.3"></span>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</a>)</p></div></li><li><div id="opera"><p><span id="rfc.iref.o.2"></span>Opera 9.21: execution fails, potentially to a somewhat complex XPath expression (reported to Opera as bug 245725).</p></div></li><li><p>Opera 9.5 and 9.6: transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</p></li><li><div id="safari"><p><span id="rfc.iref.s.11"></span>Safari 2.* supports client-side XSLT as of MacOS X 10.4, but misses required extension functions. A problem with stylesheets producing non-ASCII output (such as NBSP characters) has been fixed as of OSX 10.4.4. Both problems have been reported through Apple's bug tracking system, see &lt;<a href="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html">http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html</a>&gt; and &lt;<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>&gt;.</p></div></li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a>&nbsp;<a id="output.html" href="#output.html">Transforming to HTML</a></h1><p id="rfc.section.6.p.1">Transformation to HTML can be done inside the browser if it supports XSLT. To enable this, add the following processing instruction to the start of the source file:</p><div id="rfc.iref.x.28"></div><div id="rfc.figure.u.4"></div><pre class="text">  &lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?&gt;
    373373</pre><p id="rfc.section.6.p.3">(and ensure that <samp>rfc2629.xslt</samp> is present).</p><h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a>&nbsp;HTML compliance</h2><p id="rfc.section.6.1.p.1">The transformation result is supposed to conform to the HTML 4.01 strict DTD <a href="#HTML" id="rfc.xref.HTML.1"><cite title="HTML 4.01 Specification">[HTML]</cite></a>. This can be checked using the W3C's online validator at &lt;<a href="http://validator.w3.org">http://validator.w3.org</a>&gt;<span id="rfc.iref.h.2"></span>.</p><h2 id="rfc.section.6.2"><a href="#rfc.section.6.2">6.2</a>&nbsp;<a id="html.link" href="#html.link">Standard HTML LINK elements</a></h2><p id="rfc.section.6.2.p.1">LINK elements exist since HTML 2.0. They can be used to embed content-independant links inside the document. Unfortunately, only few user agents support this element. Firefox users may want to check the <a href="https://addons.mozilla.org/firefox/2933/">Link Widgets</a> extension.</p><div id="rfc.table.u.5"><p>The following LINK elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>LINK type</th><th>description</th></tr></thead><tbody><tr><td>alternate<div id="rfc.iref.a.22"></div><div id="rfc.iref.h.3"></div></td><td>for RFCs, a link to the authorative ASCII version on the IETF web site</td></tr><tr><td>appendic<div id="rfc.iref.a.23"></div><div id="rfc.iref.h.4"></div></td><td>pointer to all top-level appendics</td></tr><tr><td>author<div id="rfc.iref.a.24"></div><div id="rfc.iref.h.5"></div></td><td>pointer to "authors" section</td></tr><tr><td>chapter<div id="rfc.iref.c.3"></div><div id="rfc.iref.h.6"></div></td><td>pointer to all top-level sections</td></tr><tr><td>contents<div id="rfc.iref.c.4"></div><div id="rfc.iref.h.7"></div></td><td>pointer to table of contents</td></tr><tr><td>copyright<div id="rfc.iref.c.5"></div><div id="rfc.iref.h.8"></div></td><td>pointer to copyright statement</td></tr><tr><td>index<div id="rfc.iref.i.9"></div><div id="rfc.iref.h.9"></div></td><td>pointer to index</td></tr></tbody></table></div><div id="rfc.figure.u.5"></div> <p>The figure below shows how Mozilla Firefox 1.0 displays the Site Navigation Bar for rfc2396.xml.</p>  <p><img src="rfc2629xslt-fig1.png" alt="&#xA;(LINK elements displayed in Mozilla Firefox for RFC2396.xml)&#xA;" height="235" width="509"></p> <h2 id="rfc.section.6.3"><a href="#rfc.section.6.3">6.3</a>&nbsp;Standard HTML metadata</h2><div id="rfc.table.u.6"><p>The following standard HTML META elements are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td>generator<div id="rfc.iref.g.2"></div><div id="rfc.iref.h.10"></div></td><td>from XSLT engine version and stylesheet version</td></tr><tr><td>keywords<div id="rfc.iref.k.1"></div><div id="rfc.iref.h.11"></div></td><td>from keyword elements in front section</td></tr></tbody></table></div><h2 id="rfc.section.6.4"><a href="#rfc.section.6.4">6.4</a>&nbsp;<a id="rfc2731.properties" href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></h2><p id="rfc.section.6.4.p.1">Unless turned off using the "rfc-ext support-rfc2731" processing instruction, the transformation will generate metadata according to <a href="#RFC2731" id="rfc.xref.RFC2731.1"><cite title="Encoding Dublin Core Metadata in HTML">[RFC2731]</cite></a> and <a href="#DC-HTML" id="rfc.xref.DC-HTML.1"><cite title="Expressing Dublin Core metadata using HTML/XHTML meta and link elements">[DC-HTML]</cite></a>.</p><div id="rfc.table.u.7"><p>The following DCMI properties are produced:</p><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>META name</th><th>description</th></tr></thead><tbody><tr><td>DC.Creator<div id="rfc.iref.c.6"></div><div id="rfc.iref.d.2"></div></td><td>from author information in front section</td></tr><tr><td>DC.Date.Issued<div id="rfc.iref.d.3"></div><div id="rfc.iref.d.4"></div></td><td>from date information in front section</td></tr><tr><td>DC.Description.Abstract<div id="rfc.iref.d.5"></div><div id="rfc.iref.d.6"></div></td><td>from abstract</td></tr><tr><td>DC.Identifier<div id="rfc.iref.i.10"></div><div id="rfc.iref.d.7"></div></td><td>document URN <a href="#RFC2648" id="rfc.xref.RFC2648.1"><cite title="A URN Namespace for IETF Documents">[RFC2648]</cite></a> from "docName" attribute</td></tr><tr><td>DC.isPartOf<div id="rfc.iref.i.11"></div><div id="rfc.iref.d.8"></div></td><td>RFC ISSN (for RFCs)</td></tr><tr><td>DC.Relation.Replaces<div id="rfc.iref.r.21"></div><div id="rfc.iref.d.9"></div></td><td>from "obsoletes" attribute</td></tr></tbody></table></div><h2 id="rfc.section.6.5"><a href="#rfc.section.6.5">6.5</a>&nbsp;<a id="hcard" href="#hcard">Experimental hCard support</a></h2><p id="rfc.section.6.5.p.1">The generated author information is formatted in <a href="http://microformats.org/wiki/hcard">hCard</a> format.</p><hr class="noprint"><h1 id="rfc.section.7" class="np"><a href="#rfc.section.7">7.</a>&nbsp;<a id="output.xhtml" href="#output.xhtml">Transforming to XHTML</a></h1><p id="rfc.section.7.p.1">Transforming to XHTML requires slightly different XSLT output options and is implemented by the derived transformation script <samp>rfc2629toXHTML.xslt</samp>.</p><dl class="empty"><dd> <b>Note:</b> Microsoft Internet Explorer does <em>not</em> support XHTML. Therefore it usually makes more sense to generate plain old HTML.</dd></dl><hr class="noprint"><h1 id="rfc.section.8" class="np"><a href="#rfc.section.8">8.</a>&nbsp;<a id="output.chm" href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></h1><p id="rfc.section.8.p.1"> <span id="rfc.iref.c.7"></span>  <span id="rfc.iref.m.5"></span> To generate a CHM file using Microsoft's HTML Help Compiler (hhc), three files are required in addition to the HTML file. </p><ol><li>hhc - table of contents file (HTML)</li><li>hhk - index file (HTML)</li><li>hhp - project file (plain text)</li></ol><p id="rfc.section.8.p.2">The three files are generated with three specific transformations, each requiring the additional XSLT parameter "basename" to specify the filename prefix.</p><div id="rfc.figure.u.6"></div> <p>Example:</p>  <pre class="text">saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616  &gt; rfc2616.hhp
    374374saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616  &gt; rfc2616.hhc
     
    919919
    920920  &lt;!-- <em>allow later RFC2616 reference using "&amp;rfc2616;"</em> --&gt;
    921   &lt;!ENTITY rfc2616 PUBLIC ''
    922921  "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"&gt;
    923922
    924923]&gt;
    925 </pre><h2 id="rfc.section.C.2"><a href="#rfc.section.C.2">C.2</a>&nbsp;<a id="examples.customizing" href="#examples.customizing">Customization</a></h2><p id="rfc.section.C.2.p.1">The XSLT code can be customized by creating a custom XSLT file that uses &lt;xsl:import&gt; to include the original code, and just overrides particular rules.</p><div id="rfc.figure.u.23"></div> <p>For instance, the code below overrides several attributes in <samp>rfc2629toFO.xslt</samp>, changing the color, spacing and font family for headers.</p>  <pre class="text">&lt;xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
     924</pre>  <p>Note: including entities from a remote site will not work in Firefox, see &lt;<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">https://bugzilla.mozilla.org/show_bug.cgi?id=22942</a>&gt;.</p> <h2 id="rfc.section.C.2"><a href="#rfc.section.C.2">C.2</a>&nbsp;<a id="examples.customizing" href="#examples.customizing">Customization</a></h2><p id="rfc.section.C.2.p.1">The XSLT code can be customized by creating a custom XSLT file that uses &lt;xsl:import&gt; to include the original code, and just overrides particular rules.</p><div id="rfc.figure.u.23"></div> <p>For instance, the code below overrides several attributes in <samp>rfc2629toFO.xslt</samp>, changing the color, spacing and font family for headers.</p>  <pre class="text">&lt;xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    926925               version="1.0"&gt;
    927926
  • rfc2629xslt/rfc2629xslt.txt

    r662 r681  
    44RFC2629 through XSLT                                          J. Reschke
    55                                                              greenbytes
    6                                                           August 4, 2009
     6                                                         August 13, 2009
    77
    88
     
    779779         NoScript [3]
    780780
    781       *  Firefox does not load external DTDs, see Mozilla Bug 22942 [4],
    782          thus entities like &nbsp; need to be declared in the internal
    783          subset (Appendix C.1)
     781      *  Firefox does not load external DTDs nor external entities, see
     782         Mozilla Bug 22942 [4], thus entities like &nbsp; need to be
     783         declared in the internal subset (Appendix C.1)
    784784
    785785   o  Safari 3 (starting with version 3.0.4)
     
    25902590
    25912591     <!-- allow later RFC2616 reference using "&rfc2616;" -->
    2592      <!ENTITY rfc2616 PUBLIC ''
    25932592     "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml">
    25942593
    25952594   ]>
     2595
     2596   Note: including entities from a remote site will not work in Firefox,
     2597   see <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>.
    25962598
    25972599C.2.  Customization
     
    26002602   uses <xsl:import> to include the original code, and just overrides
    26012603   particular rules.
    2602 
    2603 
    26042604
    26052605
  • rfc2629xslt/rfc2629xslt.xml

    r662 r681  
    397397        <list style="symbols">
    398398          <t>Be aware that XSLT execution can be suppressed using <iref item="NoScript"/><eref target="https://addons.mozilla.org/de/firefox/addon/722">NoScript</eref></t>
    399           <t>Firefox does not load external DTDs, see <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</eref>, thus entities
     399          <t>Firefox does not load external DTDs nor external entities,
     400          see <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</eref>, thus entities
    400401          like &amp;nbsp; need to be declared in the internal subset (<xref target="examples.internalsubset"/>)</t>
    401402        </list>
     
    416417  The following browsers are known not to work properly:
    417418  <list style="symbols">
    418     <t anchor="firefox12"><iref item="Mozilla"/><iref item="Firefox" subitem="1.*/2.*"/>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla
    419     <eref target="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</eref>)</t>
    420     <t anchor="opera"><iref item="Opera"/>Opera 9.21: execution fails, potentially
    421     to a somewhat complex XPath expression (reported to Opera as bug 245725).</t>
    422     <t>Opera 9.5 and 9.6:
    423     transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</t>
    424     <t anchor="safari"><iref item="Safari"/>Safari 2.* supports client-side XSLT as of MacOS X 10.4,
    425     but misses required extension functions. A problem
    426     with stylesheets producing non-ASCII output (such as NBSP characters)
    427     has been fixed as of OSX 10.4.4. Both
    428     problems have been reported through Apple's bug tracking system, see
    429     <eref target="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html"/> and
    430     <eref target="http://bugs.webkit.org/show_bug.cgi?id=4079"/>.
    431     </t>
     419    <x:lt>
     420      <t anchor="firefox12"><iref item="Mozilla"/><iref item="Firefox" subitem="1.*/2.*"/>Firefox 1.*/2.*: (missing extension function - see change request at Mozilla BugZilla
     421      <eref target="http://bugzilla.mozilla.org/show_bug.cgi?id=193678">193678</eref>)</t>
     422    </x:lt>
     423    <x:lt>
     424      <t anchor="opera"><iref item="Opera"/>Opera 9.21: execution fails, potentially
     425      to a somewhat complex XPath expression (reported to Opera as bug 245725).</t>
     426    </x:lt>
     427    <x:lt>
     428      <t>Opera 9.5 and 9.6:
     429      transformation appears to work, but CSS isn't getting applied (reported to Opera as bug 337388 on 2008-06-12).</t>
     430    </x:lt>
     431    <x:lt>
     432      <t anchor="safari"><iref item="Safari"/>Safari 2.* supports client-side XSLT as of MacOS X 10.4,
     433      but misses required extension functions. A problem
     434      with stylesheets producing non-ASCII output (such as NBSP characters)
     435      has been fixed as of OSX 10.4.4. Both
     436      problems have been reported through Apple's bug tracking system, see
     437      <eref target="http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/2005-May/002073.html"/> and
     438      <eref target="http://bugs.webkit.org/show_bug.cgi?id=4079"/>.
     439      </t>
     440    </x:lt>
    432441  </list>
    433442</t>
     
    22462255
    22472256  &lt;!-- <spanx>allow later RFC2616 reference using "&amp;rfc2616;"</spanx> -->
    2248   &lt;!ENTITY rfc2616 PUBLIC ''
    22492257  "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml">
    22502258
    22512259]>
    2252 </artwork></figure>
     2260</artwork>
     2261<postamble>
     2262  Note: including entities from a remote site will not work in Firefox,
     2263  see <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=22942"/>.</postamble>
     2264</figure>
    22532265 
    22542266  </section>
Note: See TracChangeset for help on using the changeset viewer.