![(please configure the [header_logo] section in trac.ini)](https://www.ietf.org/images/ietflogotrans.gif)
Changeset 1443 for rfc2629xslt
- Timestamp:
- Oct 2, 2011, 1:16:36 AM (8 years ago)
- Location:
- rfc2629xslt
- Files:
-
- 4 edited
-
rfc2629xslt.html (modified) (2 diffs)
-
rfc2629xslt.pdf (modified) (previous)
-
rfc2629xslt.txt (modified) (82 diffs)
-
rfc2629xslt.xml (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
-
rfc2629xslt/rfc2629xslt.html
r1426 r1443 356 356 } 357 357 @top-right { 358 content: " August2011";358 content: "September 2011"; 359 359 } 360 360 @top-center { … … 383 383 } 384 384 } 385 </style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Introduction" href="#rfc.section.1"><link rel="Chapter" title="2 Supported RFC2629 elements" href="#rfc.section.2"><link rel="Chapter" title="3 Processing Instructions" href="#rfc.section.3"><link rel="Chapter" title="4 Anchors" href="#rfc.section.4"><link rel="Chapter" title="5 Supported XSLT engines" href="#rfc.section.5"><link rel="Chapter" title="6 Transforming to HTML" href="#rfc.section.6"><link rel="Chapter" title="7 Transforming to XHTML" href="#rfc.section.7"><link rel="Chapter" title="8 Transforming to CHM (Microsoft Compiled Help)" href="#rfc.section.8"><link rel="Chapter" title="9 Transforming to PDF" href="#rfc.section.9"><link rel="Chapter" title="10 Transforming to ePub" href="#rfc.section.10"><link rel="Chapter" title="11 Generic Extensions" href="#rfc.section.11"><link rel="Chapter" title="12 Utilities" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 Informative References"><link rel="Appendix" title="A RELAX NG Compact Schema" href="#rfc.section.A"><link rel="Appendix" title="B Implementation Notes" href="#rfc.section.B"><link rel="Appendix" title="C Examples" href="#rfc.section.C"><link rel="Appendix" title="D Producing the IETF 'Boilerplate'" href="#rfc.section.D"><link rel="Appendix" title="E License" href="#rfc.section.E"><link rel="Appendix" title="F Change Logs" href="#rfc.section.F"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.556, 2011-08-28 20:30:48, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, xml2rfc, XSLT, hCard, XSL-FO, PDF, GRDDL, epub, Dublin Core"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 through XSLT</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right"> August 2011</td></tr></tbody></table><p class="title">Transforming RFC2629-formatted XML through XSLT</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1. <a href="#rfc.section.1">Introduction</a></li><li>2. <a href="#supported.elements">Supported RFC2629 elements</a><ul><li>2.1 <a href="#rfc.section.2.1">Extension elements</a></li></ul></li><li>3. <a href="#processing.instructions">Processing Instructions</a><ul><li>3.1 <a href="#rfc.section.3.1">Supported xml2rfc-compatible PIs</a></li><li>3.2 <a href="#rfc.section.3.2">Unsupported xml2rfc-compatible PIs</a></li><li>3.3 <a href="#rfc.section.3.3">Extension PIs</a></li></ul></li><li>4. <a href="#anchors">Anchors</a></li><li>5. <a href="#xslt.engines">Supported XSLT engines</a><ul><li>5.1 <a href="#rfc.section.5.1">Standalone Engines</a></li><li>5.2 <a href="#xslt.engines.browser">In-Browser Engines</a></li></ul></li><li>6. <a href="#output.html">Transforming to HTML</a><ul><li>6.1 <a href="#rfc.section.6.1">HTML compliance</a></li><li>6.2 <a href="#html.link">Standard HTML LINK elements</a></li><li>6.3 <a href="#rfc.section.6.3">Standard HTML metadata</a></li><li>6.4 <a href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></li><li>6.5 <a href="#hcard">Experimental hCard support</a></li></ul></li><li>7. <a href="#output.xhtml">Transforming to XHTML</a></li><li>8. <a href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></li><li>9. <a href="#output.pdf">Transforming to PDF</a><ul><li>9.1 <a href="#output.pdf.fop">Via XSL-FO</a><ul><li>9.1.1 <a href="#rfc.section.9.1.1">Extension feature matrix</a></li><li>9.1.2 <a href="#rfc.section.9.1.2">Example: producing output for Apache FOP</a></li></ul></li><li>9.2 <a href="#output.pdf.html">Via X(HTML)</a></li></ul></li><li>10. <a href="#output.epub">Transforming to ePub</a></li><li>11. <a href="#extensions">Generic Extensions</a><ul><li>11.1 <a href="#ext.element.abnf-char-sequence"><abnf-char-sequence> element</a></li><li>11.2 <a href="#ext.element.anchor-alias"><anchor-alias> element</a></li><li>11.3 <a href="#ext.element.bcp14"><bcp14> element</a></li><li>11.4 <a href="#ext.element.bb"><bb> element</a></li><li>11.5 <a href="#ext.element.bc"><bc> element</a></li><li>11.6 <a href="#ext.element.blockquote"><blockquote> element</a></li><li>11.7 <a href="#ext.element.boilerplate"><boilerplate> element</a></li><li>11.8 <a href="#ext.element.bt"><bt> element</a></li><li>11.9 <a href="#ext.element.dfn"><dfn> element</a></li><li>11.10 <a href="#ext.element.h"><h> element</a></li><li>11.11 <a href="#ext.element.highlight"><highlight> element</a></li><li>11.12 <a href="#ext.element.length-of"><length-of> element</a></li><li>11.13 <a href="#ext.element.link"><link> element</a></li><li>11.14 <a href="#ext.element.lt"><lt> element</a></li><li>11.15 <a href="#ext.element.note"><note> element</a></li><li>11.16 <a href="#ext.element.parse-xml"><parse-xml> element</a></li><li>11.17 <a href="#ext.element.prose"><prose> element</a></li><li>11.18 <a href="#ext.element.q"><q> element</a></li><li>11.19 <a href="#ext.element.ref"><ref> element</a></li><li>11.20 <a href="#ext.element.source"><source> element</a></li><li>11.21 <a href="#ext.element.sup"><sup> element</a></li><li>11.22 <a href="#ext-rfc2629.artwork">Extensions to Xml2rfc <artwork> element</a></li><li>11.23 <a href="#ext-rfc2629.iref">Extensions to Xml2rfc <iref> element</a></li><li>11.24 <a href="#ext-rfc2629.list">Extensions to Xml2rfc <list> element</a></li><li>11.25 <a href="#ext-rfc2629.rfc">Extensions to Xml2rfc <rfc> element</a></li><li>11.26 <a href="#ext-rfc2629.section">Extensions to Xml2rfc <section> element</a></li><li>11.27 <a href="#ext-rfc2629.xref">Extensions to Xml2rfc <xref> element</a></li></ul></li><li>12. <a href="#utilities">Utilities</a><ul><li>12.1 <a href="#checking-references">Checking References</a></li><li>12.2 <a href="#rfc.section.12.2">Generating Graphs from References</a></li><li>12.3 <a href="#rfc.section.12.3">Producing reference entries for books</a></li><li>12.4 <a href="#clean-for-dtd">Down-converting to RFC2629bis DTD</a></li><li>12.5 <a href="#extract-artwork">Extracting artwork</a></li><li>12.6 <a href="#grddl">GRRDL</a></li></ul></li><li>13. <a href="#rfc.references">Informative References</a></li><li><a href="#rfc.authors">Author's Address</a></li><li>A. <a href="#grammar">RELAX NG Compact Schema</a></li><li>B. <a href="#rfc.section.B">Implementation Notes</a><ul><li>B.1 <a href="#rfc.section.B.1">Recognized type attributes for <artwork> element</a></li></ul></li><li>C. <a href="#examples">Examples</a><ul><li>C.1 <a href="#examples.internalsubset">Using the 'Internal Subset'</a></li><li>C.2 <a href="#examples.customizing">Customization</a></li></ul></li><li>D. <a href="#boilerplate">Producing the IETF 'Boilerplate'</a><ul><li>D.1 <a href="#attribute-ipr">The /rfc/@ipr Attribute</a><ul><li>D.1.1 <a href="#attribute-ipr-current">Current Values: '*trust200902'</a><ul><li>D.1.1.1 <a href="#attribute-ipr-trust200902">trust200902</a></li><li>D.1.1.2 <a href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></li><li>D.1.1.3 <a href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></li><li>D.1.1.4 <a href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></li></ul></li><li>D.1.2 <a href="#attribute-ipr-historic">Historic Values</a><ul><li>D.1.2.1 <a href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></li><li>D.1.2.2 <a href="#attribute-ipr-3978">Historic Values: '*3978'</a></li><li>D.1.2.3 <a href="#attribute-ipr-3667">Historic Values: '*3667'</a></li><li>D.1.2.4 <a href="#attribute-ipr-2026">Historic Values: '*2026'</a></li></ul></li></ul></li><li>D.2 <a href="#attribute-category">The /rfc/@category Attribute</a></li><li>D.3 <a href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></li><li>D.4 <a href="#attribute-consensus">The /rfc/@consensus Attribute</a></li><li>D.5 <a href="#attribute-number">The /rfc/@number Attribute</a></li><li>D.6 <a href="#attribute-docname">The /rfc/@docName Attribute</a></li><li>D.7 <a href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></li><li>D.8 <a href="#attribute-updates">The /rfc/@updates Attribute</a></li></ul></li><li>E. <a href="#license">License</a></li><li>F. <a href="#rfc.section.F">Change Logs</a><ul><li>F.1 <a href="#rfc.section.F.1">Package</a></li><li>F.2 <a href="#rfc.section.F.2">amazon-asin.xslt</a></li><li>F.3 <a href="#rfc.section.F.3">check-references.xslt</a></li><li>F.4 <a href="#rfc.section.F.4">gen-reference-graph.xslt</a></li><li>F.5 <a href="#rfc.section.F.5">rfc2629.xslt</a></li><li>F.6 <a href="#rfc.section.F.6">rfc2629toFO.xslt</a></li><li>F.7 <a href="#rfc.section.F.7">xsl11toAn.xslt</a></li><li>F.8 <a href="#rfc.section.F.8">xsl11toFop.xslt</a></li><li>F.9 <a href="#rfc.section.F.9">xsl11toXep.xslt</a></li></ul></li><li><a href="#rfc.index">Index</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a> Introduction</h1><p id="rfc.section.1.p.1">This document describes a set of XSLT transformations that can be used to transform RFC2629-compliant XML (see <a href="#RFC2629" id="rfc.xref.RFC2629.1"><cite title="Writing I-Ds and RFCs using XML">[RFC2629]</cite></a>) to various output formats, such as HTML and PDF. The main topics are </p><ul><li>compliance to the xml2rfc XML element set (<a href="#supported.elements" title="Supported RFC2629 elements">Section 2</a>),</li><li>support for xml2rfc processing instructions (<a href="#processing.instructions" title="Processing Instructions">Section 3</a>),</li><li>the names of anchor elements generated in HTML and PDF output (<a href="#anchors" title="Anchors">Section 4</a>),</li><li>various XSLT engines that can be used (<a href="#xslt.engines" title="Supported XSLT engines">Section 5</a>),</li><li>outputting HTML (<a href="#output.html" title="Transforming to HTML">Section 6</a>) and XHTML (<a href="#output.xhtml" title="Transforming to XHTML">Section 7</a>),</li><li>outputting CHM (Compiled Microsoft Help, <a href="#output.chm" title="Transforming to CHM (Microsoft Compiled Help)">Section 8</a>),</li><li>outputting PDF (<a href="#output.pdf" title="Transforming to PDF">Section 9</a>),</li><li>extensions to the xml2rfc vocabulary (<a href="#extensions" title="Generic Extensions">Section 11</a>).</li><li>various utilities (<a href="#utilities" title="Utilities">Section 12</a>).</li></ul><p id="rfc.section.1.p.2">The full distribution is available at <<a href="http://greenbytes.de/tech/webdav/rfc2629xslt.zip">http://greenbytes.de/tech/webdav/rfc2629xslt.zip</a>>.</p><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a> <a id="supported.elements" href="#supported.elements">Supported RFC2629 elements</a></h1><p id="rfc.section.2.p.1"> <samp>rfc2629.xslt</samp> supports both all RFC2629 grammar elements and the extensions implemented in xml2rfc 1.36.</p><h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a> Extension elements</h2><p id="rfc.section.2.1.p.1"> <samp>rfc2629.xslt</samp> supports two kind of extension elements, using different XML namespaces.</p><p id="rfc.section.2.1.p.2">The first set contains (hopefully) generally useful extensions, see <a href="#extensions" title="Generic Extensions">Section 11</a>.</p><p id="rfc.section.2.1.p.3">The second set is used for change and issue tracking and currently is not documented here. Please email the author in case you're interested in using these extensions.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a> <a id="processing.instructions" href="#processing.instructions">Processing Instructions</a></h1><p id="rfc.section.3.p.1">All PIs can be set as XSLT parameter as well, overriding any value that is found in the source file to be transformed.</p><div id="rfc.figure.u.1"></div> <p>Using processing instructions:</p> <pre class="text"><?rfc toc="yes"?>385 </style><link rel="Contents" href="#rfc.toc"><link rel="Author" href="#rfc.authors"><link rel="Index" href="#rfc.index"><link rel="Chapter" title="1 Introduction" href="#rfc.section.1"><link rel="Chapter" title="2 Supported RFC2629 elements" href="#rfc.section.2"><link rel="Chapter" title="3 Processing Instructions" href="#rfc.section.3"><link rel="Chapter" title="4 Anchors" href="#rfc.section.4"><link rel="Chapter" title="5 Supported XSLT engines" href="#rfc.section.5"><link rel="Chapter" title="6 Transforming to HTML" href="#rfc.section.6"><link rel="Chapter" title="7 Transforming to XHTML" href="#rfc.section.7"><link rel="Chapter" title="8 Transforming to CHM (Microsoft Compiled Help)" href="#rfc.section.8"><link rel="Chapter" title="9 Transforming to PDF" href="#rfc.section.9"><link rel="Chapter" title="10 Transforming to ePub" href="#rfc.section.10"><link rel="Chapter" title="11 Generic Extensions" href="#rfc.section.11"><link rel="Chapter" title="12 Utilities" href="#rfc.section.12"><link rel="Chapter" href="#rfc.section.13" title="13 Informative References"><link rel="Appendix" title="A RELAX NG Compact Schema" href="#rfc.section.A"><link rel="Appendix" title="B Implementation Notes" href="#rfc.section.B"><link rel="Appendix" title="C Examples" href="#rfc.section.C"><link rel="Appendix" title="D Producing the IETF 'Boilerplate'" href="#rfc.section.D"><link rel="Appendix" title="E License" href="#rfc.section.E"><link rel="Appendix" title="F Change Logs" href="#rfc.section.F"><meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.556, 2011-08-28 20:30:48, XSLT vendor: SAXON 6.5.5 from Michael Kay http://saxon.sf.net/"><meta name="keywords" content="RFC2629, xml2rfc, XSLT, hCard, XSL-FO, PDF, GRDDL, epub, Dublin Core"><link rel="schema.dct" href="http://purl.org/dc/terms/"><meta name="dct.creator" content="Reschke, J. F."></head><body><table class="header"><tbody><tr><td class="left">RFC2629 through XSLT</td><td class="right">J. Reschke</td></tr><tr><td class="left"></td><td class="right">greenbytes</td></tr><tr><td class="left"></td><td class="right">September 2011</td></tr></tbody></table><p class="title">Transforming RFC2629-formatted XML through XSLT</p><hr class="noprint"><h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1><ul class="toc"><li>1. <a href="#rfc.section.1">Introduction</a></li><li>2. <a href="#supported.elements">Supported RFC2629 elements</a><ul><li>2.1 <a href="#rfc.section.2.1">Extension elements</a></li></ul></li><li>3. <a href="#processing.instructions">Processing Instructions</a><ul><li>3.1 <a href="#rfc.section.3.1">Supported xml2rfc-compatible PIs</a></li><li>3.2 <a href="#rfc.section.3.2">Unsupported xml2rfc-compatible PIs</a></li><li>3.3 <a href="#rfc.section.3.3">Extension PIs</a></li></ul></li><li>4. <a href="#anchors">Anchors</a></li><li>5. <a href="#xslt.engines">Supported XSLT engines</a><ul><li>5.1 <a href="#rfc.section.5.1">Standalone Engines</a></li><li>5.2 <a href="#xslt.engines.browser">In-Browser Engines</a></li></ul></li><li>6. <a href="#output.html">Transforming to HTML</a><ul><li>6.1 <a href="#rfc.section.6.1">HTML compliance</a></li><li>6.2 <a href="#html.link">Standard HTML LINK elements</a></li><li>6.3 <a href="#rfc.section.6.3">Standard HTML metadata</a></li><li>6.4 <a href="#rfc2731.properties">Dublin Core (RFC2731) metadata</a></li><li>6.5 <a href="#hcard">Experimental hCard support</a></li></ul></li><li>7. <a href="#output.xhtml">Transforming to XHTML</a></li><li>8. <a href="#output.chm">Transforming to CHM (Microsoft Compiled Help)</a></li><li>9. <a href="#output.pdf">Transforming to PDF</a><ul><li>9.1 <a href="#output.pdf.fop">Via XSL-FO</a><ul><li>9.1.1 <a href="#rfc.section.9.1.1">Extension feature matrix</a></li><li>9.1.2 <a href="#rfc.section.9.1.2">Example: producing output for Apache FOP</a></li></ul></li><li>9.2 <a href="#output.pdf.html">Via X(HTML)</a></li></ul></li><li>10. <a href="#output.epub">Transforming to ePub</a></li><li>11. <a href="#extensions">Generic Extensions</a><ul><li>11.1 <a href="#ext.element.abnf-char-sequence"><abnf-char-sequence> element</a></li><li>11.2 <a href="#ext.element.anchor-alias"><anchor-alias> element</a></li><li>11.3 <a href="#ext.element.bcp14"><bcp14> element</a></li><li>11.4 <a href="#ext.element.bb"><bb> element</a></li><li>11.5 <a href="#ext.element.bc"><bc> element</a></li><li>11.6 <a href="#ext.element.blockquote"><blockquote> element</a></li><li>11.7 <a href="#ext.element.boilerplate"><boilerplate> element</a></li><li>11.8 <a href="#ext.element.bt"><bt> element</a></li><li>11.9 <a href="#ext.element.dfn"><dfn> element</a></li><li>11.10 <a href="#ext.element.h"><h> element</a></li><li>11.11 <a href="#ext.element.highlight"><highlight> element</a></li><li>11.12 <a href="#ext.element.length-of"><length-of> element</a></li><li>11.13 <a href="#ext.element.link"><link> element</a></li><li>11.14 <a href="#ext.element.lt"><lt> element</a></li><li>11.15 <a href="#ext.element.note"><note> element</a></li><li>11.16 <a href="#ext.element.parse-xml"><parse-xml> element</a></li><li>11.17 <a href="#ext.element.prose"><prose> element</a></li><li>11.18 <a href="#ext.element.q"><q> element</a></li><li>11.19 <a href="#ext.element.ref"><ref> element</a></li><li>11.20 <a href="#ext.element.source"><source> element</a></li><li>11.21 <a href="#ext.element.sup"><sup> element</a></li><li>11.22 <a href="#ext-rfc2629.artwork">Extensions to Xml2rfc <artwork> element</a></li><li>11.23 <a href="#ext-rfc2629.iref">Extensions to Xml2rfc <iref> element</a></li><li>11.24 <a href="#ext-rfc2629.list">Extensions to Xml2rfc <list> element</a></li><li>11.25 <a href="#ext-rfc2629.rfc">Extensions to Xml2rfc <rfc> element</a></li><li>11.26 <a href="#ext-rfc2629.section">Extensions to Xml2rfc <section> element</a></li><li>11.27 <a href="#ext-rfc2629.xref">Extensions to Xml2rfc <xref> element</a></li></ul></li><li>12. <a href="#utilities">Utilities</a><ul><li>12.1 <a href="#checking-references">Checking References</a></li><li>12.2 <a href="#rfc.section.12.2">Generating Graphs from References</a></li><li>12.3 <a href="#rfc.section.12.3">Producing reference entries for books</a></li><li>12.4 <a href="#clean-for-dtd">Down-converting to RFC2629bis DTD</a></li><li>12.5 <a href="#extract-artwork">Extracting artwork</a></li><li>12.6 <a href="#grddl">GRRDL</a></li></ul></li><li>13. <a href="#rfc.references">Informative References</a></li><li><a href="#rfc.authors">Author's Address</a></li><li>A. <a href="#grammar">RELAX NG Compact Schema</a></li><li>B. <a href="#rfc.section.B">Implementation Notes</a><ul><li>B.1 <a href="#rfc.section.B.1">Recognized type attributes for <artwork> element</a></li></ul></li><li>C. <a href="#examples">Examples</a><ul><li>C.1 <a href="#examples.internalsubset">Using the 'Internal Subset'</a></li><li>C.2 <a href="#examples.customizing">Customization</a></li></ul></li><li>D. <a href="#boilerplate">Producing the IETF 'Boilerplate'</a><ul><li>D.1 <a href="#attribute-ipr">The /rfc/@ipr Attribute</a><ul><li>D.1.1 <a href="#attribute-ipr-current">Current Values: '*trust200902'</a><ul><li>D.1.1.1 <a href="#attribute-ipr-trust200902">trust200902</a></li><li>D.1.1.2 <a href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></li><li>D.1.1.3 <a href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></li><li>D.1.1.4 <a href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></li></ul></li><li>D.1.2 <a href="#attribute-ipr-historic">Historic Values</a><ul><li>D.1.2.1 <a href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></li><li>D.1.2.2 <a href="#attribute-ipr-3978">Historic Values: '*3978'</a></li><li>D.1.2.3 <a href="#attribute-ipr-3667">Historic Values: '*3667'</a></li><li>D.1.2.4 <a href="#attribute-ipr-2026">Historic Values: '*2026'</a></li></ul></li></ul></li><li>D.2 <a href="#attribute-category">The /rfc/@category Attribute</a></li><li>D.3 <a href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></li><li>D.4 <a href="#attribute-consensus">The /rfc/@consensus Attribute</a></li><li>D.5 <a href="#attribute-number">The /rfc/@number Attribute</a></li><li>D.6 <a href="#attribute-docname">The /rfc/@docName Attribute</a></li><li>D.7 <a href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></li><li>D.8 <a href="#attribute-updates">The /rfc/@updates Attribute</a></li></ul></li><li>E. <a href="#license">License</a></li><li>F. <a href="#rfc.section.F">Change Logs</a><ul><li>F.1 <a href="#rfc.section.F.1">Package</a></li><li>F.2 <a href="#rfc.section.F.2">amazon-asin.xslt</a></li><li>F.3 <a href="#rfc.section.F.3">check-references.xslt</a></li><li>F.4 <a href="#rfc.section.F.4">gen-reference-graph.xslt</a></li><li>F.5 <a href="#rfc.section.F.5">rfc2629.xslt</a></li><li>F.6 <a href="#rfc.section.F.6">rfc2629toFO.xslt</a></li><li>F.7 <a href="#rfc.section.F.7">xsl11toAn.xslt</a></li><li>F.8 <a href="#rfc.section.F.8">xsl11toFop.xslt</a></li><li>F.9 <a href="#rfc.section.F.9">xsl11toXep.xslt</a></li></ul></li><li><a href="#rfc.index">Index</a></li></ul><hr class="noprint"><h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a> Introduction</h1><p id="rfc.section.1.p.1">This document describes a set of XSLT transformations that can be used to transform RFC2629-compliant XML (see <a href="#RFC2629" id="rfc.xref.RFC2629.1"><cite title="Writing I-Ds and RFCs using XML">[RFC2629]</cite></a>) to various output formats, such as HTML and PDF. The main topics are </p><ul><li>compliance to the xml2rfc XML element set (<a href="#supported.elements" title="Supported RFC2629 elements">Section 2</a>),</li><li>support for xml2rfc processing instructions (<a href="#processing.instructions" title="Processing Instructions">Section 3</a>),</li><li>the names of anchor elements generated in HTML and PDF output (<a href="#anchors" title="Anchors">Section 4</a>),</li><li>various XSLT engines that can be used (<a href="#xslt.engines" title="Supported XSLT engines">Section 5</a>),</li><li>outputting HTML (<a href="#output.html" title="Transforming to HTML">Section 6</a>) and XHTML (<a href="#output.xhtml" title="Transforming to XHTML">Section 7</a>),</li><li>outputting CHM (Compiled Microsoft Help, <a href="#output.chm" title="Transforming to CHM (Microsoft Compiled Help)">Section 8</a>),</li><li>outputting PDF (<a href="#output.pdf" title="Transforming to PDF">Section 9</a>),</li><li>outputting ePub (<a href="#output.epub" title="Transforming to ePub">Section 10</a>),</li><li>extensions to the xml2rfc vocabulary (<a href="#extensions" title="Generic Extensions">Section 11</a>).</li><li>various utilities (<a href="#utilities" title="Utilities">Section 12</a>).</li></ul><p id="rfc.section.1.p.2">The full distribution is available at <<a href="http://greenbytes.de/tech/webdav/rfc2629xslt.zip">http://greenbytes.de/tech/webdav/rfc2629xslt.zip</a>>.</p><hr class="noprint"><h1 id="rfc.section.2" class="np"><a href="#rfc.section.2">2.</a> <a id="supported.elements" href="#supported.elements">Supported RFC2629 elements</a></h1><p id="rfc.section.2.p.1"> <samp>rfc2629.xslt</samp> supports both all RFC2629 grammar elements and the extensions implemented in xml2rfc 1.36.</p><h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a> Extension elements</h2><p id="rfc.section.2.1.p.1"> <samp>rfc2629.xslt</samp> supports two kind of extension elements, using different XML namespaces.</p><p id="rfc.section.2.1.p.2">The first set contains (hopefully) generally useful extensions, see <a href="#extensions" title="Generic Extensions">Section 11</a>.</p><p id="rfc.section.2.1.p.3">The second set is used for change and issue tracking and currently is not documented here. Please email the author in case you're interested in using these extensions.</p><hr class="noprint"><h1 id="rfc.section.3" class="np"><a href="#rfc.section.3">3.</a> <a id="processing.instructions" href="#processing.instructions">Processing Instructions</a></h1><p id="rfc.section.3.p.1">All PIs can be set as XSLT parameter as well, overriding any value that is found in the source file to be transformed.</p><div id="rfc.figure.u.1"></div> <p>Using processing instructions:</p> <pre class="text"><?rfc toc="yes"?> 386 386 <?rfc-ext support-rfc2731="no"?> 387 387 </pre> <div id="rfc.figure.u.2"></div> <p>Using XSLT parameters (Saxon):</p> <pre class="text">java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \ -
rfc2629xslt/rfc2629xslt.txt
r1426 r1443 4 4 RFC2629 through XSLT J. Reschke 5 5 greenbytes 6 August 28, 20116 September 26, 2011 7 7 8 8 … … 56 56 57 57 58 Documentation RFC2629 through XSLT August201158 Documentation RFC2629 through XSLT September 2011 59 59 60 60 … … 113 113 114 114 115 Documentation RFC2629 through XSLT August2011115 Documentation RFC2629 through XSLT September 2011 116 116 117 117 … … 170 170 171 171 172 Documentation RFC2629 through XSLT August2011172 Documentation RFC2629 through XSLT September 2011 173 173 174 174 … … 194 194 o outputting PDF (Section 9), 195 195 196 o outputting ePub (Section 10), 197 196 198 o extensions to the xml2rfc vocabulary (Section 11). 197 199 … … 222 224 223 225 224 225 226 226 Reschke [Page 4] 227 227 228 228 229 Documentation RFC2629 through XSLT August2011229 Documentation RFC2629 through XSLT September 2011 230 230 231 231 … … 284 284 285 285 286 Documentation RFC2629 through XSLT August2011286 Documentation RFC2629 through XSLT September 2011 287 287 288 288 … … 341 341 342 342 343 Documentation RFC2629 through XSLT August2011343 Documentation RFC2629 through XSLT September 2011 344 344 345 345 … … 398 398 399 399 400 Documentation RFC2629 through XSLT August2011400 Documentation RFC2629 through XSLT September 2011 401 401 402 402 … … 455 455 456 456 457 Documentation RFC2629 through XSLT August2011457 Documentation RFC2629 through XSLT September 2011 458 458 459 459 … … 512 512 513 513 514 Documentation RFC2629 through XSLT August2011514 Documentation RFC2629 through XSLT September 2011 515 515 516 516 … … 569 569 570 570 571 Documentation RFC2629 through XSLT August2011571 Documentation RFC2629 through XSLT September 2011 572 572 573 573 … … 626 626 627 627 628 Documentation RFC2629 through XSLT August2011628 Documentation RFC2629 through XSLT September 2011 629 629 630 630 … … 683 683 684 684 685 Documentation RFC2629 through XSLT August2011685 Documentation RFC2629 through XSLT September 2011 686 686 687 687 … … 740 740 741 741 742 Documentation RFC2629 through XSLT August2011742 Documentation RFC2629 through XSLT September 2011 743 743 744 744 … … 797 797 798 798 799 Documentation RFC2629 through XSLT August2011799 Documentation RFC2629 through XSLT September 2011 800 800 801 801 … … 854 854 855 855 856 Documentation RFC2629 through XSLT August2011856 Documentation RFC2629 through XSLT September 2011 857 857 858 858 … … 911 911 912 912 913 Documentation RFC2629 through XSLT August2011913 Documentation RFC2629 through XSLT September 2011 914 914 915 915 … … 968 968 969 969 970 Documentation RFC2629 through XSLT August2011970 Documentation RFC2629 through XSLT September 2011 971 971 972 972 … … 1025 1025 1026 1026 1027 Documentation RFC2629 through XSLT August20111027 Documentation RFC2629 through XSLT September 2011 1028 1028 1029 1029 … … 1082 1082 1083 1083 1084 Documentation RFC2629 through XSLT August20111084 Documentation RFC2629 through XSLT September 2011 1085 1085 1086 1086 … … 1139 1139 1140 1140 1141 Documentation RFC2629 through XSLT August20111141 Documentation RFC2629 through XSLT September 2011 1142 1142 1143 1143 … … 1196 1196 1197 1197 1198 Documentation RFC2629 through XSLT August20111198 Documentation RFC2629 through XSLT September 2011 1199 1199 1200 1200 … … 1253 1253 1254 1254 1255 Documentation RFC2629 through XSLT August20111255 Documentation RFC2629 through XSLT September 2011 1256 1256 1257 1257 … … 1310 1310 1311 1311 1312 Documentation RFC2629 through XSLT August20111312 Documentation RFC2629 through XSLT September 2011 1313 1313 1314 1314 … … 1367 1367 1368 1368 1369 Documentation RFC2629 through XSLT August20111369 Documentation RFC2629 through XSLT September 2011 1370 1370 1371 1371 … … 1424 1424 1425 1425 1426 Documentation RFC2629 through XSLT August20111426 Documentation RFC2629 through XSLT September 2011 1427 1427 1428 1428 … … 1481 1481 1482 1482 1483 Documentation RFC2629 through XSLT August20111483 Documentation RFC2629 through XSLT September 2011 1484 1484 1485 1485 … … 1538 1538 1539 1539 1540 Documentation RFC2629 through XSLT August20111540 Documentation RFC2629 through XSLT September 2011 1541 1541 1542 1542 … … 1595 1595 1596 1596 1597 Documentation RFC2629 through XSLT August20111597 Documentation RFC2629 through XSLT September 2011 1598 1598 1599 1599 … … 1652 1652 1653 1653 1654 Documentation RFC2629 through XSLT August20111654 Documentation RFC2629 through XSLT September 2011 1655 1655 1656 1656 … … 1709 1709 1710 1710 1711 Documentation RFC2629 through XSLT August20111711 Documentation RFC2629 through XSLT September 2011 1712 1712 1713 1713 … … 1766 1766 1767 1767 1768 Documentation RFC2629 through XSLT August20111768 Documentation RFC2629 through XSLT September 2011 1769 1769 1770 1770 … … 1823 1823 1824 1824 1825 Documentation RFC2629 through XSLT August20111825 Documentation RFC2629 through XSLT September 2011 1826 1826 1827 1827 … … 1880 1880 1881 1881 1882 Documentation RFC2629 through XSLT August20111882 Documentation RFC2629 through XSLT September 2011 1883 1883 1884 1884 … … 1937 1937 1938 1938 1939 Documentation RFC2629 through XSLT August20111939 Documentation RFC2629 through XSLT September 2011 1940 1940 1941 1941 … … 1994 1994 1995 1995 1996 Documentation RFC2629 through XSLT August20111996 Documentation RFC2629 through XSLT September 2011 1997 1997 1998 1998 … … 2051 2051 2052 2052 2053 Documentation RFC2629 through XSLT August20112053 Documentation RFC2629 through XSLT September 2011 2054 2054 2055 2055 … … 2108 2108 2109 2109 2110 Documentation RFC2629 through XSLT August20112110 Documentation RFC2629 through XSLT September 2011 2111 2111 2112 2112 … … 2165 2165 2166 2166 2167 Documentation RFC2629 through XSLT August20112167 Documentation RFC2629 through XSLT September 2011 2168 2168 2169 2169 … … 2222 2222 2223 2223 2224 Documentation RFC2629 through XSLT August20112224 Documentation RFC2629 through XSLT September 2011 2225 2225 2226 2226 … … 2279 2279 2280 2280 2281 Documentation RFC2629 through XSLT August20112281 Documentation RFC2629 through XSLT September 2011 2282 2282 2283 2283 … … 2336 2336 2337 2337 2338 Documentation RFC2629 through XSLT August20112338 Documentation RFC2629 through XSLT September 2011 2339 2339 2340 2340 … … 2393 2393 2394 2394 2395 Documentation RFC2629 through XSLT August20112395 Documentation RFC2629 through XSLT September 2011 2396 2396 2397 2397 … … 2450 2450 2451 2451 2452 Documentation RFC2629 through XSLT August20112452 Documentation RFC2629 through XSLT September 2011 2453 2453 2454 2454 … … 2507 2507 2508 2508 2509 Documentation RFC2629 through XSLT August20112509 Documentation RFC2629 through XSLT September 2011 2510 2510 2511 2511 … … 2564 2564 2565 2565 2566 Documentation RFC2629 through XSLT August20112566 Documentation RFC2629 through XSLT September 2011 2567 2567 2568 2568 … … 2621 2621 2622 2622 2623 Documentation RFC2629 through XSLT August20112623 Documentation RFC2629 through XSLT September 2011 2624 2624 2625 2625 … … 2678 2678 2679 2679 2680 Documentation RFC2629 through XSLT August20112680 Documentation RFC2629 through XSLT September 2011 2681 2681 2682 2682 … … 2735 2735 2736 2736 2737 Documentation RFC2629 through XSLT August20112737 Documentation RFC2629 through XSLT September 2011 2738 2738 2739 2739 … … 2792 2792 2793 2793 2794 Documentation RFC2629 through XSLT August20112794 Documentation RFC2629 through XSLT September 2011 2795 2795 2796 2796 … … 2849 2849 2850 2850 2851 Documentation RFC2629 through XSLT August20112851 Documentation RFC2629 through XSLT September 2011 2852 2852 2853 2853 … … 2906 2906 2907 2907 2908 Documentation RFC2629 through XSLT August20112908 Documentation RFC2629 through XSLT September 2011 2909 2909 2910 2910 … … 2963 2963 2964 2964 2965 Documentation RFC2629 through XSLT August20112965 Documentation RFC2629 through XSLT September 2011 2966 2966 2967 2967 … … 3020 3020 3021 3021 3022 Documentation RFC2629 through XSLT August20113022 Documentation RFC2629 through XSLT September 2011 3023 3023 3024 3024 … … 3077 3077 3078 3078 3079 Documentation RFC2629 through XSLT August20113079 Documentation RFC2629 through XSLT September 2011 3080 3080 3081 3081 … … 3134 3134 3135 3135 3136 Documentation RFC2629 through XSLT August20113136 Documentation RFC2629 through XSLT September 2011 3137 3137 3138 3138 … … 3191 3191 3192 3192 3193 Documentation RFC2629 through XSLT August20113193 Documentation RFC2629 through XSLT September 2011 3194 3194 3195 3195 … … 3248 3248 3249 3249 3250 Documentation RFC2629 through XSLT August20113250 Documentation RFC2629 through XSLT September 2011 3251 3251 3252 3252 … … 3305 3305 3306 3306 3307 Documentation RFC2629 through XSLT August20113307 Documentation RFC2629 through XSLT September 2011 3308 3308 3309 3309 … … 3362 3362 3363 3363 3364 Documentation RFC2629 through XSLT August20113364 Documentation RFC2629 through XSLT September 2011 3365 3365 3366 3366 … … 3419 3419 3420 3420 3421 Documentation RFC2629 through XSLT August20113421 Documentation RFC2629 through XSLT September 2011 3422 3422 3423 3423 … … 3476 3476 3477 3477 3478 Documentation RFC2629 through XSLT August20113478 Documentation RFC2629 through XSLT September 2011 3479 3479 3480 3480 … … 3533 3533 3534 3534 3535 Documentation RFC2629 through XSLT August20113535 Documentation RFC2629 through XSLT September 2011 3536 3536 3537 3537 … … 3590 3590 3591 3591 3592 Documentation RFC2629 through XSLT August20113592 Documentation RFC2629 through XSLT September 2011 3593 3593 3594 3594 … … 3647 3647 3648 3648 3649 Documentation RFC2629 through XSLT August20113649 Documentation RFC2629 through XSLT September 2011 3650 3650 3651 3651 … … 3704 3704 3705 3705 3706 Documentation RFC2629 through XSLT August20113706 Documentation RFC2629 through XSLT September 2011 3707 3707 3708 3708 … … 3761 3761 3762 3762 3763 Documentation RFC2629 through XSLT August20113763 Documentation RFC2629 through XSLT September 2011 3764 3764 3765 3765 … … 3818 3818 3819 3819 3820 Documentation RFC2629 through XSLT August20113820 Documentation RFC2629 through XSLT September 2011 3821 3821 3822 3822 … … 3875 3875 3876 3876 3877 Documentation RFC2629 through XSLT August20113877 Documentation RFC2629 through XSLT September 2011 3878 3878 3879 3879 … … 3932 3932 3933 3933 3934 Documentation RFC2629 through XSLT August20113934 Documentation RFC2629 through XSLT September 2011 3935 3935 3936 3936 … … 3989 3989 3990 3990 3991 Documentation RFC2629 through XSLT August20113991 Documentation RFC2629 through XSLT September 2011 3992 3992 3993 3993 … … 4046 4046 4047 4047 4048 Documentation RFC2629 through XSLT August20114048 Documentation RFC2629 through XSLT September 2011 4049 4049 4050 4050 … … 4103 4103 4104 4104 4105 Documentation RFC2629 through XSLT August20114105 Documentation RFC2629 through XSLT September 2011 4106 4106 4107 4107 … … 4160 4160 4161 4161 4162 Documentation RFC2629 through XSLT August20114162 Documentation RFC2629 through XSLT September 2011 4163 4163 4164 4164 … … 4217 4217 4218 4218 4219 Documentation RFC2629 through XSLT August20114219 Documentation RFC2629 through XSLT September 2011 4220 4220 4221 4221 … … 4274 4274 4275 4275 4276 Documentation RFC2629 through XSLT August20114276 Documentation RFC2629 through XSLT September 2011 4277 4277 4278 4278 … … 4331 4331 4332 4332 4333 Documentation RFC2629 through XSLT August20114333 Documentation RFC2629 through XSLT September 2011 4334 4334 4335 4335 … … 4388 4388 4389 4389 4390 Documentation RFC2629 through XSLT August20114390 Documentation RFC2629 through XSLT September 2011 4391 4391 4392 4392 … … 4445 4445 4446 4446 4447 Documentation RFC2629 through XSLT August20114447 Documentation RFC2629 through XSLT September 2011 4448 4448 4449 4449 … … 4502 4502 4503 4503 4504 Documentation RFC2629 through XSLT August20114504 Documentation RFC2629 through XSLT September 2011 4505 4505 4506 4506 … … 4559 4559 4560 4560 4561 Documentation RFC2629 through XSLT August20114561 Documentation RFC2629 through XSLT September 2011 4562 4562 4563 4563 -
rfc2629xslt/rfc2629xslt.xml
r1426 r1443 30 30 </author> 31 31 32 <date month=" August" year="2011"/>32 <date month="September" year="2011"/> 33 33 34 34 <keyword>RFC2629</keyword> … … 58 58 <t>outputting CHM (Compiled Microsoft Help, <xref target="output.chm"/>),</t> 59 59 <t>outputting PDF (<xref target="output.pdf"/>),</t> 60 <t>outputting ePub (<xref target="output.epub"/>),</t> 60 61 <t>extensions to the xml2rfc vocabulary (<xref target="extensions"/>).</t> 61 62 <t>various utilities (<xref target="utilities"/>).</t>
Note: See TracChangeset
for help on using the changeset viewer.
