![(please configure the [header_logo] section in trac.ini)](https://www.ietf.org/images/ietflogotrans.gif)
Changeset 681
- Timestamp:
- 13/08/09 13:08:47 (13 years ago)
- Location:
- rfc2629xslt
- Files:
-
- 7 edited
-
clean-for-DTD.xslt (modified) (1 diff)
-
rfc2629toHhk.xslt (modified) (1 diff)
-
rfc2629xslt.chm (modified) (previous)
-
rfc2629xslt.html (modified) (2 diffs)
-
rfc2629xslt.pdf (modified) (previous)
-
rfc2629xslt.txt (modified) (4 diffs)
-
rfc2629xslt.xml (modified) (3 diffs)
Legend:
- Unmodified
- Added
- Removed
-
rfc2629xslt/clean-for-DTD.xslt
r588 r681 84 84 85 85 <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"/> 86 88 87 89 <!-- add issues appendix --> -
rfc2629xslt/rfc2629toHhk.xslt
r571 r681 24 24 <html> 25 25 <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 $" /> 27 27 </head> 28 28 <body> -
rfc2629xslt/rfc2629xslt.html
r662 r681 370 370 --param xml2rfc-ext-support-rfc2731 '"no"' \ 371 371 rfc2629.xslt source.xml > 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> 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> 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> 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 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 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> <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> <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> 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 (<<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>>; 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 (<<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>>)</li><li>Java: <span id="rfc.iref.x.26"></span>Xalan (<<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>>)</li><li>C/C++: <span id="rfc.iref.x.27"></span>xsltproc (libxslt) (<<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>>, 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> <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 &nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix 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 <<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>> and <<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>>.</li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a> <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"> <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>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> 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> 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> 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 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 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> <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> <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> 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 (<<a href="http://msdn.microsoft.com/xml">http://msdn.microsoft.com/xml</a>>; 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 (<<a href="http://saxon.sourceforge.net/">http://saxon.sourceforge.net/</a>>)</li><li>Java: <span id="rfc.iref.x.26"></span>Xalan (<<a href="http://xml.apache.org/xalan-j/">http://xml.apache.org/xalan-j/</a>>)</li><li>C/C++: <span id="rfc.iref.x.27"></span>xsltproc (libxslt) (<<a href="http://xmlsoft.org/XSLT/">http://xmlsoft.org/XSLT/</a>>, 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> <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 &nbsp; need to be declared in the internal subset (<a href="#examples.internalsubset" title="Using the 'Internal Subset'">Appendix 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 <<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>> and <<a href="http://bugs.webkit.org/show_bug.cgi?id=4079">http://bugs.webkit.org/show_bug.cgi?id=4079</a>>.</p></div></li></ul><hr class="noprint"><h1 id="rfc.section.6" class="np"><a href="#rfc.section.6">6.</a> <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"> <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> 373 373 </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> 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 <<a href="http://validator.w3.org">http://validator.w3.org</a>><span id="rfc.iref.h.2"></span>.</p><h2 id="rfc.section.6.2"><a href="#rfc.section.6.2">6.2</a> <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="
(LINK elements displayed in Mozilla Firefox for RFC2396.xml)
" height="235" width="509"></p> <h2 id="rfc.section.6.3"><a href="#rfc.section.6.3">6.3</a> 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> <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> <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> <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> <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 > rfc2616.hhp 374 374 saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616 > rfc2616.hhc … … 919 919 920 920 <!-- <em>allow later RFC2616 reference using "&rfc2616;"</em> --> 921 <!ENTITY rfc2616 PUBLIC ''922 921 "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"> 923 922 924 923 ]> 925 </pre> <h2 id="rfc.section.C.2"><a href="#rfc.section.C.2">C.2</a> <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 <xsl:import> 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"><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 <<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">https://bugzilla.mozilla.org/show_bug.cgi?id=22942</a>>.</p> <h2 id="rfc.section.C.2"><a href="#rfc.section.C.2">C.2</a> <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 <xsl:import> 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"><xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 926 925 version="1.0"> 927 926 -
rfc2629xslt/rfc2629xslt.txt
r662 r681 4 4 RFC2629 through XSLT J. Reschke 5 5 greenbytes 6 August 4, 20096 August 13, 2009 7 7 8 8 … … 779 779 NoScript [3] 780 780 781 * Firefox does not load external DTDs , see Mozilla Bug 22942 [4],782 thus entities like need to be declared in the internal783 subset (Appendix C.1)781 * Firefox does not load external DTDs nor external entities, see 782 Mozilla Bug 22942 [4], thus entities like need to be 783 declared in the internal subset (Appendix C.1) 784 784 785 785 o Safari 3 (starting with version 3.0.4) … … 2590 2590 2591 2591 <!-- allow later RFC2616 reference using "&rfc2616;" --> 2592 <!ENTITY rfc2616 PUBLIC ''2593 2592 "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"> 2594 2593 2595 2594 ]> 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>. 2596 2598 2597 2599 C.2. Customization … … 2600 2602 uses <xsl:import> to include the original code, and just overrides 2601 2603 particular rules. 2602 2603 2604 2604 2605 2605 -
rfc2629xslt/rfc2629xslt.xml
r662 r681 397 397 <list style="symbols"> 398 398 <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 400 401 like &nbsp; need to be declared in the internal subset (<xref target="examples.internalsubset"/>)</t> 401 402 </list> … … 416 417 The following browsers are known not to work properly: 417 418 <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> 432 441 </list> 433 442 </t> … … 2246 2255 2247 2256 <!-- <spanx>allow later RFC2616 reference using "&rfc2616;"</spanx> --> 2248 <!ENTITY rfc2616 PUBLIC ''2249 2257 "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"> 2250 2258 2251 2259 ]> 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> 2253 2265 2254 2266 </section>
Note: See TracChangeset
for help on using the changeset viewer.
