| 1 | |
|---|
| 2 | <!DOCTYPE html |
|---|
| 3 | PUBLIC "-//W3C//DTD HTML 4.01//EN"> |
|---|
| 4 | <html lang="en"><head profile="http://www.w3.org/2006/03/hcard http://dublincore.org/documents/2008/08/04/dc-html/"> |
|---|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
|---|
| 6 | <title>Transforming RFC2629-formatted XML through XSLT</title><style type="text/css" title="Xml2Rfc (sans serif)"> |
|---|
| 7 | a { |
|---|
| 8 | text-decoration: none; |
|---|
| 9 | } |
|---|
| 10 | a.smpl { |
|---|
| 11 | color: black; |
|---|
| 12 | } |
|---|
| 13 | a:hover { |
|---|
| 14 | text-decoration: underline; |
|---|
| 15 | } |
|---|
| 16 | a:active { |
|---|
| 17 | text-decoration: underline; |
|---|
| 18 | } |
|---|
| 19 | address { |
|---|
| 20 | margin-top: 1em; |
|---|
| 21 | margin-left: 2em; |
|---|
| 22 | font-style: normal; |
|---|
| 23 | } |
|---|
| 24 | blockquote { |
|---|
| 25 | border-style: solid; |
|---|
| 26 | border-color: gray; |
|---|
| 27 | border-width: 0 0 0 .25em; |
|---|
| 28 | font-style: italic; |
|---|
| 29 | padding-left: 0.5em; |
|---|
| 30 | } |
|---|
| 31 | body { |
|---|
| 32 | color: black; |
|---|
| 33 | font-family: verdana, helvetica, arial, sans-serif; |
|---|
| 34 | font-size: 10pt; |
|---|
| 35 | margin-right: 2em; |
|---|
| 36 | } |
|---|
| 37 | cite { |
|---|
| 38 | font-style: normal; |
|---|
| 39 | } |
|---|
| 40 | div.note { |
|---|
| 41 | margin-left: 2em; |
|---|
| 42 | } |
|---|
| 43 | dl { |
|---|
| 44 | margin-left: 2em; |
|---|
| 45 | } |
|---|
| 46 | ul.empty { |
|---|
| 47 | list-style-type: none; |
|---|
| 48 | } |
|---|
| 49 | ul.empty li { |
|---|
| 50 | margin-top: .5em; |
|---|
| 51 | } |
|---|
| 52 | dl p { |
|---|
| 53 | margin-left: 0em; |
|---|
| 54 | } |
|---|
| 55 | dt { |
|---|
| 56 | margin-top: .5em; |
|---|
| 57 | } |
|---|
| 58 | h1 { |
|---|
| 59 | font-size: 14pt; |
|---|
| 60 | line-height: 21pt; |
|---|
| 61 | page-break-after: avoid; |
|---|
| 62 | } |
|---|
| 63 | h1.np { |
|---|
| 64 | page-break-before: always; |
|---|
| 65 | } |
|---|
| 66 | h1 a { |
|---|
| 67 | color: #333333; |
|---|
| 68 | } |
|---|
| 69 | h2 { |
|---|
| 70 | font-size: 12pt; |
|---|
| 71 | line-height: 15pt; |
|---|
| 72 | page-break-after: avoid; |
|---|
| 73 | } |
|---|
| 74 | h3, h4, h5, h6 { |
|---|
| 75 | font-size: 10pt; |
|---|
| 76 | page-break-after: avoid; |
|---|
| 77 | } |
|---|
| 78 | h2 a, h3 a, h4 a, h5 a, h6 a { |
|---|
| 79 | color: black; |
|---|
| 80 | } |
|---|
| 81 | img { |
|---|
| 82 | margin-left: 3em; |
|---|
| 83 | } |
|---|
| 84 | li { |
|---|
| 85 | margin-left: 2em; |
|---|
| 86 | } |
|---|
| 87 | ol { |
|---|
| 88 | margin-left: 2em; |
|---|
| 89 | } |
|---|
| 90 | ol.la { |
|---|
| 91 | list-style-type: lower-alpha; |
|---|
| 92 | } |
|---|
| 93 | ol.ua { |
|---|
| 94 | list-style-type: upper-alpha; |
|---|
| 95 | } |
|---|
| 96 | ol p { |
|---|
| 97 | margin-left: 0em; |
|---|
| 98 | } |
|---|
| 99 | p { |
|---|
| 100 | margin-left: 2em; |
|---|
| 101 | } |
|---|
| 102 | pre { |
|---|
| 103 | margin-left: 3em; |
|---|
| 104 | background-color: lightyellow; |
|---|
| 105 | padding: .25em; |
|---|
| 106 | page-break-inside: avoid; |
|---|
| 107 | } |
|---|
| 108 | pre.text2 { |
|---|
| 109 | border-style: dotted; |
|---|
| 110 | border-width: 1px; |
|---|
| 111 | background-color: #f0f0f0; |
|---|
| 112 | width: 69em; |
|---|
| 113 | } |
|---|
| 114 | pre.inline { |
|---|
| 115 | background-color: white; |
|---|
| 116 | padding: 0em; |
|---|
| 117 | } |
|---|
| 118 | pre.text { |
|---|
| 119 | border-style: dotted; |
|---|
| 120 | border-width: 1px; |
|---|
| 121 | background-color: #f8f8f8; |
|---|
| 122 | width: 69em; |
|---|
| 123 | } |
|---|
| 124 | pre.drawing { |
|---|
| 125 | border-style: solid; |
|---|
| 126 | border-width: 1px; |
|---|
| 127 | background-color: #f8f8f8; |
|---|
| 128 | padding: 2em; |
|---|
| 129 | } |
|---|
| 130 | sup { |
|---|
| 131 | font-size: 60%; |
|---|
| 132 | } |
|---|
| 133 | table { |
|---|
| 134 | margin-left: 2em; |
|---|
| 135 | } |
|---|
| 136 | table.tt { |
|---|
| 137 | vertical-align: top; |
|---|
| 138 | } |
|---|
| 139 | table.full { |
|---|
| 140 | border-style: outset; |
|---|
| 141 | border-width: 1px; |
|---|
| 142 | } |
|---|
| 143 | table.headers { |
|---|
| 144 | border-style: outset; |
|---|
| 145 | border-width: 1px; |
|---|
| 146 | } |
|---|
| 147 | table.tt td { |
|---|
| 148 | vertical-align: top; |
|---|
| 149 | } |
|---|
| 150 | table.full td { |
|---|
| 151 | border-style: inset; |
|---|
| 152 | border-width: 1px; |
|---|
| 153 | } |
|---|
| 154 | table.tt th { |
|---|
| 155 | vertical-align: top; |
|---|
| 156 | } |
|---|
| 157 | table.full th { |
|---|
| 158 | border-style: inset; |
|---|
| 159 | border-width: 1px; |
|---|
| 160 | } |
|---|
| 161 | table.headers th { |
|---|
| 162 | border-style: none none inset none; |
|---|
| 163 | border-width: 1px; |
|---|
| 164 | } |
|---|
| 165 | table.left { |
|---|
| 166 | margin-right: auto; |
|---|
| 167 | } |
|---|
| 168 | table.right { |
|---|
| 169 | margin-left: auto; |
|---|
| 170 | } |
|---|
| 171 | table.center { |
|---|
| 172 | margin-left: auto; |
|---|
| 173 | margin-right: auto; |
|---|
| 174 | } |
|---|
| 175 | caption { |
|---|
| 176 | caption-side: bottom; |
|---|
| 177 | font-weight: bold; |
|---|
| 178 | font-size: 9pt; |
|---|
| 179 | margin-top: .5em; |
|---|
| 180 | } |
|---|
| 181 | |
|---|
| 182 | table.header { |
|---|
| 183 | border-spacing: 1px; |
|---|
| 184 | width: 95%; |
|---|
| 185 | font-size: 10pt; |
|---|
| 186 | color: white; |
|---|
| 187 | } |
|---|
| 188 | td.top { |
|---|
| 189 | vertical-align: top; |
|---|
| 190 | } |
|---|
| 191 | td.topnowrap { |
|---|
| 192 | vertical-align: top; |
|---|
| 193 | white-space: nowrap; |
|---|
| 194 | } |
|---|
| 195 | table.header td { |
|---|
| 196 | background-color: gray; |
|---|
| 197 | width: 50%; |
|---|
| 198 | } |
|---|
| 199 | td.reference { |
|---|
| 200 | vertical-align: top; |
|---|
| 201 | white-space: nowrap; |
|---|
| 202 | padding-right: 1em; |
|---|
| 203 | } |
|---|
| 204 | thead { |
|---|
| 205 | display:table-header-group; |
|---|
| 206 | } |
|---|
| 207 | ul.toc, ul.toc ul { |
|---|
| 208 | list-style: none; |
|---|
| 209 | margin-left: 1.5em; |
|---|
| 210 | padding-left: 0em; |
|---|
| 211 | } |
|---|
| 212 | ul.toc li { |
|---|
| 213 | line-height: 150%; |
|---|
| 214 | font-weight: bold; |
|---|
| 215 | font-size: 10pt; |
|---|
| 216 | margin-left: 0em; |
|---|
| 217 | } |
|---|
| 218 | ul.toc li li { |
|---|
| 219 | line-height: normal; |
|---|
| 220 | font-weight: normal; |
|---|
| 221 | font-size: 9pt; |
|---|
| 222 | margin-left: 0em; |
|---|
| 223 | } |
|---|
| 224 | li.excluded { |
|---|
| 225 | font-size: 0pt; |
|---|
| 226 | } |
|---|
| 227 | ul p { |
|---|
| 228 | margin-left: 0em; |
|---|
| 229 | } |
|---|
| 230 | ul.ind, ul.ind ul { |
|---|
| 231 | list-style: none; |
|---|
| 232 | margin-left: 1.5em; |
|---|
| 233 | padding-left: 0em; |
|---|
| 234 | page-break-before: avoid; |
|---|
| 235 | } |
|---|
| 236 | ul.ind li { |
|---|
| 237 | font-weight: bold; |
|---|
| 238 | line-height: 200%; |
|---|
| 239 | margin-left: 0em; |
|---|
| 240 | } |
|---|
| 241 | ul.ind li li { |
|---|
| 242 | font-weight: normal; |
|---|
| 243 | line-height: 150%; |
|---|
| 244 | margin-left: 0em; |
|---|
| 245 | } |
|---|
| 246 | .avoidbreak { |
|---|
| 247 | page-break-inside: avoid; |
|---|
| 248 | } |
|---|
| 249 | |
|---|
| 250 | blockquote > * .bcp14 { |
|---|
| 251 | font-style: italic; |
|---|
| 252 | } |
|---|
| 253 | .comment { |
|---|
| 254 | background-color: yellow; |
|---|
| 255 | } |
|---|
| 256 | .center { |
|---|
| 257 | text-align: center; |
|---|
| 258 | } |
|---|
| 259 | .error { |
|---|
| 260 | color: red; |
|---|
| 261 | font-style: italic; |
|---|
| 262 | font-weight: bold; |
|---|
| 263 | } |
|---|
| 264 | .figure { |
|---|
| 265 | font-weight: bold; |
|---|
| 266 | text-align: center; |
|---|
| 267 | font-size: 9pt; |
|---|
| 268 | } |
|---|
| 269 | .filename { |
|---|
| 270 | color: #333333; |
|---|
| 271 | font-weight: bold; |
|---|
| 272 | font-size: 12pt; |
|---|
| 273 | line-height: 21pt; |
|---|
| 274 | text-align: center; |
|---|
| 275 | } |
|---|
| 276 | .fn { |
|---|
| 277 | font-weight: bold; |
|---|
| 278 | } |
|---|
| 279 | .hidden { |
|---|
| 280 | display: none; |
|---|
| 281 | } |
|---|
| 282 | .left { |
|---|
| 283 | text-align: left; |
|---|
| 284 | } |
|---|
| 285 | .right { |
|---|
| 286 | text-align: right; |
|---|
| 287 | } |
|---|
| 288 | .title { |
|---|
| 289 | color: #990000; |
|---|
| 290 | font-size: 18pt; |
|---|
| 291 | line-height: 18pt; |
|---|
| 292 | font-weight: bold; |
|---|
| 293 | text-align: center; |
|---|
| 294 | margin-top: 36pt; |
|---|
| 295 | } |
|---|
| 296 | .vcardline { |
|---|
| 297 | display: block; |
|---|
| 298 | } |
|---|
| 299 | .warning { |
|---|
| 300 | font-size: 14pt; |
|---|
| 301 | background-color: yellow; |
|---|
| 302 | } |
|---|
| 303 | |
|---|
| 304 | |
|---|
| 305 | @media print { |
|---|
| 306 | .noprint { |
|---|
| 307 | display: none; |
|---|
| 308 | } |
|---|
| 309 | |
|---|
| 310 | a { |
|---|
| 311 | color: black; |
|---|
| 312 | text-decoration: none; |
|---|
| 313 | } |
|---|
| 314 | |
|---|
| 315 | table.header { |
|---|
| 316 | width: 90%; |
|---|
| 317 | } |
|---|
| 318 | |
|---|
| 319 | td.header { |
|---|
| 320 | width: 50%; |
|---|
| 321 | color: black; |
|---|
| 322 | background-color: white; |
|---|
| 323 | vertical-align: top; |
|---|
| 324 | font-size: 12pt; |
|---|
| 325 | } |
|---|
| 326 | |
|---|
| 327 | ul.toc a::after { |
|---|
| 328 | content: leader('.') target-counter(attr(href), page); |
|---|
| 329 | } |
|---|
| 330 | |
|---|
| 331 | ul.ind li li a { |
|---|
| 332 | content: target-counter(attr(href), page); |
|---|
| 333 | } |
|---|
| 334 | |
|---|
| 335 | .print2col { |
|---|
| 336 | column-count: 2; |
|---|
| 337 | -moz-column-count: 2; |
|---|
| 338 | column-fill: auto; |
|---|
| 339 | } |
|---|
| 340 | } |
|---|
| 341 | |
|---|
| 342 | @page { |
|---|
| 343 | @top-left { |
|---|
| 344 | content: "Documentation"; |
|---|
| 345 | } |
|---|
| 346 | @top-right { |
|---|
| 347 | content: "March 2012"; |
|---|
| 348 | } |
|---|
| 349 | @top-center { |
|---|
| 350 | content: "RFC2629 through XSLT"; |
|---|
| 351 | } |
|---|
| 352 | @bottom-left { |
|---|
| 353 | content: "Reschke"; |
|---|
| 354 | } |
|---|
| 355 | @bottom-center { |
|---|
| 356 | content: ""; |
|---|
| 357 | } |
|---|
| 358 | @bottom-right { |
|---|
| 359 | content: "[Page " counter(page) "]"; |
|---|
| 360 | } |
|---|
| 361 | } |
|---|
| 362 | |
|---|
| 363 | @page:first { |
|---|
| 364 | @top-left { |
|---|
| 365 | content: normal; |
|---|
| 366 | } |
|---|
| 367 | @top-right { |
|---|
| 368 | content: normal; |
|---|
| 369 | } |
|---|
| 370 | @top-center { |
|---|
| 371 | content: normal; |
|---|
| 372 | } |
|---|
| 373 | } |
|---|
| 374 | </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.579, 2012-05-24 20:24:05, 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">March 2012</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.feedback"><feedback> element</a></li><li>11.11 <a href="#ext.element.h"><h> element</a></li><li>11.12 <a href="#ext.element.highlight"><highlight> element</a></li><li>11.13 <a href="#ext.element.length-of"><length-of> element</a></li><li>11.14 <a href="#ext.element.link"><link> element</a></li><li>11.15 <a href="#ext.element.lt"><lt> element</a></li><li>11.16 <a href="#ext.element.note"><note> element</a></li><li>11.17 <a href="#ext.element.parse-xml"><parse-xml> element</a></li><li>11.18 <a href="#ext.element.prose"><prose> element</a></li><li>11.19 <a href="#ext.element.q"><q> element</a></li><li>11.20 <a href="#ext.element.ref"><ref> element</a></li><li>11.21 <a href="#ext.element.source"><source> element</a></li><li>11.22 <a href="#ext.element.sup"><sup> element</a></li><li>11.23 <a href="#ext-rfc2629.artwork">Extensions to Xml2rfc <artwork> element</a></li><li>11.24 <a href="#ext-rfc2629.iref">Extensions to Xml2rfc <iref> element</a></li><li>11.25 <a href="#ext-rfc2629.list">Extensions to Xml2rfc <list> element</a></li><li>11.26 <a href="#ext-rfc2629.rfc">Extensions to Xml2rfc <rfc> element</a></li><li>11.27 <a href="#ext-rfc2629.section">Extensions to Xml2rfc <section> element</a></li><li>11.28 <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"?> |
|---|
| 375 | <?rfc-ext support-rfc2731="no"?> |
|---|
| 376 | </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 \ |
|---|
| 377 | xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html |
|---|
| 378 | </pre><div id="rfc.figure.u.3"></div> <p>Using XSLT parameters (xsltproc):</p> <pre class="text">xsltproc --param xml2rfc-toc '"yes"' \ |
|---|
| 379 | --param xml2rfc-ext-support-rfc2731 '"no"' \ |
|---|
| 380 | rfc2629.xslt source.xml > result.html |
|---|
| 381 | </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 class="left">rfc</td><td class="left">background<div id="rfc.iref.b.1"></div><div id="rfc.iref.p.1"></div></td><td class="left">xml2rfc-background<div id="rfc.iref.x.2"></div> <div id="rfc.iref.p.2"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">compact<div id="rfc.iref.c.1"></div><div id="rfc.iref.p.3"></div></td><td class="left">xml2rfc-compact<div id="rfc.iref.x.3"></div> <div id="rfc.iref.p.4"></div></td><td class="left">"no"</td><td class="left">only applies to HTML output method when printing</td></tr><tr><td class="left">rfc</td><td class="left">comments<div id="rfc.iref.c.2"></div><div id="rfc.iref.p.5"></div></td><td class="left">xml2rfc-comments<div id="rfc.iref.x.4"></div> <div id="rfc.iref.p.6"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">editing<div id="rfc.iref.e.1"></div><div id="rfc.iref.p.7"></div></td><td class="left">xml2rfc-editing<div id="rfc.iref.x.5"></div> <div id="rfc.iref.p.8"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">footer<div id="rfc.iref.f.1"></div><div id="rfc.iref.p.9"></div></td><td class="left">xml2rfc-footer<div id="rfc.iref.x.6"></div> <div id="rfc.iref.p.10"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">header<div id="rfc.iref.h.1"></div><div id="rfc.iref.p.11"></div></td><td class="left">xml2rfc-header<div id="rfc.iref.x.7"></div> <div id="rfc.iref.p.12"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">inline<div id="rfc.iref.i.1"></div><div id="rfc.iref.p.13"></div></td><td class="left">xml2rfc-inline<div id="rfc.iref.x.8"></div> <div id="rfc.iref.p.14"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">iprnotified<div id="rfc.iref.i.2"></div><div id="rfc.iref.p.15"></div></td><td class="left">xml2rfc-iprnotified<div id="rfc.iref.x.9"></div> <div id="rfc.iref.p.16"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">linkmailto<div id="rfc.iref.l.1"></div><div id="rfc.iref.p.17"></div></td><td class="left">xml2rfc-linkmailto<div id="rfc.iref.x.10"></div> <div id="rfc.iref.p.18"></div></td><td class="left">"yes"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">private<div id="rfc.iref.p.19"></div><div id="rfc.iref.p.20"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.11"></div> <div id="rfc.iref.p.21"></div></td><td class="left">(not set)</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">refparent<div id="rfc.iref.r.1"></div><div id="rfc.iref.p.22"></div></td><td class="left">xml2rfc-private<div id="rfc.iref.x.12"></div> <div id="rfc.iref.p.23"></div></td><td class="left">"References"</td><td class="left">Title for References sections when automatically inserted</td></tr><tr><td class="left">rfc</td><td class="left">rfcedstyle<div id="rfc.iref.r.2"></div><div id="rfc.iref.p.24"></div></td><td class="left">xml2rfc-rfcedstyle<div id="rfc.iref.x.13"></div> <div id="rfc.iref.p.25"></div></td><td class="left">(not set)</td><td class="left">(limited support)</td></tr><tr><td class="left">rfc</td><td class="left">sortrefs<div id="rfc.iref.s.1"></div><div id="rfc.iref.p.26"></div></td><td class="left">xml2rfc-sortrefs<div id="rfc.iref.x.14"></div> <div id="rfc.iref.p.27"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">symrefs<div id="rfc.iref.s.2"></div><div id="rfc.iref.p.28"></div></td><td class="left">xml2rfc-symrefs<div id="rfc.iref.x.15"></div> <div id="rfc.iref.p.29"></div></td><td class="left">"yes"</td><td class="left">The default has changed from "no" to "yes" as of June 6, 2007 and xml2rfc 1.33pre4.</td></tr><tr><td class="left">rfc</td><td class="left">toc<div id="rfc.iref.t.1"></div><div id="rfc.iref.p.30"></div></td><td class="left">xml2rfc-toc<div id="rfc.iref.x.16"></div> <div id="rfc.iref.p.31"></div></td><td class="left">"no"</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocdepth<div id="rfc.iref.t.2"></div><div id="rfc.iref.p.32"></div></td><td class="left">xml2rfc-tocdepth<div id="rfc.iref.x.17"></div> <div id="rfc.iref.p.33"></div></td><td class="left">99</td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">topblock<div id="rfc.iref.t.3"></div><div id="rfc.iref.p.34"></div></td><td class="left">xml2rfc-topblock<div id="rfc.iref.x.18"></div> <div id="rfc.iref.p.35"></div></td><td class="left">"yes"</td><td class="left"></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 class="left">rfc</td><td class="left">include<div id="rfc.iref.i.3"></div><div id="rfc.iref.p.36"></div></td><td class="left">incompatible with XML/XSLT processing model, please use external entities instead</td></tr><tr><td class="left">rfc</td><td class="left">needLines<div id="rfc.iref.n.1"></div><div id="rfc.iref.p.37"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">slides<div id="rfc.iref.s.3"></div><div id="rfc.iref.p.38"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">strict<div id="rfc.iref.s.4"></div><div id="rfc.iref.p.39"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">subcompact<div id="rfc.iref.s.5"></div><div id="rfc.iref.p.40"></div></td><td class="left"></td></tr><tr><td class="left">rfc</td><td class="left">tocindent<div id="rfc.iref.t.4"></div><div id="rfc.iref.p.41"></div></td><td class="left">(defaults to "yes")</td></tr><tr><td class="left">rfc</td><td class="left">tocompact<div id="rfc.iref.t.5"></div><div id="rfc.iref.p.42"></div></td><td class="left"></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 class="left">rfc-ext</td><td class="left">allow-markup-in-artwork<div id="rfc.iref.a.1"></div><div id="rfc.iref.p.43"></div></td><td class="left">xml2rfc-allow-markup-in-artwork<div id="rfc.iref.x.19"></div> <div id="rfc.iref.p.44"></div></td><td class="left">"no"</td><td class="left">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 12.4</a>).</td></tr><tr><td class="left">rfc-ext</td><td class="left">authors-section<div id="rfc.iref.a.2"></div><div id="rfc.iref.p.45"></div></td><td class="left">xml2rfc-ext-authors-section<div id="rfc.iref.x.20"></div> <div id="rfc.iref.p.46"></div></td><td class="left"></td><td class="left">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 class="left">rfc-ext</td><td class="left">duplex<div id="rfc.iref.d.1"></div><div id="rfc.iref.p.47"></div></td><td class="left">xml2rfc-ext-duplex<div id="rfc.iref.x.21"></div> <div id="rfc.iref.p.48"></div></td><td class="left">no</td><td class="left">When set to "yes", format the PDF output for doublesided printing.</td></tr><tr><td class="left">rfc-ext</td><td class="left">include-index<div id="rfc.iref.i.4"></div><div id="rfc.iref.p.49"></div></td><td class="left">xml2rfc-ext-include-index<div id="rfc.iref.x.22"></div> <div id="rfc.iref.p.50"></div></td><td class="left">"yes"</td><td class="left">When set to "no", no index will be generated.</td></tr><tr><td class="left">rfc-ext</td><td class="left">include-references-in-index<div id="rfc.iref.i.5"></div><div id="rfc.iref.p.51"></div></td><td class="left">xml2rfc-ext-include-references-in-index<div id="rfc.iref.x.23"></div> <div id="rfc.iref.p.52"></div></td><td class="left"></td><td class="left">When set to "yes", index entries are generated for all references.</td></tr><tr><td class="left">rfc-ext</td><td class="left">justification<div id="rfc.iref.j.1"></div><div id="rfc.iref.p.53"></div></td><td class="left">xml2rfc-ext-justification<div id="rfc.iref.x.24"></div> <div id="rfc.iref.p.54"></div></td><td class="left">"never"</td><td class="left">"never": never emit justified text, "always": always emit justified text, "print": only emit justified text for print media.</td></tr><tr><td class="left">rfc-ext</td><td class="left">parse-xml-in-artwork<div id="rfc.iref.p.55"></div><div id="rfc.iref.p.56"></div></td><td class="left">xml2rfc-parse-xml-in-artwork<div id="rfc.iref.x.25"></div> <div id="rfc.iref.p.57"></div></td><td class="left">"no"</td><td class="left">May be used to enable parsing of XML content in figures (MSXML only).</td></tr><tr><td class="left">rfc-ext</td><td class="left">support-rfc2731<div id="rfc.iref.s.6"></div><div id="rfc.iref.p.58"></div></td><td class="left">xml2rfc-ext-support-rfc2731<div id="rfc.iref.x.26"></div> <div id="rfc.iref.p.59"></div></td><td class="left">"yes"</td><td class="left">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 class="left">rfc-ext</td><td class="left">sec-no-trailing-dots<div id="rfc.iref.s.7"></div><div id="rfc.iref.p.60"></div></td><td class="left">xml2rfc-ext-sec-no-trailing-dots<div id="rfc.iref.x.27"></div> <div id="rfc.iref.p.61"></div></td><td class="left"></td><td class="left">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 class="left">rfc.abstract <div id="rfc.iref.r.3"></div><div id="rfc.iref.a.3"></div></td><td class="left">Abstract</td></tr><tr><td class="left">rfc.authors <div id="rfc.iref.r.4"></div><div id="rfc.iref.a.4"></div></td><td class="left">Authors section</td></tr><tr><td class="left">rfc.copyright <div id="rfc.iref.r.5"></div><div id="rfc.iref.a.5"></div></td><td class="left">Copyright section</td></tr><tr><td class="left">rfc.copyrightnotice <div id="rfc.iref.r.6"></div><div id="rfc.iref.a.6"></div></td><td class="left">Copyright notice</td></tr><tr><td class="left">rfc.figure.<em>n</em> <div id="rfc.iref.r.7"></div><div id="rfc.iref.a.7"></div></td><td class="left">Figures (titled)</td></tr><tr><td class="left">rfc.figure.u.<em>n</em> <div id="rfc.iref.r.8"></div><div id="rfc.iref.a.8"></div></td><td class="left">Figures (untitled)</td></tr><tr><td class="left">rfc.index <div id="rfc.iref.r.9"></div><div id="rfc.iref.a.9"></div></td><td class="left">Index</td></tr><tr><td class="left">rfc.ipr <div id="rfc.iref.r.10"></div><div id="rfc.iref.a.10"></div></td><td class="left">Intellectual Property</td></tr><tr><td class="left">rfc.iref.<em>n</em> <div id="rfc.iref.r.11"></div><div id="rfc.iref.a.11"></div></td><td class="left">Internal references</td></tr><tr><td class="left">rfc.note.<em>n</em> <div id="rfc.iref.r.12"></div><div id="rfc.iref.a.12"></div></td><td class="left">Notes (from front section)</td></tr><tr><td class="left">rfc.references <div id="rfc.iref.r.13"></div><div id="rfc.iref.a.13"></div></td><td class="left">References</td></tr><tr><td class="left">rfc.references.<em>n</em> <div id="rfc.iref.r.14"></div><div id="rfc.iref.a.14"></div></td><td class="left">Additional references</td></tr><tr><td class="left">rfc.section.<em>n</em> <div id="rfc.iref.r.15"></div><div id="rfc.iref.a.15"></div></td><td class="left">Section <em>n</em></td></tr><tr><td class="left">rfc.section.<em>n</em>.p.<em>m</em> <div id="rfc.iref.r.16"></div><div id="rfc.iref.a.16"></div></td><td class="left">Section <em>n</em>, paragraph <em>m</em></td></tr><tr><td class="left">rfc.status <div id="rfc.iref.r.17"></div><div id="rfc.iref.a.17"></div></td><td class="left">Status of memo</td></tr><tr><td class="left">rfc.table.<em>n</em> <div id="rfc.iref.r.18"></div><div id="rfc.iref.a.18"></div></td><td class="left">Tables (titled)</td></tr><tr><td class="left">rfc.table.u.<em>n</em> <div id="rfc.iref.r.19"></div><div id="rfc.iref.a.19"></div></td><td class="left">Tables (untitled)</td></tr><tr><td class="left">rfc.toc <div id="rfc.iref.r.20"></div><div id="rfc.iref.a.20"></div></td><td class="left">Table of contents</td></tr><tr><td class="left">rfc.xref.<em>name</em>.<em>n</em> <div id="rfc.iref.r.21"></div><div id="rfc.iref.a.21"></div></td><td class="left">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/index.html">exsl:node-set</a>) which is however widely available. XSLT processors that do not support this extension (or a functional equivalent, such as msxsl:node-set) currently are not supported.</p><div id="exsl-date-time"><p id="rfc.section.5.p.2">Input documents do not always specify the date completely. In this case, the transformation attempts to let the XSLT engine to compute the system date, using either scripting in Microsoft's XSLT engine, or the <a href="http://www.exslt.org/date/functions/date-time/">exsl:date-time</a> extension function.</p></div><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.28"></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.29"></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.6"></span>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</p></li><li><p><span id="rfc.iref.i.7"></span><span id="rfc.iref.i.8"></span><span id="rfc.iref.i.9"></span><span id="rfc.iref.i.10"></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><li>There seems to be a new problem in Firefox 4 where it occasionally does the initial rendering with the wrong width (people who can reproduce this problem please comment on <<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=640390">https://bugzilla.mozilla.org/show_bug.cgi?id=640390</a>>.</li><li>Date computation is available in Firefox starting with Firefox 6 (see <<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=603159">https://bugzilla.mozilla.org/show_bug.cgi?id=603159</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><p> </p><ul><li>Date computation not available (see <<a href="https://bugs.webkit.org/show_bug.cgi?id=4079">https://bugs.webkit.org/show_bug.cgi?id=4079</a>>)</li></ul></li><li><p><span id="rfc.iref.g.1"></span>Google Chrome</p><p> </p><ul><li>Date computation not available (see <<a href="https://bugs.webkit.org/show_bug.cgi?id=4079">https://bugs.webkit.org/show_bug.cgi?id=4079</a>>)</li></ul></li><li><p><span id="rfc.iref.o.1"></span>Opera (starting with version 10)</p><p> </p><ul><li>Date computation not available</li></ul></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.30"></div><div id="rfc.figure.u.4"></div><pre class="text"> <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> |
|---|
| 382 | </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 class="left">alternate<div id="rfc.iref.a.22"></div><div id="rfc.iref.h.3"></div></td><td class="left">for RFCs, a link to the authorative ASCII version on the IETF web site</td></tr><tr><td class="left">appendic<div id="rfc.iref.a.23"></div><div id="rfc.iref.h.4"></div></td><td class="left">pointer to all top-level appendics</td></tr><tr><td class="left">author<div id="rfc.iref.a.24"></div><div id="rfc.iref.h.5"></div></td><td class="left">pointer to "authors" section</td></tr><tr><td class="left">chapter<div id="rfc.iref.c.3"></div><div id="rfc.iref.h.6"></div></td><td class="left">pointer to all top-level sections</td></tr><tr><td class="left">contents<div id="rfc.iref.c.4"></div><div id="rfc.iref.h.7"></div></td><td class="left">pointer to table of contents</td></tr><tr><td class="left">copyright<div id="rfc.iref.c.5"></div><div id="rfc.iref.h.8"></div></td><td class="left">pointer to copyright statement</td></tr><tr><td class="left">index<div id="rfc.iref.i.11"></div><div id="rfc.iref.h.9"></div></td><td class="left">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)
" width="509" height="235"></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 class="left">generator<div id="rfc.iref.g.2"></div><div id="rfc.iref.h.10"></div></td><td class="left">from XSLT engine version and stylesheet version</td></tr><tr><td class="left">keywords<div id="rfc.iref.k.1"></div><div id="rfc.iref.h.11"></div></td><td class="left">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 class="left">DC.Creator<div id="rfc.iref.c.6"></div><div id="rfc.iref.d.2"></div></td><td class="left">from author information in front section</td></tr><tr><td class="left">DC.Date.Issued<div id="rfc.iref.d.3"></div><div id="rfc.iref.d.4"></div></td><td class="left">from date information in front section</td></tr><tr><td class="left">DC.Description.Abstract<div id="rfc.iref.d.5"></div><div id="rfc.iref.d.6"></div></td><td class="left">from abstract</td></tr><tr><td class="left">DC.Identifier<div id="rfc.iref.i.12"></div><div id="rfc.iref.d.7"></div></td><td class="left">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 class="left">DC.isPartOf<div id="rfc.iref.i.13"></div><div id="rfc.iref.d.8"></div></td><td class="left">RFC ISSN (for RFCs)</td></tr><tr><td class="left">DC.Relation.Replaces<div id="rfc.iref.r.22"></div><div id="rfc.iref.d.9"></div></td><td class="left">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><ul class="empty"><li> <b>Note:</b> Microsoft Internet Explorer does <em>not</em> support XHTML. Therefore it usually makes more sense to generate plain old HTML.</li></ul><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 |
|---|
| 383 | saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616 > rfc2616.hhc |
|---|
| 384 | saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616 > rfc2616.hhk |
|---|
| 385 | hhc rfc2616.hhp |
|---|
| 386 | </pre> <hr class="noprint"><h1 id="rfc.section.9" class="np"><a href="#rfc.section.9">9.</a> <a id="output.pdf" href="#output.pdf">Transforming to PDF</a></h1><h2 id="rfc.section.9.1"><a href="#rfc.section.9.1">9.1</a> <a id="output.pdf.fop" href="#output.pdf.fop">Via XSL-FO</a></h2><p id="rfc.section.9.1.p.1">Transformation to XSL-FO <a href="#XSL-FO" id="rfc.xref.XSL-FO.1"><cite title="Extensible Stylesheet Language (XSL) Version 1.1">[XSL-FO]</cite></a> format is available through <samp>rfc2629toFO.xslt</samp> (which includes <samp>rfc2629.xslt</samp>, so keep both in the same folder).</p><p id="rfc.section.9.1.p.2">Compared to HTML user agents, XSL-FO engines unfortunately either come as open source (for instance, <span id="rfc.iref.a.25"></span>Apache FOP) or feature-complete (for instance, <span id="rfc.iref.a.26"></span> AntennaHouse XSL Formatter), but not both at the same time.</p><p id="rfc.section.9.1.p.3">As Apache FOP needs special workarounds (index generation), and some popular extensions aren't standardized yet, the translation produces a generic output (hopefully) conforming to <a href="#XSL-FO" id="rfc.xref.XSL-FO.2"><cite title="Extensible Stylesheet Language (XSL) Version 1.1">[XSL-FO]</cite></a>. Specific backends (<samp>xsl11toFop.xslt</samp>, <samp>xsl11toXep.xslt</samp>, <samp>xsl11toAn.xslt</samp>) then provide post-processing for the individual processors.</p><div class="note" id="rfc.section.9.1.p.4"> <p> <b>Note:</b> the output is currently targeted at Apache FOP 1.0.</p> </div><h3 id="rfc.section.9.1.1"><a href="#rfc.section.9.1.1">9.1.1</a> Extension feature matrix</h3><div id="rfc.table.u.8"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th></th><th class="center" style="width: 20%;">PDF anchors</th><th class="center" style="width: 20%;">PDF bookmarks</th><th class="center" style="width: 20%;">PDF document information</th><th class="center" style="width: 20%;">Index cleanup</th></tr></thead><tbody><tr><td class="left"><a href="http://www.w3.org/TR/2003/WD-xsl11-20031217/">XSL 1.1 WD</a></td><td class="center">no, but can be auto-generated from "id" attributes</td><td class="center"><a href="http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e12873">yes</a></td><td class="center">no, but uses XEP output extensions</td><td class="center"><a href="http://www.w3.org/TR/2003/WD-xsl11-20031217/#d0e12534">yes</a></td></tr><tr><td class="left"><a href="http://www.antennahouse.com/">Antenna House XSL formatter</a></td><td class="center">no</td><td class="center"><a href="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</a> (from XSL 1.1 bookmarks)</td><td class="center"><a href="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</a> (from XEP document info)</td><td class="center"><a href="http://www.antennahouse.com/XSL20/axf-extension.htm">yes</a> (just page duplicate elimination, from XSL 1.1 page index)</td></tr><tr><td class="left"><a href="http://xml.apache.org/fop/">Apache FOP</a></td><td class="center"><a href="http://xml.apache.org/fop/extensions.html#named-destinations">yes</a></td><td class="center"><a href="http://xml.apache.org/fop/extensions.html#bookmarks">yes</a> (from XSL 1.1 bookmarks)</td><td class="center"><a href="http://xmlgraphics.apache.org/fop/0.95/metadata.html#xmp-in-fo">yes</a></td><td class="center">no</td></tr><tr><td class="left"><a href="http://xep.xattic.com/">RenderX XEP</a></td><td class="center">no</td><td class="center"><a href="http://xep.xattic.com/xep/spec.html">yes</a> (from XSL 1.1 bookmarks)</td><td class="center"><a href="http://xep.xattic.com/xep/spec.html">yes</a></td><td class="center"><a href="http://xep.xattic.com/xep/spec.html">yes</a> (from XSL 1.1 page index)</td></tr></tbody></table></div><h3 id="rfc.section.9.1.2"><a href="#rfc.section.9.1.2">9.1.2</a> Example: producing output for Apache FOP</h3><div id="rfc.figure.u.7"></div> <p>Example:</p> <pre class="text">saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo |
|---|
| 387 | saxon tmp.fo xsl11toFop.xslt > rfc2629.fo |
|---|
| 388 | </pre> <h2 id="rfc.section.9.2"><a href="#rfc.section.9.2">9.2</a> <a id="output.pdf.html" href="#output.pdf.html">Via X(HTML)</a></h2><p id="rfc.section.9.2.p.1">PDF output can also be produced directly from (X)HTML. One simple approach is to rely on the browser's printing function, and to use a printer driver that produces PDF. Depending on the brower's CSS capabilities, the output will behave properly with respect to table breaks etc.</p><p id="rfc.section.9.2.p.2">An alternative is PrinceXML (see <<a href="http://www.princexml.com/">http://www.princexml.com/</a>>), which can produce PDF directly from (X)HTML input, based on the CSS printing information.</p><div id="rfc.figure.u.8"></div> <p>For instance, PDF output with text justification turned on can be produced with:</p> <pre class="text">saxon input.xml rfc2629toXHTML.xslt xml2rfc-ext-justification=print \ |
|---|
| 389 | > output.xhtml |
|---|
| 390 | prince output.xhtml output.pdf</pre> <hr class="noprint"><h1 id="rfc.section.10" class="np"><a href="#rfc.section.10">10.</a> <a id="output.epub" href="#output.epub">Transforming to ePub</a></h1><p id="rfc.section.10.p.1">Experimental transformation to ePub format is available through a set of stylesheets, and the Unix Shell script <samp>mkepub.sh</samp> (which requires that "zip" and either "saxon" or "xsltproc" are installed).</p><div id="rfc.figure.u.9"></div> <p>For instance, an epub version of rfc2616.xml can be generated like this:</p> <pre class="text">mkepub.sh rfc2616.xml |
|---|
| 391 | </pre> <hr class="noprint"><h1 id="rfc.section.11" class="np"><a href="#rfc.section.11">11.</a> <a id="extensions" href="#extensions">Generic Extensions</a></h1><p id="rfc.section.11.p.1">This section documents extensions implemented in <samp>rfc2629.xslt</samp>, using the extension namespace "http://purl.org/net/xml2rfc/ext".</p><div id="rfc.iref.e.2"></div><div id="rfc.iref.a.27"></div><h2 id="rfc.section.11.1"><a href="#rfc.section.11.1">11.1</a> <a id="ext.element.abnf-char-sequence" href="#ext.element.abnf-char-sequence"><abnf-char-sequence> element</a></h2><p id="rfc.section.11.1.p.1">Converts the contained quoted string into a hex-encoded character sequence, for use in case-sensitive ABNF productions.</p><p id="rfc.section.11.1.p.2">For instance, "<x:abnf-char-sequence>"HTTP"</x:abnf-char-sequence>" gets converted to "%x48.54.54.50".</p><div id="rfc.iref.e.3"></div><div id="rfc.iref.a.28"></div><h2 id="rfc.section.11.2"><a href="#rfc.section.11.2">11.2</a> <a id="ext.element.anchor-alias" href="#ext.element.anchor-alias"><anchor-alias> element</a></h2><p id="rfc.section.11.2.p.1">Using its "value" attribute, this element allows the definition of an internal link target alias for the enclosing element. This alias can then be used with the <<a href="#ext.element.ref" class="smpl">ref</a>> element for intra-document references.</p><p id="rfc.section.11.2.p.2">Note that the anchor alias is not subject to the naming constraints that apply to anchor elements (which are <a href="http://www.w3.org/TR/REC-xml/#NT-Name">XML names</a>).</p><div id="rfc.iref.e.4"></div><div id="rfc.iref.b.2"></div><h2 id="rfc.section.11.3"><a href="#rfc.section.11.3">11.3</a> <a id="ext.element.bcp14" href="#ext.element.bcp14"><bcp14> element</a></h2><p id="rfc.section.11.3.p.1">This element marks the content as being one of the normative keywords defined in <a href="#RFC2119" id="rfc.xref.RFC2119.1"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>.</p><div id="rfc.figure.u.10"></div> <p>The DOCTYPE definition below allows using these keywords using XML entity expansion: such as in "...server &MUST; accept...".</p> <pre class="text"><!DOCTYPE rfc [ |
|---|
| 392 | <!ENTITY MAY "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 393 | >MAY</bcp14>"> |
|---|
| 394 | <!ENTITY MUST "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 395 | >MUST</bcp14>"> |
|---|
| 396 | <!ENTITY MUST-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 397 | >MUST NOT</bcp14>"> |
|---|
| 398 | <!ENTITY OPTIONAL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 399 | >OPTIONAL</bcp14>"> |
|---|
| 400 | <!ENTITY RECOMMENDED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 401 | >RECOMMENDED</bcp14>"> |
|---|
| 402 | <!ENTITY REQUIRED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 403 | >REQUIRED</bcp14>"> |
|---|
| 404 | <!ENTITY SHALL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 405 | >SHALL</bcp14>"> |
|---|
| 406 | <!ENTITY SHALL-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 407 | >SHALL NOT</bcp14>"> |
|---|
| 408 | <!ENTITY SHOULD "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 409 | >SHOULD</bcp14>"> |
|---|
| 410 | <!ENTITY SHOULD-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
|---|
| 411 | >SHOULD NOT</bcp14>">]></pre> <div id="rfc.iref.e.5"></div><div id="rfc.iref.b.3"></div><h2 id="rfc.section.11.4"><a href="#rfc.section.11.4">11.4</a> <a id="ext.element.bb" href="#ext.element.bb"><bb> element</a></h2><p id="rfc.section.11.4.p.1">Marking up a string as <bb> indicates that it represents the bottom line of a box drawing, replacing the "+" and "-" characters accordingly.</p><div id="rfc.iref.e.6"></div><div id="rfc.iref.b.4"></div><h2 id="rfc.section.11.5"><a href="#rfc.section.11.5">11.5</a> <a id="ext.element.bc" href="#ext.element.bc"><bc> element</a></h2><p id="rfc.section.11.5.p.1">Marking up a string as <bc> indicates that it represents a center line of a box drawing, replacing the "|" character accordingly.</p><div id="rfc.iref.e.7"></div><div id="rfc.iref.b.5"></div><h2 id="rfc.section.11.6"><a href="#rfc.section.11.6">11.6</a> <a id="ext.element.blockquote" href="#ext.element.blockquote"><blockquote> element</a></h2><p id="rfc.section.11.6.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-BLOCKQUOTE">blockquote</a>" element in <a href="#HTML" id="rfc.xref.HTML.2"><cite title="HTML 4.01 Specification">[HTML]</cite></a> (note this is a block-level element!). It should contain one or more <t> child elements.</p><div id="rfc.iref.e.8"></div><div id="rfc.iref.b.6"></div><h2 id="rfc.section.11.7"><a href="#rfc.section.11.7">11.7</a> <a id="ext.element.boilerplate" href="#ext.element.boilerplate"><boilerplate> element</a></h2><p id="rfc.section.11.7.p.1">Can be used to include boilerplate (status, copyright, ...) into the front or back section. <section> elements within <x:boilerplate> appear as unnumbered sections in the output.</p><p id="rfc.section.11.7.p.2"> <em>This element currently can not be "down-translated" for use in xml2rfc!</em> </p><div id="rfc.iref.e.9"></div><div id="rfc.iref.b.7"></div><h2 id="rfc.section.11.8"><a href="#rfc.section.11.8">11.8</a> <a id="ext.element.bt" href="#ext.element.bt"><bt> element</a></h2><p id="rfc.section.11.8.p.1">Marking up a string as <bt> indicates that it represents the top line of a box drawing, replacing the "+" and "-" characters accordingly.</p><div id="rfc.iref.e.10"></div><div id="rfc.iref.d.10"></div><h2 id="rfc.section.11.9"><a href="#rfc.section.11.9">11.9</a> <a id="ext.element.dfn" href="#ext.element.dfn"><dfn> element</a></h2><p id="rfc.section.11.9.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-DFN">dfn</a>" element in <a href="#HTML" id="rfc.xref.HTML.3"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><div id="rfc.iref.e.11"></div><div id="rfc.iref.f.4"></div><h2 id="rfc.section.11.10"><a href="#rfc.section.11.10">11.10</a> <a id="ext.element.feedback" href="#ext.element.feedback"><feedback> element</a></h2><p id="rfc.section.11.10.p.1">This elements allows declaring a feedback link for document reviewers. The template string takes the form of a URI template, such as:</p><div id="rfc.figure.u.11"></div> <pre class="text"><x:feedback template="mailto:ietf-http-wg@w3.org?subject={docname},%20%22{section}%22&amp;body=&lt;{ref}&gt;:"/> |
|---|
| 412 | </pre><p id="rfc.section.11.10.p.3">where "docname" is substituted by the document name, "section" is substituted by section title (number and name), and "ref" is substituted by a URI pointing to the section being referenced.</p><div id="rfc.iref.e.12"></div><div id="rfc.iref.h.12"></div><h2 id="rfc.section.11.11"><a href="#rfc.section.11.11">11.11</a> <a id="ext.element.h" href="#ext.element.h"><h> element</a></h2><p id="rfc.section.11.11.p.1">This element is like the "<a href="http://www.w3.org/TR/2006/WD-xhtml2-20060726/mod-structural.html#edef_structural_h">h</a>" element in <a href="#XHTML2" id="rfc.xref.XHTML2.1"><cite title="XHTML™ 2.0">[XHTML2]</cite></a>.</p><div id="rfc.iref.e.13"></div><div id="rfc.iref.h.13"></div><h2 id="rfc.section.11.12"><a href="#rfc.section.11.12">11.12</a> <a id="ext.element.highlight" href="#ext.element.highlight"><highlight> element</a></h2><p id="rfc.section.11.12.p.1">Used to highlight text passages, currently only allowed in <artwork>.</p><p id="rfc.section.11.12.p.2"> <b>Note:</b> this is stripped when generating input for xml2rfc, so please use with care.</p><div id="rfc.iref.e.14"></div><div id="rfc.iref.l.2"></div><h2 id="rfc.section.11.13"><a href="#rfc.section.11.13">11.13</a> <a id="ext.element.length-of" href="#ext.element.length-of"><length-of> element</a></h2><p id="rfc.section.11.13.p.1">This element can be used to insert the length of another formatted section (in decimal).</p><div id="rfc.figure.u.12"></div> <p>Example: computing the Content-Length header value</p> <pre class="text"><artwork> |
|---|
| 413 | ... |
|---|
| 414 | Content-Length: <x:length-of target="req"/> |
|---|
| 415 | |
|---|
| 416 | <x:span anchor="req">123456789 |
|---|
| 417 | <x:span><artwork/> |
|---|
| 418 | </pre> <p id="rfc.section.11.13.p.3">The lenght computation counts line ends as two characters (CRLF).</p><p id="rfc.section.11.13.p.4">Note that indentation characters in artwork <em>will</em> be counted. The "indented" attribute allows to specify the amount of indentation to be substracted from the computed length.</p><div id="rfc.iref.e.15"></div><div id="rfc.iref.l.3"></div><h2 id="rfc.section.11.14"><a href="#rfc.section.11.14">11.14</a> <a id="ext.element.link" href="#ext.element.link"><link> element</a></h2><p id="rfc.section.11.14.p.1">This element can be added as a top-level child element below <rfc> to indicate additional link information. It's currently used only when generating HTML output, in which case an HTML <a href="http://www.w3.org/TR/html4/struct/links.html#edef-LINK"><link></a> element with identical attributes gets generated.</p><div id="rfc.figure.u.13"></div> <p>Example: generating HTML link element</p> <pre class="text"> <x:link xmlns="http://purl.org/net/xml2rfc/ext" |
|---|
| 419 | rel="Bookmark" |
|---|
| 420 | title="IETF WEBDAV Working Group" |
|---|
| 421 | href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/></pre> <p id="rfc.section.11.14.p.3">If the attribute "basename" is present, it is used to compute the target href based on the output format being generated (this is handy for "next"/"prev" links in a series of documents. In this case, the href attribute is not required.</p><div id="rfc.figure.u.14"></div> <p>For instance:</p> <pre class="text"> <x:link xmlns="http://purl.org/net/xml2rfc/ext" |
|---|
| 422 | rel="next" |
|---|
| 423 | title="Part2" |
|---|
| 424 | basename="draft-foobar-protocol-p2-latest"/></pre> <div id="rfc.iref.e.16"></div><div id="rfc.iref.l.4"></div><h2 id="rfc.section.11.15"><a href="#rfc.section.11.15">11.15</a> <a id="ext.element.lt" href="#ext.element.lt"><lt> element</a></h2><p id="rfc.section.11.15.p.1">Used for grouping multiple <t> elements into a single list item.</p><div id="rfc.iref.e.17"></div><div id="rfc.iref.n.3"></div><h2 id="rfc.section.11.16"><a href="#rfc.section.11.16">11.16</a> <a id="ext.element.note" href="#ext.element.note"><note> element</a></h2><p id="rfc.section.11.16.p.1">Can be used to add a note, usually indented by a few characters. It should contain one or more <t> child elements.</p><div id="rfc.iref.e.18"></div><div id="rfc.iref.p.62"></div><h2 id="rfc.section.11.17"><a href="#rfc.section.11.17">11.17</a> <a id="ext.element.parse-xml" href="#ext.element.parse-xml"><parse-xml> element</a></h2><p id="rfc.section.11.17.p.1">This element instructs the processor to parse the contents as XML and to warn when there's a problem (requires either MSXML or Saxon8 or newer).</p><div id="rfc.iref.e.19"></div><div id="rfc.iref.p.63"></div><h2 id="rfc.section.11.18"><a href="#rfc.section.11.18">11.18</a> <a id="ext.element.prose" href="#ext.element.prose"><prose> element</a></h2><p id="rfc.section.11.18.p.1">This element can be used inside <reference> to add plain text (before the date, when present).</p><div id="rfc.iref.e.20"></div><div id="rfc.iref.q.1"></div><h2 id="rfc.section.11.19"><a href="#rfc.section.11.19">11.19</a> <a id="ext.element.q" href="#ext.element.q"><q> element</a></h2><p id="rfc.section.11.19.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-Q">q</a>" element in <a href="#HTML" id="rfc.xref.HTML.4"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><div id="rfc.iref.e.21"></div><div id="rfc.iref.r.23"></div><h2 id="rfc.section.11.20"><a href="#rfc.section.11.20">11.20</a> <a id="ext.element.ref" href="#ext.element.ref"><ref> element</a></h2><p id="rfc.section.11.20.p.1">This element is a simplified variant of the <xref> element, in that no "target" attribute needs to be specified, instead the text contents acts as identifier. That in itself wouldn't be terribly useful, but together with the <<a href="#ext.element.anchor-alias" class="smpl">anchor-alias</a>>, it allows referring to other parts of the document with minimal additional markup.</p><p id="rfc.section.11.20.p.2">For instance, given an alias definition such as</p><div id="rfc.figure.u.15"></div> <pre class="text"> <section title="Test" anchor="test"> |
|---|
| 425 | <x:anchor-alias value="alias1"/> |
|---|
| 426 | <x:anchor-alias value="alias 2"/> |
|---|
| 427 | ... |
|---|
| 428 | </section></pre> <p id="rfc.section.11.20.p.4">the following simple references</p><div id="rfc.figure.u.16"></div> <pre class="text"> <x:ref>test</x:ref> |
|---|
| 429 | <x:ref>alias1</x:ref> |
|---|
| 430 | <x:ref>alias 2</x:ref></pre> <p id="rfc.section.11.20.p.6">are equivalent to...:</p><div id="rfc.figure.u.17"></div> <pre class="text"> <xref target="test">test</xref> |
|---|
| 431 | <xref target="test">alias1</xref> |
|---|
| 432 | <xref target="test">alias 2</xref></pre> <div id="rfc.iref.e.22"></div><div id="rfc.iref.s.12"></div><h2 id="rfc.section.11.21"><a href="#rfc.section.11.21">11.21</a> <a id="ext.element.source" href="#ext.element.source"><source> element</a></h2><p id="rfc.section.11.21.p.1">Can be used to enhance a <reference> with information about the location for the XML source. This can be used by the <xref> processing code to automatically extract the target section number.</p><div id="rfc.figure.u.18"></div> <p>For example:</p> <pre class="text"> ... |
|---|
| 433 | <xref target="RFC2616" x:fmt="of" x:rel="#PUT" /> |
|---|
| 434 | ... |
|---|
| 435 | |
|---|
| 436 | <reference target="RFC2616"/> |
|---|
| 437 | ... |
|---|
| 438 | <x:source href="rfc2616.xml"/> |
|---|
| 439 | ... |
|---|
| 440 | </pre> <div id="rfc.iref.e.23"></div><div id="rfc.iref.s.13"></div><h2 id="rfc.section.11.22"><a href="#rfc.section.11.22">11.22</a> <a id="ext.element.sup" href="#ext.element.sup"><sup> element</a></h2><p id="rfc.section.11.22.p.1">This element is like the "<a href="http://www.w3.org/TR/html401/struct/text.html#edef-SUP">sup</a>" element in <a href="#HTML" id="rfc.xref.HTML.5"><cite title="HTML 4.01 Specification">[HTML]</cite></a>.</p><p id="rfc.section.11.22.p.2">Note: the down conversion to RFC2629 format replaces "x<sup>y</sup>" by "x^y".</p><h2 id="rfc.section.11.23"><a href="#rfc.section.11.23">11.23</a> <a id="ext-rfc2629.artwork" href="#ext-rfc2629.artwork">Extensions to Xml2rfc <artwork> element</a></h2><p id="rfc.section.11.23.p.1">Sometimes, artwork occurs inside lists. To get it indent properly in xml2rfc's text output, it needs to be indented in the source. This is sub-optimal, as this whitespace will also appear in the HTML output, where it's already indented due to HTML's semantics.</p><p id="rfc.section.11.23.p.2">As a workaround, a "x:indent-with" attribute can be specified, containing a string that will be prepended to each line when <samp>clean-for-DTD.xslt</samp> is run (see <a href="#clean-for-dtd" title="Down-converting to RFC2629bis DTD">Section 12.4</a>).</p><h2 id="rfc.section.11.24"><a href="#rfc.section.11.24">11.24</a> <a id="ext-rfc2629.iref" href="#ext-rfc2629.iref">Extensions to Xml2rfc <iref> element</a></h2><p id="rfc.section.11.24.p.1">The extension attribute below is allowed on the standard <iref> element: </p><ul><li>x:for-anchor specifies that the <iref> will also be automatically inserted whenever the specified anchor is cross-referenced -- this may save entering lots of <iref> instances. As a special case, a value of "" (empty string) refers to the anchor attribute of the closest ancestor.</li></ul><h2 id="rfc.section.11.25"><a href="#rfc.section.11.25">11.25</a> <a id="ext-rfc2629.list" href="#ext-rfc2629.list">Extensions to Xml2rfc <list> element</a></h2><p id="rfc.section.11.25.p.1">The extension attribute below is allowed on the standard <list> element: </p><ul><li>x:indent specifies the amount of indentation for list items in hanging lists. This can be useful when the output format, such as XSL-FO, does not support automatical formatting. The value takes an XSL-FO width, such as "5em". The default is <em>length of longest label in characters</em> times <em>0.8em</em>.</li></ul><p id="rfc.section.11.25.p.2">Also, the <list> element can take <x:<a href="#ext.element.lt" class="smpl">lt</a>> child elements instead of <t>, allowing to insert multiple paragraphs into a single list item.</p><h2 id="rfc.section.11.26"><a href="#rfc.section.11.26">11.26</a> <a id="ext-rfc2629.rfc" href="#ext-rfc2629.rfc">Extensions to Xml2rfc <rfc> element</a></h2><p id="rfc.section.11.26.p.1">The extension attributes below are allowed on the standard <rfc> element: </p><ul><li>grddl:transformation can be used to reference a GRDDL transform.</li><li>x:maturity-level can be used to specify the IETF Standards Track Maturity Level of "proposed", "draft" or "internet" (see <a href="http://tools.ietf.org/html/rfc2026#section-4.1">Section 4.1</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.1"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>).</li></ul><h2 id="rfc.section.11.27"><a href="#rfc.section.11.27">11.27</a> <a id="ext-rfc2629.section" href="#ext-rfc2629.section">Extensions to Xml2rfc <section> element</a></h2><p id="rfc.section.11.27.p.1">The extension attribute below is allowed on the standard <list> element: </p><ul><li>x:fixed-section-number can be used to specify a fixed section number. This can be useful when formatting historic documents that used a different numbering style.</li></ul><h2 id="rfc.section.11.28"><a href="#rfc.section.11.28">11.28</a> <a id="ext-rfc2629.xref" href="#ext-rfc2629.xref">Extensions to Xml2rfc <xref> element</a></h2><p id="rfc.section.11.28.p.1">Three extension attributes are allowed on the standard <xref> element: </p><ol><li>x:sec can be specified to point to a specific section of the referenced document,</li><li>x:rel may specify a relative reference to use when linking into the referenced document (if linking by section number is not available),</li><li>x:fmt defines the text format to be used.</li></ol><p id="rfc.section.11.28.p.2">The following formats are defined for the x:fmt attribute: </p><dl><dt>, (Comma)</dt><dd>[<em>reference</em>], Section <em>sec</em> </dd><dt>()</dt><dd>[<em>reference</em>] (Section <em>sec</em>)</dd><dt>anchor</dt><dd>Like the default format, but without brackets.</dd><dt>of</dt><dd>Section <em>sec</em> of [<em>reference</em>]</dd><dt>number</dt><dd> <em>sec</em> </dd><dt>none</dt><dd>No output (can be used to have xrefs to references without having them rendered as such)</dd><dt>sec</dt><dd>Section <em>sec</em> </dd></dl><p id="rfc.section.11.28.p.3">These extensions are currently only supported for <xref> elements without child nodes.</p><p id="rfc.section.11.28.p.4">If the processor knows how to reference the target section, it will generate a link directly to the target section, such as in <a href="#RFC2119" id="rfc.xref.RFC2119.2"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>, <a href="http://tools.ietf.org/html/rfc2119#section-5">Section 5</a>.</p><hr class="noprint"><h1 id="rfc.section.12" class="np"><a href="#rfc.section.12">12.</a> <a id="utilities" href="#utilities">Utilities</a></h1><h2 id="rfc.section.12.1"><a href="#rfc.section.12.1">12.1</a> <a id="checking-references" href="#checking-references">Checking References</a></h2><p id="rfc.section.12.1.p.1"> <samp>check-references.xslt</samp> can be used to check all references to RFC- and ID-series IETF publications and to W3C publications (note this script requires local copies of <<a href="ftp://ftp.isi.edu/in-notes/rfc-index.xml">ftp://ftp.isi.edu/in-notes/rfc-index.xml</a>> and <<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>> and will use the XML status information provided at <<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>>).</p><p id="rfc.section.12.1.p.2">If the document is supposed to be published on the IETF standards track, the desired level can be specified using the parameter <samp>intended-level</samp> as 'proposed', 'draft' or 'internet'. Alternatively, it can be specified inside the document using the attribute x:maturity-level on the <rfc> element (see <a href="#ext-rfc2629.rfc" title="Extensions to Xml2rfc <rfc> element">Section 11.26</a>).</p><p id="rfc.section.12.1.p.3"> <b>Note:</b> Downward references should be annotated using the <annotate> element, containing an <xref> to <a href="#BCP97" id="rfc.xref.BCP97.1"><cite title="Handling Normative References to Standards-Track Documents">[BCP97]</cite></a>.</p><p id="rfc.section.12.1.p.4">When an XSLT 2.0 processor is used, links in the document can be checked as well using the <samp>link-check</samp> paramerer ('yes' or 'no'). Note that this only works for http links to documents of type text/*.</p><div id="rfc.figure.u.19"></div> <p>For instance, as of 2008-07-12, the script produces for <<a href="http://greenbytes.de/tech/webdav/rfc2518.xml">http://greenbytes.de/tech/webdav/rfc2518.xml</a>>:</p> <pre class="text">> saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \ |
|---|
| 441 | link-check=yes |
|---|
| 442 | |
|---|
| 443 | Normative References: |
|---|
| 444 | ISO-11578: not checked |
|---|
| 445 | ISO-639: not checked |
|---|
| 446 | ISO-8601: not checked |
|---|
| 447 | REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006 |
|---|
| 448 | REC-xml-names-19990114: [FirstEdition] obsoleted by |
|---|
| 449 | REC-xml-names-20060816 |
|---|
| 450 | RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282 |
|---|
| 451 | RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616 |
|---|
| 452 | RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617 |
|---|
| 453 | RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok |
|---|
| 454 | RFC2141: [PROPOSED STANDARD] ok |
|---|
| 455 | RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok |
|---|
| 456 | RFC2396: [DRAFT STANDARD] obsoleted by RFC3986 |
|---|
| 457 | RFC2279: [DRAFT STANDARD] obsoleted by RFC3629 |
|---|
| 458 | |
|---|
| 459 | Informational References: |
|---|
| 460 | REC-PICS-labels-961031: [REC] ok |
|---|
| 461 | RFC1807: [INFORMATIONAL] ok |
|---|
| 462 | RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok |
|---|
| 463 | RFC2291: [INFORMATIONAL] ok |
|---|
| 464 | RFC2376: [INFORMATIONAL] obsoleted by RFC3023 |
|---|
| 465 | RFC2413: [INFORMATIONAL] obsoleted by RFC5013 |
|---|
| 466 | USMARC: not checked |
|---|
| 467 | WF: not checked |
|---|
| 468 | |
|---|
| 469 | Link Targets |
|---|
| 470 | <http://www.w3.org/TR/1998/REC-xml-19980210>: ok |
|---|
| 471 | <http://www.w3.org/TR/1999/REC-xml-names-19990114>: ok |
|---|
| 472 | <http://www.dlib.org/dlib/july96/lagoze/07lagoze.html>: ok |
|---|
| 473 | <http://www.w3.org/pub/WWW/TR/REC-PICS-labels-961031.html>: ok |
|---|
| 474 | </pre><p id="rfc.section.12.1.p.6">Recognized formats in the <seriesInfo> element are: </p><ul><li>for RFCs, the name attribute must be "RFC", and the value attribute must be the number of the RFC,</li><li>for Internet Drafs, the name attribute must be "ID" or "Internet-Draft", and the value attribute must be the file name of the draft (including the two-digit running number, but excluding a file extension),</li><li>for W3C documents, the name attribute must be "W3C", must start with "W3C ", or must start with "World Wide Web Consortium ", and the value attribute must be the "shorthand" name of the specification, such as "REC-xml-19980210".</li></ul><div class="note" id="rfc.section.12.1.p.7"> <p> <b>Note:</b> this stylesheet will need network access to check links and status of Internet Drafts. When running a Java-based XSLT engine, you may have to supply Java system properties specifying the HTTP proxy to be used, such as "-Dhttp.proxyHost=hostname -Dhttp.proxyPort=80".</p> </div><h2 id="rfc.section.12.2"><a href="#rfc.section.12.2">12.2</a> Generating Graphs from References</h2><p id="rfc.section.12.2.p.1"> <samp>gen-reference-graph.xslt</samp> generates a graph of RFC dependencies, using the same base data as in <samp>check-references.xslt</samp> (see <a href="#checking-references" title="Checking References">Section 12.1</a>). Its output is a "dot" file, to be processed by GraphViz (see <<a href="http://www.graphviz.org/">http://www.graphviz.org/</a>>).</p><div id="rfc.figure.u.20"></div> <p>The picture below shows the RFC dependencies in RFC2629.</p> <p><img src="rfc2629xslt-fig2.png" alt="
(PNG output obtained from GraphViz)
"></p> <h2 id="rfc.section.12.3"><a href="#rfc.section.12.3">12.3</a> Producing reference entries for books</h2><p id="rfc.section.12.3.p.1"> <samp>amazon-asin.xslt</samp> uses the Amazon web services to generate a <reference> element for a given ASIN (ISBN).</p><div id="rfc.figure.u.21"></div> <p>For instance:</p> <pre class="text"><?xml version="1.0" encoding="utf-8"?> |
|---|
| 475 | <references> |
|---|
| 476 | <reference target="urn:isbn:0134516591"> |
|---|
| 477 | <front> |
|---|
| 478 | <title>Simple Book, The: An Introduction to Internet Management, |
|---|
| 479 | Revised Second Edition</title> |
|---|
| 480 | <author surname="Rose" |
|---|
| 481 | fullname="Marshall T. Rose" initials="M. T. "> |
|---|
| 482 | <organization/> |
|---|
| 483 | </author> |
|---|
| 484 | <author surname="Marshall" |
|---|
| 485 | fullname="Rose T. Marshall" initials="R. T."> |
|---|
| 486 | <organization/> |
|---|
| 487 | </author> |
|---|
| 488 | <date year="1996" month="March"/> |
|---|
| 489 | </front> |
|---|
| 490 | <seriesInfo name="Prentice Hall" value=""/> |
|---|
| 491 | </reference> |
|---|
| 492 | </references> |
|---|
| 493 | </pre><p id="rfc.section.12.3.p.3">Note that the resulting XML usually requires checking, in this case Amazon's database is playing tricks with Marshall's name...</p><h2 id="rfc.section.12.4"><a href="#rfc.section.12.4">12.4</a> <a id="clean-for-dtd" href="#clean-for-dtd">Down-converting to RFC2629bis DTD</a></h2><p id="rfc.section.12.4.p.1"> <samp>clean-for-DTD.xslt</samp> can be used to down-convert some extensions to a format that is supported by the base xml2rfc distribution. Note that these extensions are experimental (feedback appreciated).</p><p id="rfc.section.12.4.p.2">The following mappings are done: </p><ul><li><iref> elements inside <artwork> elements are moved in front of the enclosing <figure> element.</li><li><xref> elements inside <artwork> are expanded just like in regular text (that is, the markup is stripped, but the element is replaced by the applicable replacement text).</li><li><x:<a href="#ext.element.anchor-alias" class="smpl">anchor-alias</a>> elements get stripped.</li><li><x:<a href="#ext.element.bcp14" class="smpl">bcp14</a>> elements get stripped.</li><li><x:<a href="#ext.element.bb" class="smpl">bb</a>>, <x:<a href="#ext.element.bc" class="smpl">bc</a>> and <x:<a href="#ext.element.bt" class="smpl">bt</a>> elements get stripped.</li><li><x:<a href="#ext.element.blockquote" class="smpl">blockquote</a>> elements get converted to indented text (through a <list> element).</li><li><x:<a href="#ext.element.dfn" class="smpl">dfn</a>> elements get stripped.</li><li><x:<a href="#ext.element.h" class="smpl">h</a>> elements get stripped.</li><li><x:<a href="#ext.element.link" class="smpl">link</a>> elements get stripped.</li><li><x:<a href="#ext.element.lt" class="smpl">lt</a>> elements get collapsed into a single <lt> element with added <vspace> added to simulate paragraph breaks.</li><li><x:<a href="#ext.element.note" class="smpl">note</a>> elements get converted to indented text (through a <list> element).</li><li><x:<a href="#ext.element.q" class="smpl">q</a>> elements get stripped, with apostrophes added around the text.</li><li><x:<a href="#ext.element.prose" class="smpl">prose</a>> elements are transformed into <seriesInfo> elements (which is an abuse of the element and only a workaround until xml2rfc gets a matching extension).</li><li><x:<a href="#ext.element.ref" class="smpl">ref</a>> elements get replaced by <xref> elements, targetting either the anchor or another anchor with matching <x:<a href="#ext.element.anchor-alias" class="smpl">anchor-alias</a>> child element.</li></ul><h2 id="rfc.section.12.5"><a href="#rfc.section.12.5">12.5</a> <a id="extract-artwork" href="#extract-artwork">Extracting artwork</a></h2><p id="rfc.section.12.5.p.1">With <samp>extract-artwork.xslt</samp>, artwork elements named through the "name" attribute can be extracted. This can be used to automatically check their syntax (for instance, when ABNFs appear within a figure element).</p><div id="rfc.figure.u.22"></div><p>For instance:</p> <pre class="text">saxon rfc3986.xml extract-artwork.xslt name=uri.abnf |
|---|
| 494 | </pre> <p id="rfc.section.12.5.p.3">In addition, artwork of a specific type can be extracted, such as with:</p><div id="rfc.figure.u.23"></div> <pre class="text">saxon rfc3986.xml extract-artwork.xslt type=abnf |
|---|
| 495 | </pre> <p id="rfc.section.12.5.p.5">When extracting by type, artwork elements with a specified name can be excluded; this can be handy when the document uses some kind of schema language, and an appendix contains the collected schema, repeating definitions from earlier on. Example:</p><div id="rfc.figure.u.24"></div><pre class="text">saxon rfc3986.xml extract-artwork.xslt type=abnf except-name=clschm |
|---|
| 496 | </pre><h2 id="rfc.section.12.6"><a href="#rfc.section.12.6">12.6</a> <a id="grddl" href="#grddl">GRRDL</a></h2><p id="rfc.section.12.6.p.1"> <samp>rfc2629grddl.xslt</samp> extracts RDF information. This is experimental work-in-progress. See <<a href="http://www.w3.org/TR/grddl/">http://www.w3.org/TR/grddl/</a>> for more information.</p><h1 class="np" id="rfc.references"><a href="#rfc.section.13" id="rfc.section.13">13.</a> Informative References</h1><table> <tr><td class="reference"><b id="BCP97">[BCP97]</b></td><td class="top"><a href="mailto:klensin+ietf@jck.com">Klensin, J.</a> and <a href="mailto:hartmans-ietf@mit.edu" title="MIT">S. Hartman</a>, “<a href="http://tools.ietf.org/html/rfc4897">Handling Normative References to Standards-Track Documents</a>”, BCP 97, RFC 4897, June 2007.</td></tr><tr><td class="reference"><b id="DC-HTML">[DC-HTML]</b></td><td class="top"><a href="mailto:pete.johnston@eduserv.org.uk" title="Eduserv Foundation">Johnston, P.</a> and <a href="mailto:andy.powell@eduserv.org.uk" title="Eduserv Foundation">A. Powell</a>, “<a href="http://dublincore.org/documents/2008/08/04/dc-html/">Expressing Dublin Core metadata using HTML/XHTML meta and link elements</a>”, Dublin Core Metadata Initiative, August 2008, <<a href="http://dublincore.org/documents/2008/08/04/dc-html/">http://dublincore.org/documents/2008/08/04/dc-html/</a>>.</td></tr><tr><td class="reference"><b id="HTML">[HTML]</b></td><td class="top"><a href="mailto:dsr@w3.org" title="W3C">Raggett, D.</a>, Hors, A., and I. Jacobs, “<a href="http://www.w3.org/TR/html401/">HTML 4.01 Specification</a>”, W3C REC-html401-19991224, December 1999, <<a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/</a>>.</td></tr><tr><td class="reference"><b id="RFC2026">[RFC2026]</b></td><td class="top"><a href="mailto:sob@harvard.edu" title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2026">The Internet Standards Process -- Revision 3</a>”, BCP 9, RFC 2026, October 1996.</td></tr><tr><td class="reference"><b id="RFC2119">[RFC2119]</b></td><td class="top"><a href="mailto:sob@harvard.edu" title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>”, BCP 14, RFC 2119, March 1997.</td></tr><tr><td class="reference"><b id="RFC2616">[RFC2616]</b></td><td class="top"><a href="mailto:fielding@ics.uci.edu" title="University of California, Irvine, Information and Computer Science">Fielding, R.</a>, <a href="mailto:jg@w3.org" title="World Wide Web Consortium, MIT Laboratory for Computer Science">Gettys, J.</a>, <a href="mailto:mogul@wrl.dec.com" title="Compaq Computer Corporation, Western Research Laboratory">Mogul, J.</a>, <a href="mailto:frystyk@w3.org" title="World Wide Web Consortium, MIT Laboratory for Computer Science">Nielsen, H.</a>, <a href="mailto:masinter@parc.xerox.com" title="Xerox Corporation">Masinter, L.</a>, <a href="mailto:paulle@microsoft.com" title="Microsoft Corporation">Leach, P.</a>, and <a href="mailto:timbl@w3.org" title="World Wide Web Consortium, MIT Laboratory for Computer Science">T. Berners-Lee</a>, “<a href="http://tools.ietf.org/html/rfc2616">Hypertext Transfer Protocol -- HTTP/1.1</a>”, RFC 2616, June 1999.</td></tr><tr><td class="reference"><b id="RFC2629">[RFC2629]</b></td><td class="top"><a href="mailto:mrose@not.invisible.net" title="Invisible Worlds, Inc.">Rose, M.</a>, “<a href="http://tools.ietf.org/html/rfc2629">Writing I-Ds and RFCs using XML</a>”, RFC 2629, June 1999.</td></tr><tr><td class="reference"><b id="RFC2648">[RFC2648]</b></td><td class="top"><a href="mailto:jayhawk@att.com" title="AT&T">Moats, R.</a>, “<a href="http://tools.ietf.org/html/rfc2648">A URN Namespace for IETF Documents</a>”, RFC 2648, August 1999.</td></tr><tr><td class="reference"><b id="RFC2731">[RFC2731]</b></td><td class="top"><a href="mailto:jak@ckm.ucsf.edu" title="University of California, San Francisco, Center for Knowledge Management">Kunze, J.</a>, “<a href="http://tools.ietf.org/html/rfc2731">Encoding Dublin Core Metadata in HTML</a>”, RFC 2731, December 1999.</td></tr><tr><td class="reference"><b id="RFC5234">[RFC5234]</b></td><td class="top"><a href="mailto:dcrocker@bbiw.net" title="Brandenburg InternetWorking">Crocker, D., Ed.</a> and <a href="mailto:paul.overell@thus.net" title="THUS plc.">P. Overell</a>, “<a href="http://tools.ietf.org/html/rfc5234">Augmented BNF for Syntax Specifications: ABNF</a>”, STD 68, RFC 5234, January 2008.</td></tr><tr><td class="reference"><b id="RFC5741">[RFC5741]</b></td><td class="top">Daigle, L. and O. Kolkman, “<a href="http://tools.ietf.org/html/rfc5741">RFC Streams, Headers, and Boilerplates</a>”, RFC 5741, December 2009.</td></tr><tr><td class="reference"><b id="RNC">[RNC]</b></td><td class="top"><a href="mailto:jjc@jclark.com">Clark, J.</a>, “<a href="http://www.oasis-open.org/committees/relax-ng/compact-20021121.html">RELAX NG Compact Syntax</a>”, OASIS, Nov 2002, <<a href="http://www.oasis-open.org/committees/relax-ng/compact-20021121.html">http://www.oasis-open.org/committees/relax-ng/compact-20021121.html</a>>.</td></tr><tr><td class="reference"><b id="XHTML2">[XHTML2]</b></td><td class="top">Axelsson, J., Birbeck, M., Dubinko, M., Epperson, B., Ishikawa, M., McCarron, S., Navarro, A., and S. Pemberton, “<a href="http://www.w3.org/TR/xhtml2">XHTML™ 2.0</a>”, W3C WD-xhtml2-20060726, July 2006, <<a href="http://www.w3.org/TR/xhtml2">http://www.w3.org/TR/xhtml2</a>>.</td></tr><tr><td class="reference"><b id="XML">[XML]</b></td><td class="top"><a href="mailto:tbray@textuality.com" title="Textuality and Netscape">Bray, T.</a>, <a href="mailto:jeanpa@microsoft.com" title="Microsoft">Paoli, J.</a>, <a href="mailto:cmsmcq@w3.org" title="W3C">Sperberg-McQueen, C.</a>, <a href="mailto:eve.maler@east.sun.com" title="Sun Microsystems">Maler, E.</a>, and F. Yergeau, “<a href="http://www.w3.org/TR/2008/REC-xml-20081126/">Extensible Markup Language (XML) 1.0 (Fifth Edition)</a>”, W3C REC-xml-20081126, November 2008, <<a href="http://www.w3.org/TR/2008/REC-xml-20081126/">http://www.w3.org/TR/2008/REC-xml-20081126/</a>>.</td></tr><tr><td class="reference"><b id="XSL-FO">[XSL-FO]</b></td><td class="top"><a href="mailto:alrb@us.ibm.com" title="IBM">Berglund, A.</a>, “<a href="http://www.w3.org/TR/2006/REC-xsl11-20061205/">Extensible Stylesheet Language (XSL) Version 1.1</a>”, W3C REC-xsl11-20061205, Dec 2006, <<a href="http://www.w3.org/TR/2006/REC-xsl11-20061205/">http://www.w3.org/TR/2006/REC-xsl11-20061205/</a>>.</td></tr></table><hr class="noprint"><div class="avoidbreak"><h1 id="rfc.authors" class="np"><a href="#rfc.authors">Author's Address</a></h1><address class="vcard"><span class="vcardline"><span class="fn">Julian F. Reschke</span><span class="n hidden"><span class="family-name">Reschke</span><span class="given-name">Julian F.</span></span></span><span class="org vcardline">greenbytes GmbH</span><span class="adr"><span class="street-address vcardline">Hafenweg 16</span><span class="vcardline"><span class="locality">Muenster</span>, <span class="region">NW</span> <span class="postal-code">48155</span></span><span class="country-name vcardline">Germany</span></span><span class="vcardline tel">Phone: <a href="tel:+492512807760"><span class="value">+49 251 2807760</span></a></span><span class="vcardline">EMail: <a href="mailto:julian.reschke@greenbytes.de"><span class="email">julian.reschke@greenbytes.de</span></a></span><span class="vcardline">URI: <a href="http://greenbytes.de/tech/webdav/" class="url">http://greenbytes.de/tech/webdav/</a></span></address></div><hr class="noprint"><div id="rfc.iref.g.3"></div><div id="rfc.iref.s.14"></div><div id="rfc.iref.r.24"></div><h1 id="rfc.section.A" class="np"><a href="#rfc.section.A">A.</a> <a id="grammar" href="#grammar">RELAX NG Compact Schema</a></h1><p id="rfc.section.A.p.1">The RelaxNG schema (<a href="#RNC" id="rfc.xref.RNC.1"><cite title="RELAX NG Compact Syntax">[RNC]</cite></a>) below can be used to validate input documents (for instance, with <a href="http://www.thaiopensource.com/relaxng/jing.html">Jing</a>).</p><p id="rfc.section.A.p.2"> <em>Note that this is work in progress, and doesn't yet cover all extensions completely.</em> </p><div id="rfc.figure.u.25"></div> <pre class="inline"><em># WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR.</em> |
|---|
| 497 | |
|---|
| 498 | <em># Define our extension namespace</em> |
|---|
| 499 | namespace x = "http://purl.org/net/xml2rfc/ext" |
|---|
| 500 | |
|---|
| 501 | <em># Define GRDDL namespace</em> |
|---|
| 502 | namespace grddl = "http://www.w3.org/2003/g/data-view#" |
|---|
| 503 | |
|---|
| 504 | <em># Define RDF namespace</em> |
|---|
| 505 | namespace rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
|---|
| 506 | |
|---|
| 507 | <em># Include rfc2629bis RNC grammar</em> |
|---|
| 508 | include "rfc2629.rnc" { |
|---|
| 509 | |
|---|
| 510 | <em># Redefine <artwork> to allow markup</em> |
|---|
| 511 | artwork = |
|---|
| 512 | element artwork { |
|---|
| 513 | attlist.artwork, |
|---|
| 514 | (TEXT |
|---|
| 515 | <strong>| eref</strong> |
|---|
| 516 | <strong>| iref</strong> |
|---|
| 517 | <strong>| spanx</strong> |
|---|
| 518 | <strong>| xref</strong> |
|---|
| 519 | <strong>| <a href="#x_abnf-char-sequence" class="smpl">x_abnf-char-sequence</a></strong> |
|---|
| 520 | <strong>| <a href="#x_bb" class="smpl">x_bb</a></strong> |
|---|
| 521 | <strong>| <a href="#x_bc" class="smpl">x_bc</a></strong> |
|---|
| 522 | <strong>| <a href="#x_bcp14" class="smpl">x_bcp14</a></strong> |
|---|
| 523 | <strong>| <a href="#x_bt" class="smpl">x_bt</a></strong> |
|---|
| 524 | <strong>| <a href="#x_highlight" class="smpl">x_highlight</a></strong> |
|---|
| 525 | <strong>| <a href="#x_length-of" class="smpl">x_length-of</a></strong> |
|---|
| 526 | <strong>| <a href="#x_parse-xml" class="smpl">x_parse-xml</a></strong> |
|---|
| 527 | <strong>| <a href="#x_ref" class="smpl">x_ref</a></strong> |
|---|
| 528 | <strong>| <a href="#x_span" class="smpl">x_span</a></strong> |
|---|
| 529 | <strong>| <a href="#x_x" class="smpl">x_x</a></strong>)* |
|---|
| 530 | } |
|---|
| 531 | |
|---|
| 532 | <em># Redefine <back> to allow boilerplate</em> |
|---|
| 533 | back = |
|---|
| 534 | element back { |
|---|
| 535 | attlist.back, |
|---|
| 536 | references*, |
|---|
| 537 | section*, |
|---|
| 538 | <strong><a href="#x_boilerplate" class="smpl">x_boilerplate</a>?</strong> |
|---|
| 539 | } |
|---|
| 540 | |
|---|
| 541 | <em># Redefine <c> to allow our extension elements</em> |
|---|
| 542 | c = |
|---|
| 543 | element c { |
|---|
| 544 | attlist.c, |
|---|
| 545 | (TEXT |
|---|
| 546 | | xref |
|---|
| 547 | | eref |
|---|
| 548 | | iref |
|---|
| 549 | | cref |
|---|
| 550 | | spanx |
|---|
| 551 | <strong>| <a href="#x_ref" class="smpl">x_ref</a></strong>)* |
|---|
| 552 | } |
|---|
| 553 | |
|---|
| 554 | <em># Redefine <cref> to allow more child elements</em> |
|---|
| 555 | cref = |
|---|
| 556 | element cref { |
|---|
| 557 | attlist.cref, |
|---|
| 558 | (TEXT |
|---|
| 559 | | eref |
|---|
| 560 | | xref)* |
|---|
| 561 | } |
|---|
| 562 | |
|---|
| 563 | <em># Redefine <front> to allow boilerplate</em> |
|---|
| 564 | front = |
|---|
| 565 | element front { |
|---|
| 566 | attlist.front, |
|---|
| 567 | title, |
|---|
| 568 | author+, |
|---|
| 569 | date, |
|---|
| 570 | area*, |
|---|
| 571 | workgroup*, |
|---|
| 572 | keyword*, |
|---|
| 573 | <strong><a href="#x_boilerplate" class="smpl">x_boilerplate</a>?,</strong> |
|---|
| 574 | abstract?, |
|---|
| 575 | note* |
|---|
| 576 | } |
|---|
| 577 | |
|---|
| 578 | <em># Redefine <list> element to allow <x:<a href="#ext.element.lt" class="smpl">lt</a>> child elements</em> |
|---|
| 579 | \list = |
|---|
| 580 | element list { |
|---|
| 581 | attlist.list, |
|---|
| 582 | (t+ <strong>| <a href="#x_lt" class="smpl">x_lt</a>+</strong>) |
|---|
| 583 | } |
|---|
| 584 | |
|---|
| 585 | <em># Redefine <preamble> to allow our extension elements</em> |
|---|
| 586 | preamble = |
|---|
| 587 | element preamble { |
|---|
| 588 | attlist.preamble, |
|---|
| 589 | (TEXT |
|---|
| 590 | | xref |
|---|
| 591 | | eref |
|---|
| 592 | | iref |
|---|
| 593 | | cref |
|---|
| 594 | | spanx |
|---|
| 595 | <strong>| <a href="#x_anchor-alias" class="smpl">x_anchor-alias</a></strong>* |
|---|
| 596 | <strong>| <a href="#x_bcp14" class="smpl">x_bcp14</a></strong>)* |
|---|
| 597 | } |
|---|
| 598 | |
|---|
| 599 | <em># Redefine <postamble> to allow our extension elements</em> |
|---|
| 600 | postamble = |
|---|
| 601 | element postamble { |
|---|
| 602 | attlist.postamble, |
|---|
| 603 | (TEXT |
|---|
| 604 | | xref |
|---|
| 605 | | eref |
|---|
| 606 | | iref |
|---|
| 607 | | cref |
|---|
| 608 | | spanx |
|---|
| 609 | <strong>| <a href="#x_bcp14" class="smpl">x_bcp14</a></strong>)* |
|---|
| 610 | } |
|---|
| 611 | |
|---|
| 612 | <em># Redefine <reference> to allow our extension elements</em> |
|---|
| 613 | reference = |
|---|
| 614 | element reference { |
|---|
| 615 | attlist.reference, |
|---|
| 616 | front, |
|---|
| 617 | seriesInfo*, |
|---|
| 618 | <strong><a href="#x_prose" class="smpl">x_prose</a>?</strong>, |
|---|
| 619 | format*, |
|---|
| 620 | annotation*, |
|---|
| 621 | <strong><a href="#x_source" class="smpl">x_source</a>?</strong> |
|---|
| 622 | } |
|---|
| 623 | |
|---|
| 624 | <em># Redefine <rfc> to allow our extension elements</em> |
|---|
| 625 | rfc = |
|---|
| 626 | element rfc { |
|---|
| 627 | attlist.rfc, |
|---|
| 628 | <strong><a href="#x_link" class="smpl">x_link</a>*,</strong> |
|---|
| 629 | <strong><a href="#x_feedback" class="smpl">x_feedback</a>?,</strong> |
|---|
| 630 | <strong><a href="#x_assign-section-number" class="smpl">x_assign-section-number</a>*,</strong> |
|---|
| 631 | front, |
|---|
| 632 | middle, |
|---|
| 633 | back? |
|---|
| 634 | } |
|---|
| 635 | |
|---|
| 636 | <em># Redefine <section> to allow our extension elements</em> |
|---|
| 637 | section = |
|---|
| 638 | element section { |
|---|
| 639 | attlist.section, |
|---|
| 640 | (t |
|---|
| 641 | | figure |
|---|
| 642 | | texttable |
|---|
| 643 | | iref |
|---|
| 644 | | section |
|---|
| 645 | <strong>| <a href="#x_anchor-alias" class="smpl">x_anchor-alias</a></strong> |
|---|
| 646 | <strong>| <a href="#x_blockquote" class="smpl">x_blockquote</a></strong> |
|---|
| 647 | <strong>| <a href="#x_include-author" class="smpl">x_include-author</a></strong> |
|---|
| 648 | <strong>| <a href="#x_note" class="smpl">x_note</a></strong> |
|---|
| 649 | <strong>| <a href="#rdf_Description" class="smpl">rdf_Description</a></strong>)* |
|---|
| 650 | } |
|---|
| 651 | |
|---|
| 652 | <em># Redefine <spanx> to allow some markup</em> |
|---|
| 653 | spanx = |
|---|
| 654 | element spanx { |
|---|
| 655 | attlist.spanx, |
|---|
| 656 | (TEXT |
|---|
| 657 | <strong>| iref</strong> |
|---|
| 658 | <strong>| xref</strong> |
|---|
| 659 | <strong>| <a href="#x_ref" class="smpl">x_ref</a></strong>)* |
|---|
| 660 | } |
|---|
| 661 | |
|---|
| 662 | <em># Redefine <t> to allow our extension elements</em> |
|---|
| 663 | t = |
|---|
| 664 | element t { |
|---|
| 665 | attlist.t, |
|---|
| 666 | (TEXT |
|---|
| 667 | | \list |
|---|
| 668 | | figure |
|---|
| 669 | | xref |
|---|
| 670 | | eref |
|---|
| 671 | | iref |
|---|
| 672 | | cref |
|---|
| 673 | | spanx |
|---|
| 674 | | vspace |
|---|
| 675 | <strong>| <a href="#x_abnf-char-sequence" class="smpl">x_abnf-char-sequence</a></strong> |
|---|
| 676 | <strong>| <a href="#x_anchor-alias" class="smpl">x_anchor-alias</a></strong> |
|---|
| 677 | <strong>| <a href="#x_bcp14" class="smpl">x_bcp14</a></strong> |
|---|
| 678 | <strong>| <a href="#x_dfn" class="smpl">x_dfn</a></strong> |
|---|
| 679 | <strong>| <a href="#x_h" class="smpl">x_h</a></strong> |
|---|
| 680 | <strong>| <a href="#x_q" class="smpl">x_q</a></strong> |
|---|
| 681 | <strong>| <a href="#x_ref" class="smpl">x_ref</a></strong> |
|---|
| 682 | <strong>| <a href="#x_sup" class="smpl">x_sup</a></strong>)* |
|---|
| 683 | } |
|---|
| 684 | } |
|---|
| 685 | |
|---|
| 686 | <em># Allow x:indent-with attribute on <artwork></em> |
|---|
| 687 | attlist.artwork &= |
|---|
| 688 | attribute x:indent-with { ATEXT }? |
|---|
| 689 | |
|---|
| 690 | <em># Allow anchor and x:annotation attributes on <author></em> |
|---|
| 691 | attlist.author &= |
|---|
| 692 | attribute anchor { xsd:ID }?, |
|---|
| 693 | attribute x:annotation { ATEXT }? |
|---|
| 694 | |
|---|
| 695 | <em># Extend attribute set for <c> (see <a href="#ext-rfc2629.iref" title="Extensions to Xml2rfc <iref> element">Section 11.24</a>)</em> |
|---|
| 696 | attlist.c &= |
|---|
| 697 | attribute anchor { xsd:ID }? |
|---|
| 698 | |
|---|
| 699 | <em># Extend attribute set for <iref> (see <a href="#ext-rfc2629.iref" title="Extensions to Xml2rfc <iref> element">Section 11.24</a>)</em> |
|---|
| 700 | attlist.iref &= |
|---|
| 701 | attribute x:for-anchor { ATEXT }? |
|---|
| 702 | |
|---|
| 703 | <em># Extend attribute set for <list> (see <a href="#ext-rfc2629.list" title="Extensions to Xml2rfc <list> element">Section 11.25</a>)</em> |
|---|
| 704 | attlist.list &= |
|---|
| 705 | attribute x:indent { ATEXT }? |
|---|
| 706 | |
|---|
| 707 | <em># Extend attribute set for <preamble></em> |
|---|
| 708 | attlist.preamble &= |
|---|
| 709 | attribute anchor { xsd:ID }? |
|---|
| 710 | |
|---|
| 711 | <em># Extend attribute set for <rfc></em> |
|---|
| 712 | attlist.rfc &= |
|---|
| 713 | attribute grddl:transformation { ATEXT }?, |
|---|
| 714 | attribute x:maturity-level { "proposed" | "draft" | "internet" }? |
|---|
| 715 | |
|---|
| 716 | <em># Extend attribute set for <section> (see <a href="#ext-rfc2629.section" title="Extensions to Xml2rfc <section> element">Section 11.27</a>)</em> |
|---|
| 717 | attlist.section &= |
|---|
| 718 | attribute x:fixed-section-number { ATEXT }? |
|---|
| 719 | |
|---|
| 720 | <em># Allow anchor attribute on <spanx></em> |
|---|
| 721 | attlist.spanx &= |
|---|
| 722 | attribute anchor { xsd:ID }? |
|---|
| 723 | |
|---|
| 724 | <em># Allow x:quotes attribute on <title></em> |
|---|
| 725 | attlist.title &= |
|---|
| 726 | attribute x:quotes { "true" | "false" }? |
|---|
| 727 | |
|---|
| 728 | <em># Allow annotation attribute on <uri></em> |
|---|
| 729 | attlist.uri &= |
|---|
| 730 | attribute x:annotation { ATEXT }? |
|---|
| 731 | |
|---|
| 732 | <em># Extend attribute set for <xref> (see <a href="#ext-rfc2629.xref" title="Extensions to Xml2rfc <xref> element">Section 11.28</a>)</em> |
|---|
| 733 | attlist.xref &= |
|---|
| 734 | attribute x:fmt { "()" | "," | "anchor" | "of" | "number" | "sec" | |
|---|
| 735 | "none" }?, |
|---|
| 736 | attribute x:rel { ATEXT }?, |
|---|
| 737 | attribute x:sec { ATEXT }? |
|---|
| 738 | |
|---|
| 739 | <em id="x_abnf-char-sequence"><span id="rfc.iref.a.29"></span><span id="rfc.iref.e.24"></span># Conversion to ABNF char sequence (see <a href="#ext.element.abnf-char-sequence" title="<abnf-char-sequence> element">Section 11.1</a>)</em> |
|---|
| 740 | <a href="#x_abnf-char-sequence" class="smpl">x_abnf-char-sequence</a> = |
|---|
| 741 | element x:abnf-char-sequence { |
|---|
| 742 | TEXT |
|---|
| 743 | } |
|---|
| 744 | |
|---|
| 745 | <em id="x_anchor-alias"><span id="rfc.iref.a.30"></span><span id="rfc.iref.e.25"></span># Aliasing of anchors (see <a href="#ext.element.anchor-alias" title="<anchor-alias> element">Section 11.2</a>)</em> |
|---|
| 746 | <a href="#x_anchor-alias" class="smpl">x_anchor-alias</a> = |
|---|
| 747 | element x:anchor-alias { |
|---|
| 748 | attribute value { TEXT }, |
|---|
| 749 | empty |
|---|
| 750 | } |
|---|
| 751 | |
|---|
| 752 | <em id="x_feedback"><span id="rfc.iref.f.5"></span><span id="rfc.iref.e.26"></span># Supply feedback links (see <a href="#ext.element.feedback" title="<feedback> element">Section 11.10</a>)</em> |
|---|
| 753 | <a href="#x_feedback" class="smpl">x_feedback</a> = |
|---|
| 754 | element x:feedback { |
|---|
| 755 | attribute template { TEXT }, |
|---|
| 756 | empty |
|---|
| 757 | } |
|---|
| 758 | |
|---|
| 759 | <em id="x_include-author"><span id="rfc.iref.i.14"></span><span id="rfc.iref.e.27"></span># Including Author information |
|---|
| 760 | # (experimental)</em> |
|---|
| 761 | <a href="#x_include-author" class="smpl">x_include-author</a> = |
|---|
| 762 | element x:include-author { |
|---|
| 763 | attribute target { xsd:IDREF } |
|---|
| 764 | } |
|---|
| 765 | |
|---|
| 766 | <em id="x_assign-section-number"><span id="rfc.iref.a.31"></span><span id="rfc.iref.e.28"></span># Setting section numbers for internally generated sections |
|---|
| 767 | # (experimental)</em> |
|---|
| 768 | <a href="#x_assign-section-number" class="smpl">x_assign-section-number</a> = |
|---|
| 769 | element x:assign-section-number { |
|---|
| 770 | attribute builtin-target { "authors" }, |
|---|
| 771 | attribute number { TEXT }, |
|---|
| 772 | empty |
|---|
| 773 | } |
|---|
| 774 | |
|---|
| 775 | <em id="x_bb"><span id="rfc.iref.b.8"></span><span id="rfc.iref.e.29"></span># Bottom line of box drawing (see <a href="#ext.element.bb" title="<bb> element">Section 11.4</a>)</em> |
|---|
| 776 | <a href="#x_bb" class="smpl">x_bb</a> = |
|---|
| 777 | element x:bb { |
|---|
| 778 | (TEXT |
|---|
| 779 | | iref |
|---|
| 780 | | xref |
|---|
| 781 | | <a href="#x_bb" class="smpl">x_bb</a> |
|---|
| 782 | | <a href="#x_bc" class="smpl">x_bc</a> |
|---|
| 783 | | <a href="#x_bt" class="smpl">x_bt</a> |
|---|
| 784 | | <a href="#x_ref" class="smpl">x_ref</a>)* |
|---|
| 785 | } |
|---|
| 786 | |
|---|
| 787 | <em id="x_bc"><span id="rfc.iref.b.9"></span><span id="rfc.iref.e.30"></span># Center line of box drawing (see <a href="#ext.element.bc" title="<bc> element">Section 11.5</a>)</em> |
|---|
| 788 | <a href="#x_bc" class="smpl">x_bc</a> = |
|---|
| 789 | element x:bc { |
|---|
| 790 | (TEXT |
|---|
| 791 | | iref |
|---|
| 792 | | spanx |
|---|
| 793 | | xref |
|---|
| 794 | | <a href="#x_bb" class="smpl">x_bb</a> |
|---|
| 795 | | <a href="#x_bc" class="smpl">x_bc</a> |
|---|
| 796 | | <a href="#x_bt" class="smpl">x_bt</a> |
|---|
| 797 | | <a href="#x_ref" class="smpl">x_ref</a>)* |
|---|
| 798 | } |
|---|
| 799 | |
|---|
| 800 | <em id="x_bcp14"><span id="rfc.iref.b.10"></span><span id="rfc.iref.e.31"></span># BCP14/RFC2119 keywords (see <a href="#ext.element.bcp14" title="<bcp14> element">Section 11.3</a>)</em> |
|---|
| 801 | <a href="#x_bcp14" class="smpl">x_bcp14</a> = |
|---|
| 802 | element x:bcp14 { |
|---|
| 803 | "MAY" |
|---|
| 804 | | "MUST" |
|---|
| 805 | | "MUST NOT" |
|---|
| 806 | | "NOT RECOMMENDED" |
|---|
| 807 | | "OPTIONAL" |
|---|
| 808 | | "RECOMMENDED" |
|---|
| 809 | | "REQUIRED" |
|---|
| 810 | | "SHALL" |
|---|
| 811 | | "SHALL NOT" |
|---|
| 812 | | "SHOULD" |
|---|
| 813 | | "SHOULD NOT" |
|---|
| 814 | } |
|---|
| 815 | |
|---|
| 816 | <em id="x_blockquote"><span id="rfc.iref.b.11"></span><span id="rfc.iref.e.32"></span># Blockquote (see <a href="#ext.element.blockquote" title="<blockquote> element">Section 11.6</a>)</em> |
|---|
| 817 | <a href="#x_blockquote" class="smpl">x_blockquote</a> = |
|---|
| 818 | element x:blockquote { |
|---|
| 819 | attribute cite { URI }?, |
|---|
| 820 | t+ |
|---|
| 821 | } |
|---|
| 822 | |
|---|
| 823 | <em id="x_boilerplate"><span id="rfc.iref.b.12"></span><span id="rfc.iref.e.33"></span># Boilerplate (see <a href="#ext.element.blockquote" title="<blockquote> element">Section 11.6</a>) </em> |
|---|
| 824 | <a href="#x_boilerplate" class="smpl">x_boilerplate</a> = |
|---|
| 825 | element x:boilerplate { |
|---|
| 826 | section+ |
|---|
| 827 | } |
|---|
| 828 | |
|---|
| 829 | <em id="x_bt"><span id="rfc.iref.b.13"></span><span id="rfc.iref.e.34"></span># Top line of box drawing (see <a href="#ext.element.bt" title="<bt> element">Section 11.8</a>)</em> |
|---|
| 830 | <a href="#x_bt" class="smpl">x_bt</a> = |
|---|
| 831 | element x:bt { |
|---|
| 832 | (TEXT |
|---|
| 833 | | iref |
|---|
| 834 | | xref |
|---|
| 835 | | <a href="#x_bb" class="smpl">x_bb</a> |
|---|
| 836 | | <a href="#x_bc" class="smpl">x_bc</a> |
|---|
| 837 | | <a href="#x_bt" class="smpl">x_bt</a> |
|---|
| 838 | | <a href="#x_ref" class="smpl">x_ref</a>)* |
|---|
| 839 | } |
|---|
| 840 | |
|---|
| 841 | <em id="x_dfn"><span id="rfc.iref.d.11"></span><span id="rfc.iref.e.35"></span># Definition (see <a href="#ext.element.dfn" title="<dfn> element">Section 11.9</a>)</em> |
|---|
| 842 | <a href="#x_dfn" class="smpl">x_dfn</a> = |
|---|
| 843 | element x:dfn { |
|---|
| 844 | attribute anchor { xsd:ID }?, |
|---|
| 845 | (TEXT |
|---|
| 846 | | iref)* |
|---|
| 847 | } |
|---|
| 848 | |
|---|
| 849 | <em id="x_h"><span id="rfc.iref.h.14"></span><span id="rfc.iref.e.36"></span># Heading (see <a href="#ext.element.h" title="<h> element">Section 11.11</a>)</em> |
|---|
| 850 | <a href="#x_h" class="smpl">x_h</a> = |
|---|
| 851 | element x:h { |
|---|
| 852 | TEXT |
|---|
| 853 | } |
|---|
| 854 | |
|---|
| 855 | <em id="x_highlight"><span id="rfc.iref.h.15"></span><span id="rfc.iref.e.37"></span># Heading (see <a href="#ext.element.highlight" title="<highlight> element">Section 11.12</a>)</em> |
|---|
| 856 | <a href="#x_highlight" class="smpl">x_highlight</a> = |
|---|
| 857 | element x:highlight { |
|---|
| 858 | TEXT |
|---|
| 859 | } |
|---|
| 860 | |
|---|
| 861 | <em id="x_length-of"><span id="rfc.iref.l.5"></span><span id="rfc.iref.e.38"></span># Length Measurement (see <a href="#ext.element.length-of" title="<length-of> element">Section 11.13</a>)</em> |
|---|
| 862 | <a href="#x_length-of" class="smpl">x_length-of</a> = |
|---|
| 863 | element x:length-of { |
|---|
| 864 | attribute indented { NUMBER }?, |
|---|
| 865 | attribute target { xsd:IDREF }, |
|---|
| 866 | empty |
|---|
| 867 | } |
|---|
| 868 | |
|---|
| 869 | <em id="x_link"><span id="rfc.iref.l.6"></span><span id="rfc.iref.e.39"></span># Link (see <a href="#ext.element.link" title="<link> element">Section 11.14</a>)</em> |
|---|
| 870 | <a href="#x_link" class="smpl">x_link</a> = |
|---|
| 871 | element x:link { |
|---|
| 872 | attribute basename { URI }?, |
|---|
| 873 | attribute href { URI }?, |
|---|
| 874 | attribute title { TEXT }?, |
|---|
| 875 | attribute rel { TEXT }, |
|---|
| 876 | empty |
|---|
| 877 | } |
|---|
| 878 | |
|---|
| 879 | <em id="x_lt"><span id="rfc.iref.l.7"></span><span id="rfc.iref.e.40"></span># Extended list item (see <a href="#ext.element.lt" title="<lt> element">Section 11.15</a>)</em> |
|---|
| 880 | <a href="#x_lt" class="smpl">x_lt</a> = |
|---|
| 881 | element x:lt { |
|---|
| 882 | attribute anchor { xsd:ID }?, |
|---|
| 883 | attribute hangText { TEXT }?, |
|---|
| 884 | t+ |
|---|
| 885 | } |
|---|
| 886 | |
|---|
| 887 | <em id="x_note"><span id="rfc.iref.n.4"></span><span id="rfc.iref.e.41"></span># Note (see <a href="#ext.element.note" title="<note> element">Section 11.16</a>)</em> |
|---|
| 888 | <a href="#x_note" class="smpl">x_note</a> = |
|---|
| 889 | element x:note { |
|---|
| 890 | t+ |
|---|
| 891 | } |
|---|
| 892 | |
|---|
| 893 | <em id="x_parse-xml"><span id="rfc.iref.p.64"></span><span id="rfc.iref.e.42"></span># Signal XML content (see <a href="#ext.element.parse-xml" title="<parse-xml> element">Section 11.17</a>)</em> |
|---|
| 894 | <a href="#x_parse-xml" class="smpl">x_parse-xml</a> = |
|---|
| 895 | element x:parse-xml { |
|---|
| 896 | (TEXT |
|---|
| 897 | | xref)* |
|---|
| 898 | } |
|---|
| 899 | |
|---|
| 900 | <em id="x_prose"><span id="rfc.iref.p.65"></span><span id="rfc.iref.e.43"></span># Inline prose in a reference (see <a href="#ext.element.prose" title="<prose> element">Section 11.18</a>)</em> |
|---|
| 901 | <a href="#x_prose" class="smpl">x_prose</a> = |
|---|
| 902 | element x:prose { |
|---|
| 903 | TEXT |
|---|
| 904 | } |
|---|
| 905 | |
|---|
| 906 | <em id="x_q"><span id="rfc.iref.q.2"></span><span id="rfc.iref.e.44"></span># Inline quote (see <a href="#ext.element.q" title="<q> element">Section 11.19</a>)</em> |
|---|
| 907 | <a href="#x_q" class="smpl">x_q</a> = |
|---|
| 908 | element x:q { |
|---|
| 909 | TEXT |
|---|
| 910 | } |
|---|
| 911 | |
|---|
| 912 | <em id="x_ref"><span id="rfc.iref.r.25"></span><span id="rfc.iref.e.45"></span># Anchor reference (see <a href="#ext.element.ref" title="<ref> element">Section 11.20</a>)</em> |
|---|
| 913 | <a href="#x_ref" class="smpl">x_ref</a> = |
|---|
| 914 | element x:ref { |
|---|
| 915 | attribute anchor { xsd:ID }?, |
|---|
| 916 | TEXT |
|---|
| 917 | } |
|---|
| 918 | |
|---|
| 919 | <em id="x_source"><span id="rfc.iref.s.15"></span><span id="rfc.iref.e.46"></span># source information (see <a href="#ext.element.source" title="<source> element">Section 11.21</a>)</em> |
|---|
| 920 | <a href="#x_source" class="smpl">x_source</a> = |
|---|
| 921 | element x:source { |
|---|
| 922 | attribute basename { ATEXT }?, |
|---|
| 923 | attribute href { URI }, |
|---|
| 924 | empty |
|---|
| 925 | } |
|---|
| 926 | |
|---|
| 927 | <em id="x_sup"><span id="rfc.iref.s.16"></span><span id="rfc.iref.e.47"></span># superscript (see <a href="#ext.element.sup" title="<sup> element">Section 11.22</a>)</em> |
|---|
| 928 | <a href="#x_sup" class="smpl">x_sup</a> = |
|---|
| 929 | element x:sup { |
|---|
| 930 | TEXT |
|---|
| 931 | } |
|---|
| 932 | |
|---|
| 933 | <em id="x_span"><span id="rfc.iref.s.17"></span><span id="rfc.iref.e.48"></span># Inline Span </em> |
|---|
| 934 | <a href="#x_span" class="smpl">x_span</a> = |
|---|
| 935 | element x:span { |
|---|
| 936 | attribute anchor { xsd:ID }?, |
|---|
| 937 | (TEXT |
|---|
| 938 | | <a href="#x_parse-xml" class="smpl">x_parse-xml</a>)* |
|---|
| 939 | } |
|---|
| 940 | |
|---|
| 941 | <em id="x_x"><span id="rfc.iref.x.31"></span><span id="rfc.iref.e.49"></span># Nop (for alignment in source)</em> |
|---|
| 942 | <a href="#x_x" class="smpl">x_x</a> = |
|---|
| 943 | element x:x { |
|---|
| 944 | empty |
|---|
| 945 | } |
|---|
| 946 | |
|---|
| 947 | <em id="rdf_Description"><span id="rfc.iref.r.26"></span><span id="rfc.iref.e.50"></span># Embed RDF statements </em> |
|---|
| 948 | <a href="#rdf_Description" class="smpl">rdf_Description</a> = |
|---|
| 949 | element rdf:Description { |
|---|
| 950 | rdf_content |
|---|
| 951 | } |
|---|
| 952 | |
|---|
| 953 | rdf_content = |
|---|
| 954 | ( TEXT | element * { rdf_content })* |
|---|
| 955 | </pre><hr class="noprint"><h1 id="rfc.section.B" class="np"><a href="#rfc.section.B">B.</a> Implementation Notes</h1><h2 id="rfc.section.B.1"><a href="#rfc.section.B.1">B.1</a> Recognized type attributes for <artwork> element</h2><p id="rfc.section.B.1.p.1">Specific values in the <artwork> element's "type" attribute are recognized and cause a different visual style to be used:</p><div id="rfc.table.u.9"><table class="tt full center" cellpadding="3" cellspacing="0"><thead><tr><th>Media Type</th><th>Comment</th></tr></thead><tbody><tr><td class="left">abnf</td><td class="left">ABNF as per <a href="#RFC5234" id="rfc.xref.RFC5234.1"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a></td></tr><tr><td class="left">abnf2616</td><td class="left">ABNF as per <a href="#RFC2616" id="rfc.xref.RFC2616.1"><cite title="Hypertext Transfer Protocol -- HTTP/1.1">[RFC2616]</cite></a>, <a href="http://tools.ietf.org/html/rfc2616#section-2.1">Section 2.1</a></td></tr><tr><td class="left">application/relax-ng-compact-syntax</td><td class="left">Relax NG Compact Syntax as per <a href="#RNC" id="rfc.xref.RNC.2"><cite title="RELAX NG Compact Syntax">[RNC]</cite></a></td></tr><tr><td class="left">application/xml-dtd</td><td class="left">XML DTD</td></tr><tr><td class="left">message/http; msgtype="request"</td><td class="left">HTTP message, as per <a href="#RFC2616" id="rfc.xref.RFC2616.2"><cite title="Hypertext Transfer Protocol -- HTTP/1.1">[RFC2616]</cite></a>, <a href="http://tools.ietf.org/html/rfc2616#section-19.1">Section 19.1</a></td></tr><tr><td class="left">message/http; msgtype="response"</td><td class="left">HTTP message, as per <a href="#RFC2616" id="rfc.xref.RFC2616.3"><cite title="Hypertext Transfer Protocol -- HTTP/1.1">[RFC2616]</cite></a>, <a href="http://tools.ietf.org/html/rfc2616#section-19.1">Section 19.1</a></td></tr></tbody></table></div><hr class="noprint"><h1 id="rfc.section.C" class="np"><a href="#rfc.section.C">C.</a> <a id="examples" href="#examples">Examples</a></h1><h2 id="rfc.section.C.1"><a href="#rfc.section.C.1">C.1</a> <a id="examples.internalsubset" href="#examples.internalsubset">Using the 'Internal Subset'</a></h2><p id="rfc.section.C.1.p.1">The prolog of the XML document can both be used to refer to an external DTD, and also to define internal entities (<a href="http://www.w3.org/TR/2008/REC-xml-20081126/#sec-prolog-dtd">Section 2.8</a> of <a href="#XML" id="rfc.xref.XML.1"><cite title="Extensible Markup Language (XML) 1.0 (Fifth Edition)">[XML]</cite></a>):</p><div id="rfc.figure.u.26"></div><pre class="text"><?xml version="1.0"?> |
|---|
| 956 | <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> |
|---|
| 957 | |
|---|
| 958 | <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [ |
|---|
| 959 | |
|---|
| 960 | <!-- <em>use "&MAY;" for a BCP 14 "MAY", see <a href="#ext.element.bcp14" title="<bcp14> element">Section 11.3</a></em> --> |
|---|
| 961 | <!ENTITY MAY |
|---|
| 962 | "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY</bcp14>"> |
|---|
| 963 | |
|---|
| 964 | <!-- <em>re-declare "&nbsp;" as code point 160 (non-breaking space)</em> --> |
|---|
| 965 | <!-- <em>you may need this for UAs that do not read external DTDs</em> --> |
|---|
| 966 | <!ENTITY nbsp |
|---|
| 967 | "&#160;"> |
|---|
| 968 | |
|---|
| 969 | <!-- <em>allow later RFC2616 reference using "&rfc2616;"</em> --> |
|---|
| 970 | <!-- <em>the data will be fetched from xml.resource.org</em> --> |
|---|
| 971 | <!ENTITY rfc2616 PUBLIC |
|---|
| 972 | "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"> |
|---|
| 973 | |
|---|
| 974 | <!-- <em>allow a custom reference using "&mydraft;"</em> --> |
|---|
| 975 | <!-- <em>the data will be fetched from the same location as the |
|---|
| 976 | source file</em> --> |
|---|
| 977 | <!ENTITY mydraft PUBLIC "reference.mydraft.xml"> |
|---|
| 978 | ]> |
|---|
| 979 | </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.27"></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" |
|---|
| 980 | version="1.0"> |
|---|
| 981 | |
|---|
| 982 | <xsl:import href="rfc2629toFO.xslt"/> |
|---|
| 983 | |
|---|
| 984 | <xsl:attribute-set name="h1"> |
|---|
| 985 | <xsl:attribute name="color">darkblue</xsl:attribute> |
|---|
| 986 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
|---|
| 987 | <xsl:attribute name="space-before">24pt</xsl:attribute> |
|---|
| 988 | </xsl:attribute-set> |
|---|
| 989 | |
|---|
| 990 | <xsl:attribute-set name="h2"> |
|---|
| 991 | <xsl:attribute name="color">darkblue</xsl:attribute> |
|---|
| 992 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
|---|
| 993 | <xsl:attribute name="space-before">18pt</xsl:attribute> |
|---|
| 994 | <xsl:attribute name="space-after">3pt</xsl:attribute> |
|---|
| 995 | </xsl:attribute-set> |
|---|
| 996 | |
|---|
| 997 | <xsl:attribute-set name="h3"> |
|---|
| 998 | <xsl:attribute name="color">darkblue</xsl:attribute> |
|---|
| 999 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
|---|
| 1000 | <xsl:attribute name="space-before">16pt</xsl:attribute> |
|---|
| 1001 | <xsl:attribute name="space-after">2pt</xsl:attribute> |
|---|
| 1002 | </xsl:attribute-set> |
|---|
| 1003 | |
|---|
| 1004 | </xsl:transform> |
|---|
| 1005 | </pre><div class="note" id="rfc.section.C.2.p.3"> <p> <b>Note:</b> the name for the attribute sets may change in the future as more working is done with respect to customizability. In any case, overriding the settings in a separate file will be easier to maintain. Please contact the author if you find yourself trying to override style definitions that currently do not use attribute sets.</p> <p> <b>Note:</b> the CSS style information used in <samp>rfc2629.xslt</samp> can be overriden in a similar (but less granular) way: just overwrite the template called "insertCss". As for XSL-FO, the class names may change in future.</p> </div><hr class="noprint"><h1 id="rfc.section.D" class="np"><a href="#rfc.section.D">D.</a> <a id="boilerplate" href="#boilerplate">Producing the IETF 'Boilerplate'</a></h1><p id="rfc.section.D.p.1">Various attributes of the <samp><rfc></samp> element plus some child elements of <samp><front></samp> affect the automatically generated parts of the front page, such as the tabular information at the beginning, the "Status Of This Memo", and the "Copyright Notice".</p><p id="rfc.section.D.p.2">When submitting an Internet Draft, this "boilerplate" is checked by "Idnits" (<<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>>) for compliance with the current Intellectual Property rules, and thus it is important to set the correct values.</p><p id="rfc.section.D.p.3">Furthermore, the RFC Production Center uses RFC2629-based tools to generate the final RFC text, so the more accurate the supplied information is, the less additional work is left, and the risk for errors in producing the final (and immutable!) document is reduced.</p><div class="note" id="rfc.section.D.p.4"> <p> <b>Note:</b> this only applies to the case when IETF documents are produced. The "private" processing instruction <span id="rfc.iref.p.66"></span><span id="rfc.iref.p.67"></span> allows to switch off most of the autogeneration logic.</p> </div><h2 id="rfc.section.D.1"><a href="#rfc.section.D.1">D.1</a> <a id="attribute-ipr" href="#attribute-ipr">The /rfc/@ipr Attribute</a></h2><p id="rfc.section.D.1.p.1">As of the time of this writing, this attribute value can take a long list of values. As frequently, this is not the result of a grand plan, but simply for historic reasons. Of these values, only a few are currently in use; all others are supported by the various tools for backwards compatibility with old source files.</p><div class="note" id="rfc.section.D.1.p.2"> <p> <b>Note:</b> some variations of the boilerplate are selected based on the document's date; therefore it is important to specify the "year", "month" and "day" attributes of the <samp><date></samp> element when archiving the XML source of an Internet Draft on the day of submission.</p> </div><p id="rfc.section.D.1.p.3"> <em>Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER.</em> For further information, refer to <<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>>.</p><p id="rfc.section.D.1.p.4">Finally, for the current "Status Of This Memo" text, the <samp>submissionType</samp> attribute determines whether a statement about "Code Components" is inserted (this is the case for the value "IETF", which also happens to be the default). Other values, such as "independent", suppress this part of the text.</p><h3 id="rfc.section.D.1.1"><a href="#rfc.section.D.1.1">D.1.1</a> <a id="attribute-ipr-current" href="#attribute-ipr-current">Current Values: '*trust200902'</a></h3><p id="rfc.section.D.1.1.p.1">The name for these values refers to the "TLP" ("IETF TRUST Legal Provisions Relating to IETF Documents"), on effect February 15, 2009 (see <<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090215.pdf</a>>). Updates to this document were published on September 12, 2009 (TLP 3.0, <<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>>) and on December 28, 2009 (TLP 4.0, <<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>>), modifying the license for code components. The actual text is located in Section 6 ("Text To Be Included in IETF Documents") of these documents.</p><p id="rfc.section.D.1.1.p.2">The tools will automatically produce the "right" text depending on the document's date information (see above):</p><div id="rfc.table.u.10"><table class="tt full left" cellpadding="3" cellspacing="0"><thead><tr><th>TLP</th><th>URI</th><th>starting with publication date</th></tr></thead><tbody><tr><td class="left">3.0</td><td class="left"><<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20090912.pdf</a>></td><td class="left">2009-11-01</td></tr><tr><td class="left">4.0</td><td class="left"><<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy-20091228.pdf</a>></td><td class="left">2010-04-01</td></tr></tbody></table></div><h4 id="rfc.section.D.1.1.1"><a href="#rfc.section.D.1.1.1">D.1.1.1</a> <a id="attribute-ipr-trust200902" href="#attribute-ipr-trust200902">trust200902</a></h4><p id="rfc.section.D.1.1.1.p.1">This should be the default, unless one of the more specific '*trust200902' values is a better fit. It produces the text in Sections 6.a and 6.b of the TLP.</p><h4 id="rfc.section.D.1.1.2"><a href="#rfc.section.D.1.1.2">D.1.1.2</a> <a id="attribute-ipr-noModificationTrust200902" href="#attribute-ipr-noModificationTrust200902">noModificationTrust200902</a></h4><p id="rfc.section.D.1.1.2.p.1">This produces the additional text from Section 6.c.i of the TLP:</p><blockquote id="rfc.section.D.1.1.2.p.2"> <p>This document may not be modified, and derivative works of it may not be created, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><div class="note" id="rfc.section.D.1.1.2.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.3"><a href="#rfc.section.D.1.1.3">D.1.1.3</a> <a id="attribute-ipr-noDerivativesTrust200902" href="#attribute-ipr-noDerivativesTrust200902">noDerivativesTrust200902</a></h4><p id="rfc.section.D.1.1.3.p.1">This produces the additional text from Section 6.c.ii of the TLP:</p><blockquote id="rfc.section.D.1.1.3.p.2"> <p>This document may not be modified, and derivative works of it may not be created, and it may not be published except as an Internet-Draft.</p> </blockquote><div class="note" id="rfc.section.D.1.1.3.p.3"> <p> <b>Note:</b> this clause is incompatible with RFCs to be published on the Standards Track.</p> </div><h4 id="rfc.section.D.1.1.4"><a href="#rfc.section.D.1.1.4">D.1.1.4</a> <a id="attribute-ipr-pre5378Trust200902" href="#attribute-ipr-pre5378Trust200902">pre5378Trust200902</a></h4><p id="rfc.section.D.1.1.4.p.1">This produces the additional text from Section 6.c.iii of the TLP, frequently called the "pre-5378 escape clause":</p><blockquote id="rfc.section.D.1.1.4.p.2"> <p>This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.</p> </blockquote><p id="rfc.section.D.1.1.4.p.3">See Section 4 of <<a href="http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf">http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf</a>> for further information about when to use this value.</p><div class="note" id="rfc.section.D.1.1.4.p.4"> <p> <b>Note:</b> this text appears under "Copyright Notice", unless the document was published before November 2009, in which case it appears under "Status Of This Memo".</p> </div><h3 id="rfc.section.D.1.2"><a href="#rfc.section.D.1.2">D.1.2</a> <a id="attribute-ipr-historic" href="#attribute-ipr-historic">Historic Values</a></h3><h4 id="rfc.section.D.1.2.1"><a href="#rfc.section.D.1.2.1">D.1.2.1</a> <a id="attribute-ipr-200811" href="#attribute-ipr-200811">Historic Values: '*trust200811'</a></h4><p id="rfc.section.D.1.2.1.p.1">The attribute values "<span id="attribute-ipr-trust200811">trust200811</span>", "<span id="attribute-ipr-noModificationTrust200811">noModificationTrust200811</span>" and "<span id="attribute-ipr-noDerivativesTrust200811">noDerivativesTrust200811</span>" are similar to their "trust200902" counterparts, except that they use text specified in <<a href="http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf">http://trustee.ietf.org/license-info/archive/IETF-Trust-License-Policy_11-10-08.pdf</a>>.</p><h4 id="rfc.section.D.1.2.2"><a href="#rfc.section.D.1.2.2">D.1.2.2</a> <a id="attribute-ipr-3978" href="#attribute-ipr-3978">Historic Values: '*3978'</a></h4><p id="rfc.section.D.1.2.2.p.1">The attribute values "<span id="attribute-ipr-full3978">full3978</span>", "<span id="attribute-ipr-noModification3978">noModification3978</span>" and "<span id="attribute-ipr-noDerivatives3978">noDerivatives3978</span>" are similar to their counterparts above, except that they use text specified in RFC 3978 (March 2005).</p><h4 id="rfc.section.D.1.2.3"><a href="#rfc.section.D.1.2.3">D.1.2.3</a> <a id="attribute-ipr-3667" href="#attribute-ipr-3667">Historic Values: '*3667'</a></h4><p id="rfc.section.D.1.2.3.p.1">The attribute values "<span id="attribute-ipr-full3667">full3667</span>", "<span id="attribute-ipr-noModification3667">noModification3667</span>" and "<span id="attribute-ipr-noDerivatives3667">noDerivatives3667</span>" are similar to their counterparts above, except that they use text specified in RFC 3667 (February 2004).</p><h4 id="rfc.section.D.1.2.4"><a href="#rfc.section.D.1.2.4">D.1.2.4</a> <a id="attribute-ipr-2026" href="#attribute-ipr-2026">Historic Values: '*2026'</a></h4><p id="rfc.section.D.1.2.4.p.1">The attribute values "<span id="attribute-ipr-full2026">full2026</span>" and "<span id="attribute-ipr-noDerivativeWorks2026">noDerivativeWorks2026</span>" are similar to their counterparts above, except that they use text specified in RFC 2026 (October 1996).</p><p id="rfc.section.D.1.2.4.p.2">The special value "<span id="attribute-ipr-none">none</span>" was also used back then, and denied the IETF any rights beyond publication as Internet Draft.</p><h2 id="rfc.section.D.2"><a href="#rfc.section.D.2">D.2</a> <a id="attribute-category" href="#attribute-category">The /rfc/@category Attribute</a></h2><p id="rfc.section.D.2.p.1">For RFCs, the <samp>category</samp> determines the "maturity level" (see <a href="http://tools.ietf.org/html/rfc2026#section-4">Section 4</a> of <a href="#RFC2026" id="rfc.xref.RFC2026.2"><cite title="The Internet Standards Process -- Revision 3">[RFC2026]</cite></a>). The allowed values are "std" for "Standards Track", "bcp" for "BCP", "info" for "Informational", "exp" for "Experimental", and "historic" for - surprise - "Historic".</p><p id="rfc.section.D.2.p.2">For Internet Drafts, the category attribute is not needed, but <em>will</em> appear on the front page ("Intended Status"). Supplying this information can be useful, because reviewers may want to know.</p><div class="note" id="rfc.section.D.2.p.3"> <p> <b>Note:</b> the Standards Track consists of "Proposed Standard", "Draft Standards", and "Internet Standard". These do not appear in the boilerplate, thus the category attribute doesn't handle them. However, this information can be useful for validity checkers, and thus <samp>rfc2629.xslt</samp> supports an extension attribute for that purpose (see <a href="#ext-rfc2629.rfc" title="Extensions to Xml2rfc <rfc> element">Section 11.26</a> for details).</p> </div><h2 id="rfc.section.D.3"><a href="#rfc.section.D.3">D.3</a> <a id="attribute-submissiontype" href="#attribute-submissiontype">The /rfc/@submissionType Attribute</a></h2><p id="rfc.section.D.3.p.1">The RFC Editor publishes documents from different "document streams", of which the "IETF stream" of course is the most prominent one. Other streams are the "independent stream" (used for things like administrative information or April 1st RFCs), the "IAB stream" (Internet Architecture Board) and the "IRTF stream" (Internet Research Task Force).</p><p id="rfc.section.D.3.p.2">Not surprisingly, the values for the attribute are "IETF" (the default value), "independent", "IAB", and "IRTF".</p><p id="rfc.section.D.3.p.3">Historically, this did not affect the final appearance of RFCs, except for subtle differences in Copyright notices. Nowadays (as of <a href="#RFC5741" id="rfc.xref.RFC5741.1"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>), the stream name appears in the first line of the front page, and it also affects the text in the "Status Of This Memo" section.</p><p id="rfc.section.D.3.p.4">For current documents, setting <samp>submissionType</samp> attribute will have the following effect: </p><ul><li>For RFCs, the stream name appears in the upper left corner of the first page (in Internet Drafts, this is either "Network Working Group", or the value of the <samp><workgroup></samp> element).</li><li>For RFCs, if affects the whole "Status Of This Memo" section (see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.2"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</li><li>For all RFCs and Internet Drafts, it determines whether the "Copyright Notice" mentions the Copyright on Code Components (see TLP, Section "Text To Be Included in IETF Documents").</li></ul><h2 id="rfc.section.D.4"><a href="#rfc.section.D.4">D.4</a> <a id="attribute-consensus" href="#attribute-consensus">The /rfc/@consensus Attribute</a></h2><p id="rfc.section.D.4.p.1">For some of the publication streams (see <a href="#attribute-submissiontype" title="The /rfc/@submissionType Attribute">Appendix D.3</a>), the "Status Of This Memo" section depends on whether there was a consensus to publish (again, see <a href="http://tools.ietf.org/html/rfc5741#section-3.2.2">Section 3.2.2</a> of <a href="#RFC5741" id="rfc.xref.RFC5741.3"><cite title="RFC Streams, Headers, and Boilerplates">[RFC5741]</cite></a>).</p><p id="rfc.section.D.4.p.2">The <samp>consensus</samp> attribute ("yes"/"no", defaulting to "yes") can be used to supply this information. The effect for the various streams is: </p><ul><li>"independent" and "IAB": none.</li><li>"IETF": mention that there was an IETF consensus.</li><li>"IRTF": mention that there was a research group consensus (where the name of the research group is extracted from the <samp><workgroup></samp> element).</li></ul><h2 id="rfc.section.D.5"><a href="#rfc.section.D.5">D.5</a> <a id="attribute-number" href="#attribute-number">The /rfc/@number Attribute</a></h2><p id="rfc.section.D.5.p.1">For RFCs, this attribute supplies the RFC number.</p><h2 id="rfc.section.D.6"><a href="#rfc.section.D.6">D.6</a> <a id="attribute-docname" href="#attribute-docname">The /rfc/@docName Attribute</a></h2><p id="rfc.section.D.6.p.1">For Internet Drafts, this specifies the draft name (which appears below the title). The file extension is <em>not</em> part of the draft, so in general it should end with the current draft number ("-", plus two digits).</p><div class="note" id="rfc.section.D.6.p.2"> <p> <b>Note:</b> "Idnits" (<<a href="http://tools.ietf.org/tools/idnits/">http://tools.ietf.org/tools/idnits/</a>>) checks the in-document draft name for consistency with the filename of the submitted document.</p> </div><h2 id="rfc.section.D.7"><a href="#rfc.section.D.7">D.7</a> <a id="attribute-obsoletes" href="#attribute-obsoletes">The /rfc/@obsoletes Attribute</a></h2><p id="rfc.section.D.7.p.1">The RFC Editor maintains a database (<<a href="http://www.rfc-editor.org/rfc.html">http://www.rfc-editor.org/rfc.html</a>>) of all RFCs, including information about which one obsoletes which. Upon publication of an RFC, this database is updated from the data on the front page.</p><p id="rfc.section.D.7.p.2">This attribute takes a list of comma-separated RFC <em>numbers</em>. Do <em>not</em> put the string "RFC" here.</p><h2 id="rfc.section.D.8"><a href="#rfc.section.D.8">D.8</a> <a id="attribute-updates" href="#attribute-updates">The /rfc/@updates Attribute</a></h2><p id="rfc.section.D.8.p.1">This is like <samp>obsoletes</samp>, but for the "updates" relation.</p><hr class="noprint"><h1 id="rfc.section.E" class="np"><a href="#rfc.section.E">E.</a> <a id="license" href="#license">License</a></h1><p id="rfc.section.E.p.1">Copyright (c) 2006-2010, Julian Reschke (julian.reschke@greenbytes.de)</p><p id="rfc.section.E.p.2">All rights reserved.</p><p id="rfc.section.E.p.3">Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: </p><ul><li>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</li><li>Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</li><li>Neither the name of Julian Reschke nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</li></ul><p id="rfc.section.E.p.4">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p><hr class="noprint"><h1 id="rfc.section.F" class="np"><a href="#rfc.section.F">F.</a> Change Logs</h1><h2 id="rfc.section.F.1"><a href="#rfc.section.F.1">F.1</a> Package</h2><dl><dt>2006-01-01</dt><dd>Switch to BSD License.</dd><dt>2007-01-12</dt><dd>Update to xml2rfc v1.33pre2.</dd><dt>2007-03-31</dt><dd>Update to xml2rfc v1.33pre3.</dd><dt>2007-05-01</dt><dd>Add XSLT test cases.</dd><dt>2008-07-18</dt><dd>Experimental support for inlined rdf:Description elements (ignored by the formatter, extracted by rfc2629grddl).</dd><dt>2008-12-04</dt><dd>Update to xml2rfc v1.34pre2.</dd><dt>2009-02-24</dt><dd>Experimental support for February 2009 boilerplate changes, and for the x:boilerplate element.</dd><dt>2009-07-08</dt><dd>Support new boilerplate ordering in RFCs published since July 2009. Fix problems with one-column text tables.</dd><dt>2009-07-19</dt><dd>When possible, calculate the actual Expiry date for Internet Drafts (full date must be available).</dd><dt>2009-08-01</dt><dd>For '$xml2rfc-ext-authors-section='end'", move the index in front of the authors section.</dd><dt>2009-08-04</dt><dd>Consider /rfc/@ipr="pre5378Trust200902" when producing RFCs, not IDs.</dd><dt>2009-08-29</dt><dd>Support alignment for artwork containing images (as opposed to, well, artwork).</dd><dt>2009-09-01</dt><dd>Allow xref in cref (as extension).</dd><dt>2009-09-14</dt><dd>Refactor handling of processing instructions.</dd><dt>2009-09-24</dt><dd>Fix typo in Status Of This Memo, present since November 2008. Fix formatting of iprExtract attribute. Starting with Internet Draft publication dates after 2009-11-30: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Add support for refparent PI. For RFCs: use new TLP text as of September 2009. Incorporate xml2rfc v1.34pre4.</dd><dt>2009-10-06</dt><dd>Starting with Internet Draft publication dates after 2009-10-31: use new Trust Legal Provisions text; for Internet Drafts: move Abstract up, and move "pre5378" escape clause to the Copyright Notice. Incorporate xml2rfc v1.34pre5.</dd><dt>2009-10-27</dt><dd>Upgrade to xml2rfc v1.34.</dd><dt>2010-01-08</dt><dd>For RFC generation (not IDs), experimentally support RFC 5741 headers and boilerplate and Trust Legal Provisions 4.0.</dd><dt>2010-03-31</dt><dd>Upgrade to xml2rfc v1.35.</dd><dt>2010-06-27</dt><dd>Be consistent with xml2rfc.tcl in formatting initials (truncate after the first); see <<a href="http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10">http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10</a>>.</dd><dt>2010-08-31</dt><dd>Experimental support for prose in references.</dd><dt>2011-01-27</dt><dd>Update to xml2rfc v1.36pre1.</dd><dt>2011-04-17</dt><dd>Update to xml2rfc v1.36. Add support for more /rfc/@ipr values when producing RFCs.</dd></dl><h2 id="rfc.section.F.2"><a href="#rfc.section.F.2">F.2</a> amazon-asin.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2005-04-02</dt><dd>Fix two DTD issues.</dd></dl><h2 id="rfc.section.F.3"><a href="#rfc.section.F.3">F.3</a> check-references.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2004-05-11</dt><dd>Add document status; print references type.</dd><dt>2005-01-01</dt><dd>Add experimental check for ID status.</dd><dt>2005-04-01</dt><dd>Add fixes from Bill Fenner.</dd><dt>2005-12-03</dt><dd>Add checks against local copy of <<a href="http://www.w3.org/2002/01/tr-automation/tr.rdf">http://www.w3.org/2002/01/tr-automation/tr.rdf</a>>.</dd><dt>2006-07-22</dt><dd>Add checks for standards levels.</dd><dt>2006-08-06</dt><dd>"check-ietf-references.xslt" replaced by "check-references.xslt".</dd><dt>2007-01-04</dt><dd>Use information online at <<a href="http://tools.ietf.org/">http://tools.ietf.org/</a>> to retrieve Internet-Draft status information.</dd><dt>2007-06-16</dt><dd>Fix bug looking up ref type when inside change markup.</dd><dt>2008-06-14</dt><dd>Enhance output when draft was updated, and then published as RFC.</dd><dt>2008-07-12</dt><dd>Add XSLT2-based link target checking.</dd><dt>2008-08-10</dt><dd>Change keywords for "intended-level" to proposed/draft/internet, optionally extract intended level from /rfc/@x:maturity-level attribute.</dd></dl><h2 id="rfc.section.F.4"><a href="#rfc.section.F.4">F.4</a> gen-reference-graph.xslt</h2><dl><dt>2006-09-03</dt><dd>New.</dd><dt>2007-06-07</dt><dd>Use <a href="http://dpcarlisle.blogspot.com/2007/05/exslt-node-set-function.html">Carlisle method</a> to define exslt:node-set in msxsml (which means that the stylesheet can now be used with MSXML as well).</dd><dt>2007-10-15</dt><dd>Use W3C data from tr.rdf as well (experimental).</dd></dl><h2 id="rfc.section.F.5"><a href="#rfc.section.F.5">F.5</a> rfc2629.xslt</h2><dl><dt>2001-03-28</dt><dd>Code rearranged, generate numbered section anchors for paragraphs (t) as well. Fixes in index handling.</dd><dt>2001-04-12</dt><dd>Moved HTML output into XHTML namespace.</dd><dt>2001-10-02</dt><dd>Fixed default location for RFCs and numbering of section references. Support ?rfc editing processing instruction.</dd><dt>2001-10-07</dt><dd>Made telephone number links active.</dd><dt>2001-10-08</dt><dd>Support for vspace element.</dd><dt>2001-10-09</dt><dd>Experimental support for rfc-issue PI.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-11-11</dt><dd>Support rfc private PI. Removed bogus code reporting the WG in the header.</dd><dt>2001-12-17</dt><dd>Support title attribute on references element</dd><dt>2002-01-05</dt><dd>Support for list/@style="@format"</dd><dt>2002-01-09</dt><dd>Display "closed" RFC issues as deleted</dd><dt>2002-01-14</dt><dd>Experimentally and optionally parse XML encountered in artwork elements (requires MSXSL).</dd><dt>2002-01-27</dt><dd>Some cleanup. Moved RFC issues from PIs into namespaced elements.</dd><dt>2002-01-29</dt><dd>Added support for sortrefs PI. Added support for figure names.</dd><dt>2002-02-07</dt><dd>Highlight parts of artwork which are too wide (72 characters).</dd><dt>2002-02-12</dt><dd>Code rearrangement for static texts. Fixes for section numbering. TOC generation rewritten.</dd><dt>2002-02-15</dt><dd>Support for irefs in sections; support iref @primary=true</dd><dt>2002-03-03</dt><dd>Moved anchor prefix into a constant. Added sanity checks on user anchor names.</dd><dt>2002-03-23</dt><dd>Bugfix in detection of matching org names when creating the header. Fixed sorting in subitems.</dd><dt>2002-04-02</dt><dd>Fix TOC link HTML generation when no TOC is generated (created broken HTML table code).</dd><dt>2002-04-03</dt><dd>Made rendering of references more tolerant re: missing parts.</dd><dt>2002-04-08</dt><dd>Fixed reference numbering when references are split into separate sections.</dd><dt>2002-04-16</dt><dd>Fix default namespace (shouldn't be set for HTML output method).</dd><dt>2002-04-19</dt><dd>Lowercase internal CSS selectors for Mozilla compliance. Do not put TOC into ul element.</dd><dt>2002-04-21</dt><dd>Make numbered list inside numbered lists use alphanumeric numbering.</dd><dt>2002-05-05</dt><dd>Updated issue/editing support.</dd><dt>2002-05-15</dt><dd>Bugfix for section numbering after introduction of ed:replace</dd><dt>2002-06-21</dt><dd>When producing private documents, do not include document status, copyright etc.</dd><dt>2002-07-08</dt><dd>Fix xrefs to Appendices.</dd><dt>2002-07-19</dt><dd>Make artwork lightyellow for easier reading. (fielding)</dd><dt>2002-10-09</dt><dd>Translate references title to anchor name to avoid non-uri characters. (fielding)</dd><dt>2002-10-13</dt><dd>Support for tocdepth PI.</dd><dt>2002-11-03</dt><dd>Added temporariry workaround for Mozilla/Transformiix result tree fragment problem. (search for 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')</dd><dt>2002-12-25</dt><dd>xref code: attempt to uppercase "section" and "appendix" when at the start of a sentence.</dd><dt>2003-02-02</dt><dd>fixed code for vspace blankLines="0", enhanced display for list with "format" style, got rid of HTML blockquote elements, added support for "hangIndent"</dd><dt>2003-04-10</dt><dd>experimental support for appendix and spanx elements</dd><dt>2003-04-19</dt><dd>fixed counting of list numbers in "format %" styles (one counter per unique format string). Added more spanx styles.</dd><dt>2003-05-02</dt><dd>experimental texttable support</dd><dt>2003-05-02</dt><dd>Make mailto links optional (default = none) (jre: default and PI name changed) (fielding)</dd><dt>2003-05-04</dt><dd>experimental support for HTML link elements; fix default for table header alignment default</dd><dt>2003-05-06</dt><dd>support for "background" PI.</dd><dt>2003-05-11</dt><dd>change %c format to lowercase alphabetic. add support for keyword elements (generate META tag). fix various HTML conformance problems. added experimental support for role attribute. do not number paragraphs in unnumbered sections. update boilerplate texts. support for "iprnotified" PI. bugfix list numbering. strip whitespace when building tel: URIs.</dd><dt>2003-05-12</dt><dd>more conformance fixes (layout moved into CSS, move lists and figures out of para content, do not use tables for list formatting)</dd><dt>2003-05-13</dt><dd>add DC.Creator meta tag, refactoring</dd><dt>2003-05-16</dt><dd>put nbsps between "section" and section number (xref).</dd><dt>2003-05-18</dt><dd>author summary: add missing comma.</dd><dt>2003-06-06</dt><dd>fix index generation bug (transposed characters in key generation). Enhance sentence start detection (xref starting a section was using lowercase "section").</dd><dt>2003-06-22</dt><dd>exp. support for xref/@format. Add missing support for eref w/o content. exp. support for annotations in reference elements. Code cleanup reference table formatting.</dd><dt>2003-07-09</dt><dd>Another fix for DC.Creator meta tag creation based on RFC2731</dd><dt>2003-07-24</dt><dd>Fix namespace name for DC.Creator.</dd><dt>2003-08-06</dt><dd>Cleanup node-set support (only use exslt (saxon, xalan, libxslt) extension functions; remove Transformix workarounds that stopped to work in Moz 1.4)</dd><dt>2003-08-09</dt><dd>Generate HTML lang tag.</dd><dt>2003-08-10</dt><dd>Map spanx/verb to HTML "samp" element. Fix author name display in references (reverse surname/initials for last author), add "Ed.". Fix internal bookmark generation.</dd><dt>2003-08-17</dt><dd>Add DCMI dates, identifiers and abstract. Add PI to suppress DCMI generation. Do not add TOC entry to Copyright Statement when there is none. Align RFC2629 PI names and parameter names. Change style for inline URIs generated by eref. Add header and footer support. Enhance CSS paging properties. Support topblock PI. Added hooks for proper XHTML generation through separate XSLT. Enhance warning and error messages. Add support for artwork image display. Table formatting fixes (borders, thead continuation).</dd><dt>2003-08-18</dt><dd>Add workaround for MSXML4 node-set and Mozilla node-set issues (fallback just displays are warning).</dd><dt>2003-10-06</dt><dd>Add workaround for broken pre/ins handling in Mozilla (see <<a href="http://bugzilla.mozilla.org/show_bug.cgi?id=204401">http://bugzilla.mozilla.org/show_bug.cgi?id=204401</a>>). Make use of cite attribute on ed:replace. CSS cleanup.</dd><dt>2003-10-08</dt><dd>Fix minor issue detecting the same org for the header (caused by IE's non-standard whitespace handling). Fix default handling for /rfc/@category.</dd><dt>2003-11-09</dt><dd>Inherit ed:entered-by from ancestor elements. Change CSS color for inserted text to green. Generate issues-list anchor. Do not complain about missing targets when the xref element is below ed:del. Remove code that attempted to distinguish section/Section when producing links - always use uppercase. Fix date rendering for issue resolutions.</dd><dt>2003-11-29</dt><dd>Fix color values for table backgrounds for issue rendering. Change rendering of issue links to use inline-styles. Add colored issue markers to issues.</dd><dt>2003-12-13</dt><dd>Fix inheritance of ed:entered-by attribute. Display note elements inside change tracking as well.</dd><dt>2004-01-18</dt><dd>When PI compact = 'yes', make most CSS print page breaks conditional.</dd><dt>2004-02-20</dt><dd>Support for RFC3667 IPR changes (xml2rfc 1.22); see <<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-February/001088.html</a>>.</dd><dt>2004-03-11</dt><dd>Add "(if approved)" to "updates" and "obsoletes" unless the document has an RFC number.</dd><dt>2004-04-01</dt><dd>Fix RFC3667 output, see <<a href="http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html">http://lists.xml.resource.org/pipermail/xml2rfc/2004-April/001208.html</a>>.</dd><dt>2004-04-04</dt><dd>Add support for section/top attribute. Move references into plain section container.</dd><dt>2004-04-06</dt><dd>Do not emit identical para anchors for deleted content.</dd><dt>2004-04-14</dt><dd>Fix references TOC generation when there are no references.</dd><dt>2004-04-24</dt><dd>Fix RFC3667 output, see <<a href="http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html">http://xml.resource.org/pipermail/xml2rfc/2004-April/001246.html</a>>.</dd><dt>2004-05-09</dt><dd>Add custom support for generating compound index documents. Add anchors for each Index letter. Add experimental cref support. Fix conditional page breaks before References section.</dd><dt>2004-05-16</dt><dd>Refactor external index generation.</dd><dt>2004-05-20</dt><dd>Rewrite anchor generation for comments.</dd><dt>2004-05-22</dt><dd>Enhance issues rendering (add links to changes).</dd><dt>2004-05-30</dt><dd>Allow single quote as delimiter in processing instructions as well. Move block-level issue pointers to floats. Disable issue pointers for print media. Add "purple numbers". Add hrefs to section headings. Add non-printing index key letter list to start of index.</dd><dt>2004-06-01</dt><dd>Use &#xb6; instead of # for PNs.</dd><dt>2004-07-18</dt><dd>Add support for list style=letters (thanks Roy F.). Make PNs optional; add new PI.</dd><dt>2004-09-05</dt><dd>Fix index links into unnumbered sections. Bring IPR boilerplate in-line with xml2rfc 1.25. Add experimental CSS3 paged media support. Various HTML fixes.</dd><dt>2004-09-21</dt><dd>Enhance checking of artwork width.</dd><dt>2004-09-26</dt><dd>Add check for unused references. Uppercase letters in list style letters when nested into another list.</dd><dt>2004-10-10</dt><dd>Fix internal change track pointers.</dd><dt>2004-11-01</dt><dd>Allow change tracking on references (as a whole). Rewrite artwork handling so that it allows change tracking inside artwork. Also allow a subset of text markup inside artwork, such as xrefs (note this requires post-processing the source to make it compliant to RFC2629bis).</dd><dt>2004-11-03</dt><dd>Enhanced placement of iref anchors.</dd><dt>2004-11-06</dt><dd>Index: display irefs that appeared (with primary=true) inside artwork elements in a monospaced font.</dd><dt>2004-11-14</dt><dd>Add special code so that changes in section titles can be change-tracked.</dd><dt>2005-01-14</dt><dd>Bugfixes for HtmlToXhtml converter.</dd><dt>2005-01-22</dt><dd>Enhance generation of HTML h* elements (for Mozilla Outliner).</dd><dt>2005-01-31</dt><dd>Put vertical space around top-level TOC entries in TOC. Switch to pt-based CSS. Re-arrange top section. Make hr elements reflect new-page settings in TXT output (compact-PI). Fix page number in footer (CSS print) and add some more experimental support for paged media (tested with Prince 4.1 alpha). Rewrite TOC and Index generation to generate HTML lists. Cleanup id generation for paragraphs. Reduce whitespace in output. Fix vspace implementation. Use right/left dqoutes and copyright sign where appropriate.</dd><dt>2005-02-04</dt><dd>Add <link> element to references section. Fix newly introduced bug in references processing.</dd><dt>2005-02-05</dt><dd>Integrate various fixes/enhancements by Roy Fielding: spelling of "Authors' Addresses", comma setting in references, position of "Authors" section, optionally place authors addresses at end (PI), trailing dots in section numbers, switch to verdana default font in CSS. Add experimental support for centered artwork.</dd><dt>2005-02-09</dt><dd>Fixes in spacing and links of references section titles. Enhance sorting in references when change tracking is in place. Re-add figure centering support. Add missing 2nd part of "Author's Adresses" fix.</dd><dt>2005-02-25</dt><dd>Align section number format with xml2rfc1.29.</dd><dt>2005-03-28</dt><dd>Get rid of table elements in Author's section. Add experimental hCard (<<a href="http://developers.technorati.com/wiki/hCard">http://developers.technorati.com/wiki/hCard</a>>) support.</dd><dt>2005-04-03</dt><dd>Add RFC3978-style IPR statement support. (fenner@research.att.com)</dd><dt>2005-04-11</dt><dd>Cleanup author display. hCard related fixes.</dd><dt>2005-05-07</dt><dd>Minor fixes to allow change tracking in doc title. Add experimental support for table border styles. CSS cleanup.</dd><dt>2005-06-18</dt><dd>Implement missing support for references to texttables.</dd><dt>2005-09-25</dt><dd>Use (-moz-)column-count when printing the index.</dd><dt>2005-10-04</dt><dd>Report missing element templates with xsl:message.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2005-10-23</dt><dd>More workarounds for Mozilla's broken del/ins handling (this time for figures).</dd><dt>2005-10-27</dt><dd>lowercase hCard class names</dd><dt>2005-11-22</dt><dd>Enhance diagnostics for XML-in-artwork extension</dd><dt>2005-11-26</dt><dd>Fix formatting of section numbers for sections inserted into <back>.</dd><dt>2005-12-12</dt><dd>Fix some validity problems when change tracking occured inside lists.</dd><dt>2005-12-18</dt><dd>Add change tracking inside the index.</dd><dt>2006-02-04</dt><dd>Add prev/next links to highlighted changes (change tracking extension).</dd><dt>2006-02-10</dt><dd>Catch errors instantiating MSXML component.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-02-27</dt><dd>Fix front matter (lowercase Internet-Draft, say "Intended status" for non-RFC documents). Start work on experimental extension for simplified internal links.</dd><dt>2006-03-19</dt><dd>Tweaks to IESG Copyright stuff; support submissionType attribute. Fix duplicate reference anchors in HTML output. Reduce HTML Tidy warnings. Fix reference to normative ASCII version (now requires trailing ".txt"). Tweaks to hCard generation. Started to move non-issue-tracking extensions into namespace "http://purl.org/net/xml2rfc/ext".</dd><dt>2006-03-27</dt><dd>Moved "simple reference" extension into namespace "http://purl.org/net/xml2rfc/ext" and add documentation. HTML conformance enhancements.</dd><dt>2006-04-02</dt><dd>Cleanup special code for automated XHTML XSLT generation.</dd><dt>2006-04-21</dt><dd>Generate <CITE> elements where appropiate. Introduce x:blockquote, x:dfn, x:h and x:q elements.</dd><dt>2006-05-06</dt><dd>Introduce x:bcp14 element.</dd><dt>2006-05-14</dt><dd>Fix content model for x:blockquote.</dd><dt>2006-06-18</dt><dd>Add box drawing support (x:bt, x:bc, x:bb).</dd><dt>2006-06-20</dt><dd>HTML validity fixes (legal chars in anchors in index).</dd><dt>2006-06-24</dt><dd>Reduce leading empty lines in artwork. Move <dt> style info into CSS.</dd><dt>2006-07-14</dt><dd>Fix rendering of multiple street address entries (missing line break).</dd><dt>2006-07-24</dt><dd>Add extension for deep linking into RFCs, do not generate empty list items in TOC output, avoid empty <dt> elements for list items without hangText attribute.</dd><dt>2006-08-01</dt><dd>Allow @anchor on more elements; start work on Relax NG grammar for extensions. Reduce generated style elements (use CSS classes instead). Consistently use "id" instead of "name". Change default target for RFC links to "http://tools.ietf.org/html/rfcNNNN".</dd><dt>2006-08-06</dt><dd>Include appendices defined in <appendix> elements in TOC (please consider them deprecated anyhow!). Generate links to "http://tools.ietf.org/html/draft-*" for Internet Drafts. Replace x:frag by x:rel, allowing any kind of relative reference instead of just fragments.</dd><dt>2006-08-30</dt><dd>Reduce textual differences between HTML output and what xml2rfc produces in TXT output mode (section refs/reference targets). Add small workaround for Opera 9.0.1's problem with node-set().</dd><dt>2006-10-29</dt><dd>Fix problem generating internal links to change markup within references section. Enhancements when generating numbered references for deleted references. Allow inclusion of references into the index (through include-references-in-index extension). Fix a bug that caused the newer version of the IETF boilerplate to be produced rather than the pre-RFC3667 one. Update to RFC4287 boilerplate.</dd><dt>2006-11-11</dt><dd>Add extension attribute x:for-anchor to <iref> handling.</dd><dt>2006-11-26</dt><dd>Experimental (and limited) support for <x:lt>.</dd><dt>2006-12-04</dt><dd>Fix bugs in processing documents that have both the ipr and the number attribute set on the rfc root element. Add support for x:fmt='none' on xrefs. Add different pre style based on artwork type attributes (experimental).</dd><dt>2006-12-13</dt><dd>Add x:fmt='anchor' for xref elements.</dd><dt>2007-01-07</dt><dd>Fix root template for compatibility for the exslt:node-set implementation in Firefox3.</dd><dt>2007-01-29</dt><dd>Avoid empty table entry in front matter when organization is not specified for an author.</dd><dt>2007-02-10</dt><dd>Allow change tracking in table rows.</dd><dt>2007-03-09</dt><dd>Add hcard profile URI (<<a href="http://www.w3.org/2006/03/hcard">http://www.w3.org/2006/03/hcard</a>>) to head element. Add warning for misplaced <t> elements (after section).</dd><dt>2007-03-21</dt><dd>Fix internal linking from reference entries in index for some xref types. Minor CSS tweaks contributed by MTR. Allow turning on text justification through a PI. Improve iref anchor generation to generate less instable anchors.</dd><dt>2007-03-28</dt><dd>Fixes for numbering of ed:inserted references sections.</dd><dt>2007-05-04</dt><dd>Do not generate anchors for edits in deleted sections. Enhance HTML conformance.</dd><dt>2007-05-19</dt><dd>Enhance diagnostics when using Saxon (needs Saxon's "-l" command line parameter to keep line number information). Add warning when symref PI is missing (default will change in the future). Add support for overriding computed section numbers (when formatting historic documents).</dd><dt>2007-06-07</dt><dd>Change default for symrefs PI to "yes" (see change in xml2rfc 1.33pre4). Warn about docName attributes that appear to contain a file extension.</dd><dt>2007-06-26</dt><dd>Workaround author/@initials values without trailing dot, as in xml2rfc.tcl.</dd><dt>2007-07-14</dt><dd>Enhance index generation for references that use @x:sec attribute.</dd><dt>2007-09-09</dt><dd>Fix: sortrefs is a nop when symrefs=no.</dd><dt>2007-10-17</dt><dd>Work in progress: add support for referencing sections in sibling documents by anchor name.</dd><dt>2007-10-17</dt><dd>Work in progress (continued): support for referencing sections in sibling documents by anchor name.</dd><dt>2007-12-31</dt><dd>Emit warning when updating/obsoleting stuff that's not referenced.</dd><dt>2008-02-03</dt><dd>Support xml2rfc-1.33pre5's suppress-title attribute on texttable and figure.</dd><dt>2008-02-06</dt><dd>Extension: allow <eref> below <cref>.</dd><dt>2008-02-17</dt><dd>Extensions: add x:span and x:length-of.</dd><dt>2008-02-20</dt><dd>Add new RFC boilerplate (as changed in 2007-08).</dd><dt>2008-02-27</dt><dd>Improve diagnostics for artwork width problems; add defaulting of publication dates (requires XSLT processor supporting exslt:date, or msxml).</dd><dt>2008-02-29</dt><dd>Enhance CSS for link elements in the front header, update rules for generating "Acknowledgment" statement.</dd><dt>2008-03-01</dt><dd>Use line numbers in diagnostics in Saxon8/9 as well.</dd><dt>2008-03-02</dt><dd>Fix a bug in the logic choosing the boilerplate, resulting in obsolete text being inserted into IDs.</dd><dt>2008-04-01</dt><dd>Add support for superscript element.</dd><dt>2008-06-28</dt><dd>Add sanity checks for email addresses, allow multiple email elements.</dd><dt>2008-07-06</dt><dd>Add x:abnf-char-sequence.</dd><dt>2008-08-21</dt><dd>Add x:note.</dd><dt>2008-09-06</dt><dd>Add experimental support for SVG images.</dd><dt>2008-09-17</dt><dd>Add experimental support for x:author. Fix xref/@format=none.</dd><dt>2008-10-10</dt><dd>Fix a huge bug, causing text content after an XML comment to be ignored.</dd><dt>2009-02-24</dt><dd>Use table/caption when needed.</dd><dt>2009-03-07</dt><dd>Fix bug that caused text to disappear in the output in presence of processing instructions.</dd><dt>2009-03-12</dt><dd>Make inlined comments bookmarkable.</dd><dt>2009-04-09</dt><dd>Upgrade to DC-HTML from RFC 2731 (affects head/@profile).</dd><dt>2009-07-08</dt><dd>Remove table/@summary in output; the value getting inserted was just repeating stuff that appeared in the preamble.</dd><dt>2009-08-01</dt><dd>Implement table alignment (HTML output only for now).</dd><dt>2009-08-18</dt><dd>Replicate Dublin Core "abstract" metadata into meta/@name=description (search engines do use it).</dd><dt>2009-09-02</dt><dd>Fix default/left alignment of table columns, remove silly table summmary attributes.</dd><dt>2009-09-24</dt><dd>Support double-sided layout using CSS page:left/right selectors.</dd><dt>2009-11-27</dt><dd>Generate unordered lists instead of broken definition lists for list style empty.</dd></dl><h2 id="rfc.section.F.6"><a href="#rfc.section.F.6">F.6</a> rfc2629toFO.xslt</h2><dl><dt>2003-11-16</dt><dd>Initial release.</dd><dt>2003-11-29</dt><dd>Enhance handling of unknown list styles.</dd><dt>2004-04-04</dt><dd>Update reference section handling.</dd><dt>2004-04-17</dt><dd>Use XSL-WD-1.1-style fo:bookmark and index handling and add postprocessors for existing implementations. Unify PDF info generation by using XEP (postprocessors) will convert.</dd><dt>2004-04-20</dt><dd>Add experimental cref support.</dd><dt>2004-06-14</dt><dd>Set correct index-item defaults.</dd><dt>2004-07-18</dt><dd>Add list style=letters.</dd><dt>2004-09-03</dt><dd>Make URLs in text break where they are allowed to break by inserting zero-width spaces.</dd><dt>2004-09-26</dt><dd>Fix letter-style inside nested lists.</dd><dt>2004-10-31</dt><dd>Update handling of artwork.</dd><dt>2004-11-13</dt><dd>Fix handling of references inside ed:* markup. Fix whitespace handling in artwork.</dd><dt>2004-11-27</dt><dd>Irefs in artwork generate monospaced entries in index.</dd><dt>2005-01-31</dt><dd>Fix TOC generation that was broken after changes in main XSLT.</dd><dt>2005-02-05</dt><dd>Bring in sync with cosmetic changes in rfc2629.xslt.</dd><dt>2005-05-07</dt><dd>Minor fix for change tracking in document title. Support for table styles.</dd><dt>2005-06-18</dt><dd>Fix references to tables.</dd><dt>2005-10-15</dt><dd>Process t/@anchor.</dd><dt>2006-02-11</dt><dd>References: add "work in progress" for Internet Drafts.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd><dt>2007-03-21</dt><dd>Support optional text justification.</dd><dt>2007-05-19</dt><dd>Various improvements in spacing; also allow overriding the automatic list indentation via list/x:indent.</dd><dt>2009-04-08</dt><dd>Fix spacing in headers; add support for formatting for double-sided printing.</dd><dt>2009-08-01</dt><dd>Remove surplus empty pages when not generating double-sided output.</dd></dl><h2 id="rfc.section.F.7"><a href="#rfc.section.F.7">F.7</a> xsl11toAn.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><h2 id="rfc.section.F.8"><a href="#rfc.section.F.8">F.8</a> xsl11toFop.xslt</h2><dl><dt>2010-08-25</dt><dd>Switch to Apache FOP 1.0.</dd><dt>2009-09-12</dt><dd>Support for FOP 0.20.5 and FOP 0.93 removed. Please use FOP 0.95.</dd><dt>2008-03-15</dt><dd>Add a workaround to the fo:inline workaround (sigh).</dd></dl><h2 id="rfc.section.F.9"><a href="#rfc.section.F.9">F.9</a> xsl11toXep.xslt</h2><dl><dt>2004-05-17</dt><dd>Initial release.</dd><dt>2004-09-04</dt><dd>Fix xep:index-item attributes.</dd><dt>2006-06-02</dt><dd>Use XSL 1.1 WD Feb 2006.</dd></dl><hr class="noprint"><h1 id="rfc.index" class="np"><a href="#rfc.index">Index</a></h1><p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.B">B</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.J">J</a> <a href="#rfc.index.K">K</a> <a href="#rfc.index.L">L</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.Q">Q</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.T">T</a> <a href="#rfc.index.X">X</a> </p><div class="print2col"><ul class="ind"><li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul><li>abnf-char-sequence Extension Element <a href="#rfc.iref.a.27"><b>11.1</b></a>, <a href="#rfc.iref.a.29">A</a></li><li>allow-markup-in-artwork PI pseudo-attribute <a href="#rfc.iref.a.1">3.3</a></li><li>alternate HTML LINK element <a href="#rfc.iref.a.22">6.2</a></li><li>anchor-alias Extension Element <a href="#rfc.iref.a.28"><b>11.2</b></a>, <a href="#rfc.iref.a.30">A</a></li><li>Anchors <ul><li>rfc.abstract <a href="#rfc.iref.a.3">4</a></li><li>rfc.authors <a href="#rfc.iref.a.4">4</a></li><li>rfc.copyright <a href="#rfc.iref.a.5">4</a></li><li>rfc.copyrightnotice <a href="#rfc.iref.a.6">4</a></li><li>rfc.figure.n <a href="#rfc.iref.a.7">4</a>, <a href="#rfc.iref.a.18">4</a></li><li>rfc.figure.u.n <a href="#rfc.iref.a.8">4</a>, <a href="#rfc.iref.a.19">4</a></li><li>rfc.index <a href="#rfc.iref.a.9">4</a></li><li>rfc.ipr <a href="#rfc.iref.a.10">4</a></li><li>rfc.iref.n <a href="#rfc.iref.a.11">4</a></li><li>rfc.note.n <a href="#rfc.iref.a.12">4</a></li><li>rfc.references <a href="#rfc.iref.a.13">4</a>, <a href="#rfc.iref.a.14">4</a></li><li>rfc.section.n <a href="#rfc.iref.a.15">4</a></li><li>rfc.section.n.p.m <a href="#rfc.iref.a.16">4</a></li><li>rfc.status <a href="#rfc.iref.a.17">4</a></li><li>rfc.toc <a href="#rfc.iref.a.20">4</a></li><li>rfc.xref.name.n <a href="#rfc.iref.a.21">4</a></li></ul></li><li>AntennaHouse XSL Formatter <a href="#rfc.iref.a.26">9.1</a></li><li>Apache FOP <a href="#rfc.iref.a.25">9.1</a></li><li>appendix HTML LINK element <a href="#rfc.iref.a.23">6.2</a></li><li>assign-section-number Extension Element <a href="#rfc.iref.a.31">A</a></li><li>author HTML LINK element <a href="#rfc.iref.a.24">6.2</a></li><li>authors-section PI pseudo-attribute <a href="#rfc.iref.a.2">3.3</a></li></ul></li><li><a id="rfc.index.B" href="#rfc.index.B"><b>B</b></a><ul><li>background PI pseudo-attribute <a href="#rfc.iref.b.1">3.1</a></li><li>bb Extension Element <a href="#rfc.iref.b.3"><b>11.4</b></a>, <a href="#rfc.iref.b.8">A</a></li><li>bc Extension Element <a href="#rfc.iref.b.4"><b>11.5</b></a>, <a href="#rfc.iref.b.9">A</a></li><li>bcp14 Extension Element <a href="#rfc.iref.b.2"><b>11.3</b></a>, <a href="#rfc.iref.b.10">A</a></li><li><em>BCP97</em> <a href="#rfc.xref.BCP97.1">12.1</a>, <a href="#BCP97"><b>13</b></a></li><li>blockquote Extension Element <a href="#rfc.iref.b.5"><b>11.6</b></a>, <a href="#rfc.iref.b.11">A</a></li><li>boilerplate Extension Element <a href="#rfc.iref.b.6"><b>11.7</b></a>, <a href="#rfc.iref.b.12">A</a></li><li>bt Extension Element <a href="#rfc.iref.b.7"><b>11.8</b></a>, <a href="#rfc.iref.b.13">A</a></li></ul></li><li><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul><li>chapter HTML LINK element <a href="#rfc.iref.c.3">6.2</a></li><li>CHM format <a href="#rfc.iref.c.7">8</a></li><li>comments PI pseudo-attribute <a href="#rfc.iref.c.2">3.1</a></li><li>compact PI pseudo-attribute <a href="#rfc.iref.c.1">3.1</a></li><li>contents HTML LINK element <a href="#rfc.iref.c.4">6.2</a></li><li>copyright HTML LINK element <a href="#rfc.iref.c.5">6.2</a></li><li>Creator DCMI property <a href="#rfc.iref.c.6">6.4</a></li></ul></li><li><a id="rfc.index.D" href="#rfc.index.D"><b>D</b></a><ul><li>Date.Issued DCMI property <a href="#rfc.iref.d.3">6.4</a></li><li><em>DC-HTML</em> <a href="#rfc.xref.DC-HTML.1">6.4</a>, <a href="#DC-HTML"><b>13</b></a></li><li>DCMI properties <ul><li>Creator <a href="#rfc.iref.d.2">6.4</a></li><li>Date.Issued <a href="#rfc.iref.d.4">6.4</a></li><li>Description.Abstract <a href="#rfc.iref.d.6">6.4</a></li><li>Identifier <a href="#rfc.iref.d.7">6.4</a></li><li>isPartOf <a href="#rfc.iref.d.8">6.4</a></li><li>Relation.Replaces <a href="#rfc.iref.d.9">6.4</a></li></ul></li><li>Description.Abstract DCMI property <a href="#rfc.iref.d.5">6.4</a></li><li>dfn Extension Element <a href="#rfc.iref.d.10"><b>11.9</b></a>, <a href="#rfc.iref.d.11">A</a></li><li>duplex PI pseudo-attribute <a href="#rfc.iref.d.1">3.3</a></li></ul></li><li><a id="rfc.index.E" href="#rfc.index.E"><b>E</b></a><ul><li>editing PI pseudo-attribute <a href="#rfc.iref.e.1">3.1</a></li><li>Extension Elements <ul><li>abnf-char-sequence <a href="#rfc.iref.e.2"><b>11.1</b></a>, <a href="#rfc.iref.e.24">A</a></li><li>anchor-alias <a href="#rfc.iref.e.3"><b>11.2</b></a>, <a href="#rfc.iref.e.25">A</a></li><li>assign-section-number <a href="#rfc.iref.e.28">A</a></li><li>bb <a href="#rfc.iref.e.5"><b>11.4</b></a>, <a href="#rfc.iref.e.29">A</a></li><li>bc <a href="#rfc.iref.e.6"><b>11.5</b></a>, <a href="#rfc.iref.e.30">A</a></li><li>bcp14 <a href="#rfc.iref.e.4"><b>11.3</b></a>, <a href="#rfc.iref.e.31">A</a></li><li>blockquote <a href="#rfc.iref.e.7"><b>11.6</b></a>, <a href="#rfc.iref.e.32">A</a></li><li>boilerplate <a href="#rfc.iref.e.8"><b>11.7</b></a>, <a href="#rfc.iref.e.33">A</a></li><li>bt <a href="#rfc.iref.e.9"><b>11.8</b></a>, <a href="#rfc.iref.e.34">A</a></li><li>dfn <a href="#rfc.iref.e.10"><b>11.9</b></a>, <a href="#rfc.iref.e.35">A</a></li><li>feedback <a href="#rfc.iref.e.11"><b>11.10</b></a>, <a href="#rfc.iref.e.26">A</a></li><li>h <a href="#rfc.iref.e.12"><b>11.11</b></a>, <a href="#rfc.iref.e.36">A</a></li><li>highlight <a href="#rfc.iref.e.13"><b>11.12</b></a>, <a href="#rfc.iref.e.37">A</a></li><li>include-author <a href="#rfc.iref.e.27">A</a></li><li>length-of <a href="#rfc.iref.e.14"><b>11.13</b></a>, <a href="#rfc.iref.e.38">A</a></li><li>link <a href="#rfc.iref.e.15"><b>11.14</b></a>, <a href="#rfc.iref.e.39">A</a></li><li>lt <a href="#rfc.iref.e.16"><b>11.15</b></a>, <a href="#rfc.iref.e.40">A</a></li><li>note <a href="#rfc.iref.e.17"><b>11.16</b></a>, <a href="#rfc.iref.e.41">A</a></li><li>parse-xml <a href="#rfc.iref.e.18"><b>11.17</b></a>, <a href="#rfc.iref.e.42">A</a></li><li>prose <a href="#rfc.iref.e.19"><b>11.18</b></a>, <a href="#rfc.iref.e.43">A</a></li><li>q <a href="#rfc.iref.e.20"><b>11.19</b></a>, <a href="#rfc.iref.e.44">A</a></li><li>rdf:Description <a href="#rfc.iref.e.50">A</a></li><li>ref <a href="#rfc.iref.e.21"><b>11.20</b></a>, <a href="#rfc.iref.e.45">A</a></li><li>source <a href="#rfc.iref.e.22"><b>11.21</b></a>, <a href="#rfc.iref.e.46">A</a></li><li>span <a href="#rfc.iref.e.48">A</a></li><li>sup <a href="#rfc.iref.e.23"><b>11.22</b></a>, <a href="#rfc.iref.e.47">A</a></li><li>x <a href="#rfc.iref.e.49">A</a></li></ul></li></ul></li><li><a id="rfc.index.F" href="#rfc.index.F"><b>F</b></a><ul><li>feedback Extension Element <a href="#rfc.iref.f.4"><b>11.10</b></a>, <a href="#rfc.iref.f.5">A</a></li><li>Firefox <ul><li>1.*/2.* <a href="#rfc.iref.f.3">5.2</a></li><li>3.* <a href="#rfc.iref.f.2">5.2</a></li></ul></li><li>footer PI pseudo-attribute <a href="#rfc.iref.f.1">3.1</a></li></ul></li><li><a id="rfc.index.G" href="#rfc.index.G"><b>G</b></a><ul><li>generator HTML META element <a href="#rfc.iref.g.2">6.3</a></li><li>Google Chrome <a href="#rfc.iref.g.1">5.2</a></li><li>Grammar <a href="#rfc.iref.g.3"><b>A</b></a></li></ul></li><li><a id="rfc.index.H" href="#rfc.index.H"><b>H</b></a><ul><li>h Extension Element <a href="#rfc.iref.h.12"><b>11.11</b></a>, <a href="#rfc.iref.h.14">A</a></li><li>header PI pseudo-attribute <a href="#rfc.iref.h.1">3.1</a></li><li>highlight Extension Element <a href="#rfc.iref.h.13"><b>11.12</b></a>, <a href="#rfc.iref.h.15">A</a></li><li><em>HTML</em> <a href="#rfc.xref.HTML.1">6.1</a>, <a href="#rfc.xref.HTML.2">11.6</a>, <a href="#rfc.xref.HTML.3">11.9</a>, <a href="#rfc.xref.HTML.4">11.19</a>, <a href="#rfc.xref.HTML.5">11.22</a>, <a href="#HTML"><b>13</b></a></li><li>HTML compliance <a href="#rfc.iref.h.2">6.1</a></li><li>HTML LINK elements <ul><li>alternate <a href="#rfc.iref.h.3">6.2</a></li><li>appendix <a href="#rfc.iref.h.4">6.2</a></li><li>author <a href="#rfc.iref.h.5">6.2</a></li><li>chapter <a href="#rfc.iref.h.6">6.2</a></li><li>contents <a href="#rfc.iref.h.7">6.2</a></li><li>copyright <a href="#rfc.iref.h.8">6.2</a></li><li>index <a href="#rfc.iref.h.9">6.2</a></li></ul></li><li>HTML META elements <ul><li>generator <a href="#rfc.iref.h.10">6.3</a></li><li>keywords <a href="#rfc.iref.h.11">6.3</a></li></ul></li></ul></li><li><a id="rfc.index.I" href="#rfc.index.I"><b>I</b></a><ul><li>Identifier DCMI property <a href="#rfc.iref.i.12">6.4</a></li><li>include PI pseudo-attribute <a href="#rfc.iref.i.3">3.2</a></li><li>include-author Extension Element <a href="#rfc.iref.i.14">A</a></li><li>include-index PI pseudo-attribute <a href="#rfc.iref.i.4">3.3</a></li><li>include-references-in-index PI pseudo-attribute <a href="#rfc.iref.i.5">3.3</a></li><li>index HTML LINK element <a href="#rfc.iref.i.11">6.2</a></li><li>inline PI pseudo-attribute <a href="#rfc.iref.i.1">3.1</a></li><li>Internet Explorer 5.5 <a href="#rfc.iref.i.6">5.2</a></li><li>Internet Explorer 6 <a href="#rfc.iref.i.7">5.2</a></li><li>Internet Explorer 7 <a href="#rfc.iref.i.8">5.2</a></li><li>Internet Explorer 8 <a href="#rfc.iref.i.9">5.2</a></li><li>Internet Explorer 9 <a href="#rfc.iref.i.10">5.2</a></li><li>iprnotified PI pseudo-attribute <a href="#rfc.iref.i.2">3.1</a></li><li>isPartOf DCMI property <a href="#rfc.iref.i.13">6.4</a></li></ul></li><li><a id="rfc.index.J" href="#rfc.index.J"><b>J</b></a><ul><li>justification PI pseudo-attribute <a href="#rfc.iref.j.1">3.3</a></li></ul></li><li><a id="rfc.index.K" href="#rfc.index.K"><b>K</b></a><ul><li>keywords HTML META element <a href="#rfc.iref.k.1">6.3</a></li></ul></li><li><a id="rfc.index.L" href="#rfc.index.L"><b>L</b></a><ul><li>length-of Extension Element <a href="#rfc.iref.l.2"><b>11.13</b></a>, <a href="#rfc.iref.l.5">A</a></li><li>link Extension Element <a href="#rfc.iref.l.3"><b>11.14</b></a>, <a href="#rfc.iref.l.6">A</a></li><li>linkmailto PI pseudo-attribute <a href="#rfc.iref.l.1">3.1</a></li><li>lt Extension Element <a href="#rfc.iref.l.4"><b>11.15</b></a>, <a href="#rfc.iref.l.7">A</a></li></ul></li><li><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul><li>Microsoft Help <a href="#rfc.iref.m.5">8</a></li><li>Mozilla <a href="#rfc.iref.m.3">5.2</a>, <a href="#rfc.iref.m.4">5.2</a></li><li>MSXML3 <a href="#rfc.iref.m.1">5.1</a></li><li>MSXML4 <a href="#rfc.iref.m.2">5.1</a></li></ul></li><li><a id="rfc.index.N" href="#rfc.index.N"><b>N</b></a><ul><li>needLines PI pseudo-attribute <a href="#rfc.iref.n.1">3.2</a></li><li>NoScript <a href="#rfc.iref.n.2">5.2</a></li><li>note Extension Element <a href="#rfc.iref.n.3"><b>11.16</b></a>, <a href="#rfc.iref.n.4">A</a></li></ul></li><li><a id="rfc.index.O" href="#rfc.index.O"><b>O</b></a><ul><li>Opera <a href="#rfc.iref.o.1">5.2</a>, <a href="#rfc.iref.o.2">5.2</a></li></ul></li><li><a id="rfc.index.P" href="#rfc.index.P"><b>P</b></a><ul><li>Parameters <ul><li>xml2rfc-background <a href="#rfc.iref.p.2">3.1</a></li><li>xml2rfc-comments <a href="#rfc.iref.p.6">3.1</a></li><li>xml2rfc-compact <a href="#rfc.iref.p.4">3.1</a></li><li>xml2rfc-editing <a href="#rfc.iref.p.8">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork <a href="#rfc.iref.p.44">3.3</a></li><li>xml2rfc-ext-authors-section <a href="#rfc.iref.p.46">3.3</a></li><li>xml2rfc-ext-duplex <a href="#rfc.iref.p.48">3.3</a></li><li>xml2rfc-ext-include-index <a href="#rfc.iref.p.50">3.3</a></li><li>xml2rfc-ext-include-references-in-index <a href="#rfc.iref.p.52">3.3</a></li><li>xml2rfc-ext-justification <a href="#rfc.iref.p.54">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork <a href="#rfc.iref.p.57">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots <a href="#rfc.iref.p.61">3.3</a></li><li>xml2rfc-ext-support-rfc2731 <a href="#rfc.iref.p.59">3.3</a></li><li>xml2rfc-footer <a href="#rfc.iref.p.10">3.1</a></li><li>xml2rfc-header <a href="#rfc.iref.p.12">3.1</a></li><li>xml2rfc-inline <a href="#rfc.iref.p.14">3.1</a></li><li>xml2rfc-iprnotified <a href="#rfc.iref.p.16">3.1</a></li><li>xml2rfc-linkmailto <a href="#rfc.iref.p.18">3.1</a></li><li>xml2rfc-private <a href="#rfc.iref.p.21">3.1</a></li><li>xml2rfc-refparent <a href="#rfc.iref.p.23">3.1</a></li><li>xml2rfc-rfcedstyle <a href="#rfc.iref.p.25">3.1</a></li><li>xml2rfc-sortrefs <a href="#rfc.iref.p.27">3.1</a></li><li>xml2rfc-symrefs <a href="#rfc.iref.p.29">3.1</a></li><li>xml2rfc-toc <a href="#rfc.iref.p.31">3.1</a></li><li>xml2rfc-tocdepth <a href="#rfc.iref.p.33">3.1</a></li><li>xml2rfc-topblock <a href="#rfc.iref.p.35">3.1</a></li></ul></li><li>parse-xml Extension Element <a href="#rfc.iref.p.62"><b>11.17</b></a>, <a href="#rfc.iref.p.64">A</a></li><li>parse-xml-in-artwork PI pseudo-attribute <a href="#rfc.iref.p.55">3.3</a></li><li>private PI pseudo-attribute <a href="#rfc.iref.p.19">3.1</a>, <a href="#rfc.iref.p.66">D</a></li><li>Processing Instruction pseudo attributes <ul><li>allow-markup-in-artwork <a href="#rfc.iref.p.43">3.3</a></li><li>authors-section <a href="#rfc.iref.p.45">3.3</a></li><li>background <a href="#rfc.iref.p.1">3.1</a></li><li>comments <a href="#rfc.iref.p.5">3.1</a></li><li>compact <a href="#rfc.iref.p.3">3.1</a></li><li>duplex <a href="#rfc.iref.p.47">3.3</a></li><li>editing <a href="#rfc.iref.p.7">3.1</a></li><li>footer <a href="#rfc.iref.p.9">3.1</a></li><li>header <a href="#rfc.iref.p.11">3.1</a></li><li>ijustification <a href="#rfc.iref.p.53">3.3</a></li><li>include <a href="#rfc.iref.p.36">3.2</a></li><li>include-index <a href="#rfc.iref.p.49">3.3</a></li><li>include-references-in-index <a href="#rfc.iref.p.51">3.3</a></li><li>inline <a href="#rfc.iref.p.13">3.1</a></li><li>iprnotified <a href="#rfc.iref.p.15">3.1</a></li><li>linkmailto <a href="#rfc.iref.p.17">3.1</a></li><li>needLines <a href="#rfc.iref.p.37">3.2</a></li><li>parse-xml-in-artwork <a href="#rfc.iref.p.56">3.3</a></li><li>private <a href="#rfc.iref.p.20">3.1</a>, <a href="#rfc.iref.p.67">D</a></li><li>refparent <a href="#rfc.iref.p.22">3.1</a></li><li>rfcedstyle <a href="#rfc.iref.p.24">3.1</a></li><li>sec-no-trailing-dots <a href="#rfc.iref.p.60">3.3</a></li><li>slides <a href="#rfc.iref.p.38">3.2</a></li><li>sortrefs <a href="#rfc.iref.p.26">3.1</a></li><li>strict <a href="#rfc.iref.p.39">3.2</a></li><li>subcompact <a href="#rfc.iref.p.40">3.2</a></li><li>support-rfc2731 <a href="#rfc.iref.p.58">3.3</a></li><li>symrefs <a href="#rfc.iref.p.28">3.1</a></li><li>toc <a href="#rfc.iref.p.30">3.1</a></li><li>tocdepth <a href="#rfc.iref.p.32">3.1</a></li><li>tocindent <a href="#rfc.iref.p.41">3.2</a></li><li>tocompact <a href="#rfc.iref.p.42">3.2</a></li><li>topblock <a href="#rfc.iref.p.34">3.1</a></li></ul></li><li>prose Extension Element <a href="#rfc.iref.p.63"><b>11.18</b></a>, <a href="#rfc.iref.p.65">A</a></li></ul></li><li><a id="rfc.index.Q" href="#rfc.index.Q"><b>Q</b></a><ul><li>q Extension Element <a href="#rfc.iref.q.1"><b>11.19</b></a>, <a href="#rfc.iref.q.2">A</a></li></ul></li><li><a id="rfc.index.R" href="#rfc.index.R"><b>R</b></a><ul><li>rdf:Description Extension Element <a href="#rfc.iref.r.26">A</a></li><li>ref Extension Element <a href="#rfc.iref.r.23"><b>11.20</b></a>, <a href="#rfc.iref.r.25">A</a></li><li>refparent PI pseudo-attribute <a href="#rfc.iref.r.1">3.1</a></li><li>Relation.Replaces DCMI property <a href="#rfc.iref.r.22">6.4</a></li><li>RELAX NG Compact Schema <a href="#rfc.iref.r.24"><b>A</b></a></li><li>rfc.abstract anchor <a href="#rfc.iref.r.3">4</a></li><li>rfc.authors anchor <a href="#rfc.iref.r.4">4</a></li><li>rfc.copyright anchor <a href="#rfc.iref.r.5">4</a></li><li>rfc.copyrightnotice anchor <a href="#rfc.iref.r.6">4</a></li><li>rfc.figure.n anchor <a href="#rfc.iref.r.7">4</a>, <a href="#rfc.iref.r.18">4</a></li><li>rfc.figure.u.n anchor <a href="#rfc.iref.r.8">4</a>, <a href="#rfc.iref.r.19">4</a></li><li>rfc.index anchor <a href="#rfc.iref.r.9">4</a></li><li>rfc.ipr anchor <a href="#rfc.iref.r.10">4</a></li><li>rfc.iref.n anchor <a href="#rfc.iref.r.11">4</a></li><li>rfc.note.n anchor <a href="#rfc.iref.r.12">4</a></li><li>rfc.references anchor <a href="#rfc.iref.r.13">4</a></li><li>rfc.references.n anchor <a href="#rfc.iref.r.14">4</a></li><li>rfc.section.n anchor <a href="#rfc.iref.r.15">4</a></li><li>rfc.section.n.p.m anchor <a href="#rfc.iref.r.16">4</a></li><li>rfc.status anchor <a href="#rfc.iref.r.17">4</a></li><li>rfc.toc anchor <a href="#rfc.iref.r.20">4</a></li><li>rfc.xref.name.n anchor <a href="#rfc.iref.r.21">4</a></li><li><em>RFC2026</em> <a href="#rfc.xref.RFC2026.1">11.26</a>, <a href="#RFC2026"><b>13</b></a>, <a href="#rfc.xref.RFC2026.2">D.2</a><ul><li><em>Section 4</em> <a href="#rfc.xref.RFC2026.2">D.2</a></li><li><em>Section 4.1</em> <a href="#rfc.xref.RFC2026.1">11.26</a></li></ul></li><li><em>RFC2119</em> <a href="#rfc.xref.RFC2119.1">11.3</a>, <a href="#rfc.xref.RFC2119.2">11.28</a>, <a href="#RFC2119"><b>13</b></a><ul><li><em>Section 5</em> <a href="#rfc.xref.RFC2119.2">11.28</a></li></ul></li><li><em>RFC2616</em> <a href="#RFC2616"><b>13</b></a>, <a href="#rfc.xref.RFC2616.1">B.1</a>, <a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a><ul><li><em>Section 2.1</em> <a href="#rfc.xref.RFC2616.1">B.1</a></li><li><em>Section 19.1</em> <a href="#rfc.xref.RFC2616.2">B.1</a>, <a href="#rfc.xref.RFC2616.3">B.1</a></li></ul></li><li><em>RFC2629</em> <a href="#rfc.xref.RFC2629.1">1</a>, <a href="#RFC2629"><b>13</b></a></li><li><em>RFC2648</em> <a href="#rfc.xref.RFC2648.1">6.4</a>, <a href="#RFC2648"><b>13</b></a></li><li><em>RFC2731</em> <a href="#rfc.xref.RFC2731.1">6.4</a>, <a href="#RFC2731"><b>13</b></a></li><li><em>RFC5234</em> <a href="#RFC5234"><b>13</b></a>, <a href="#rfc.xref.RFC5234.1">B.1</a></li><li><em>RFC5741</em> <a href="#RFC5741"><b>13</b></a>, <a href="#rfc.xref.RFC5741.1">D.3</a>, <a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a><ul><li><em>Section 3.2.2</em> <a href="#rfc.xref.RFC5741.2">D.3</a>, <a href="#rfc.xref.RFC5741.3">D.4</a></li></ul></li><li>rfcedstyle PI pseudo-attribute <a href="#rfc.iref.r.2">3.1</a></li><li><em>RNC</em> <a href="#RNC"><b>13</b></a>, <a href="#rfc.xref.RNC.1">A</a>, <a href="#rfc.xref.RNC.2">B.1</a></li></ul></li><li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul><li>Safari <a href="#rfc.iref.s.9">5.2</a>, <a href="#rfc.iref.s.11">5.2</a><ul><li>3.* <a href="#rfc.iref.s.10">5.2</a></li></ul></li><li>Saxon <a href="#rfc.iref.s.8">5.1</a></li><li>Schema <a href="#rfc.iref.s.14"><b>A</b></a></li><li>sec-no-trailing-dots PI pseudo-attribute <a href="#rfc.iref.s.7">3.3</a></li><li>slides PI pseudo-attribute <a href="#rfc.iref.s.3">3.2</a></li><li>sortrefs PI pseudo-attribute <a href="#rfc.iref.s.1">3.1</a></li><li>source Extension Element <a href="#rfc.iref.s.12"><b>11.21</b></a>, <a href="#rfc.iref.s.15">A</a></li><li>span Extension Element <a href="#rfc.iref.s.17">A</a></li><li>strict PI pseudo-attribute <a href="#rfc.iref.s.4">3.2</a></li><li>subcompact PI pseudo-attribute <a href="#rfc.iref.s.5">3.2</a></li><li>sup Extension Element <a href="#rfc.iref.s.13"><b>11.22</b></a>, <a href="#rfc.iref.s.16">A</a></li><li>support-rfc2731 PI pseudo-attribute <a href="#rfc.iref.s.6">3.3</a></li><li>symrefs PI pseudo-attribute <a href="#rfc.iref.s.2">3.1</a></li></ul></li><li><a id="rfc.index.T" href="#rfc.index.T"><b>T</b></a><ul><li>toc PI pseudo-attribute <a href="#rfc.iref.t.1">3.1</a></li><li>tocdepth PI pseudo-attribute <a href="#rfc.iref.t.2">3.1</a></li><li>tocindent PI pseudo-attribute <a href="#rfc.iref.t.4">3.2</a></li><li>tocompact PI pseudo-attribute <a href="#rfc.iref.t.5">3.2</a></li><li>topblock PI pseudo-attribute <a href="#rfc.iref.t.3">3.1</a></li></ul></li><li><a id="rfc.index.X" href="#rfc.index.X"><b>X</b></a><ul><li>x Extension Element <a href="#rfc.iref.x.31">A</a></li><li>Xalan <a href="#rfc.iref.x.28">5.1</a></li><li><em>XHTML2</em> <a href="#rfc.xref.XHTML2.1">11.11</a>, <a href="#XHTML2"><b>13</b></a></li><li><em>XML</em> <a href="#XML"><b>13</b></a>, <a href="#rfc.xref.XML.1">C.1</a><ul><li><em>Section 2.8</em> <a href="#rfc.xref.XML.1">C.1</a></li></ul></li><li>xml-stylesheet PI <a href="#rfc.iref.x.30">6</a></li><li>xml2rfc-background parameter <a href="#rfc.iref.x.2">3.1</a></li><li>xml2rfc-comments parameter <a href="#rfc.iref.x.4">3.1</a></li><li>xml2rfc-editing parameter <a href="#rfc.iref.x.3">3.1</a>, <a href="#rfc.iref.x.5">3.1</a></li><li>xml2rfc-ext-allow-markup-in-artwork parameter <a href="#rfc.iref.x.19">3.3</a></li><li>xml2rfc-ext-authors-section parameter <a href="#rfc.iref.x.20">3.3</a></li><li>xml2rfc-ext-duplex <a href="#rfc.iref.x.21">3.3</a></li><li>xml2rfc-ext-include-index parameter <a href="#rfc.iref.x.22">3.3</a></li><li>xml2rfc-ext-include-references-in-index parameter <a href="#rfc.iref.x.23">3.3</a></li><li>xml2rfc-ext-justification parameter <a href="#rfc.iref.x.24">3.3</a></li><li>xml2rfc-ext-parse-xml-in-artwork parameter <a href="#rfc.iref.x.25">3.3</a></li><li>xml2rfc-ext-sec-no-trailing-dots parameter <a href="#rfc.iref.x.27">3.3</a></li><li>xml2rfc-ext-support-rfc2731 parameter <a href="#rfc.iref.x.26">3.3</a></li><li>xml2rfc-footer parameter <a href="#rfc.iref.x.6">3.1</a></li><li>xml2rfc-header parameter <a href="#rfc.iref.x.7">3.1</a></li><li>xml2rfc-inline parameter <a href="#rfc.iref.x.8">3.1</a></li><li>xml2rfc-iprnotified parameter <a href="#rfc.iref.x.9">3.1</a></li><li>xml2rfc-linkmailto parameter <a href="#rfc.iref.x.10">3.1</a></li><li>xml2rfc-private parameter <a href="#rfc.iref.x.11">3.1</a></li><li>xml2rfc-refparent parameter <a href="#rfc.iref.x.12">3.1</a></li><li>xml2rfc-rfcedstyle parameter <a href="#rfc.iref.x.13">3.1</a></li><li>xml2rfc-sortrefs parameter <a href="#rfc.iref.x.14">3.1</a></li><li>xml2rfc-symrefs parameter <a href="#rfc.iref.x.15">3.1</a></li><li>xml2rfc-toc parameter <a href="#rfc.iref.x.16">3.1</a></li><li>xml2rfc-tocdepth parameter <a href="#rfc.iref.x.17">3.1</a></li><li>xml2rfc-topblock parameter <a href="#rfc.iref.x.18">3.1</a></li><li><em>XSL-FO</em> <a href="#rfc.xref.XSL-FO.1">9.1</a>, <a href="#rfc.xref.XSL-FO.2">9.1</a>, <a href="#XSL-FO"><b>13</b></a></li><li>xsltproc <a href="#rfc.iref.x.29">5.1</a><ul><li>passing parameters <a href="#rfc.iref.x.1">3</a></li></ul></li></ul></li></ul></div></body></html> |
|---|
![(please configure the [header_logo] section in trac.ini)](https://www.ietf.org/images/ietflogotrans.gif)
