1 | |
---|
2 | |
---|
3 | |
---|
4 | RFC2629 through XSLT J. Reschke |
---|
5 | greenbytes |
---|
6 | March 27, 2011 |
---|
7 | |
---|
8 | |
---|
9 | Transforming RFC2629-formatted XML through XSLT |
---|
10 | |
---|
11 | |
---|
12 | |
---|
13 | Table of Contents |
---|
14 | |
---|
15 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 |
---|
16 | 2. Supported RFC2629 elements . . . . . . . . . . . . . . . . . . 5 |
---|
17 | 2.1. Extension elements . . . . . . . . . . . . . . . . . . . 5 |
---|
18 | 3. Processing Instructions . . . . . . . . . . . . . . . . . . . 6 |
---|
19 | 3.1. Supported xml2rfc-compatible PIs . . . . . . . . . . . . 7 |
---|
20 | 3.2. Unsupported xml2rfc-compatible PIs . . . . . . . . . . . 8 |
---|
21 | 3.3. Extension PIs . . . . . . . . . . . . . . . . . . . . . . 9 |
---|
22 | 4. Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 |
---|
23 | 5. Supported XSLT engines . . . . . . . . . . . . . . . . . . . . 15 |
---|
24 | 5.1. Standalone Engines . . . . . . . . . . . . . . . . . . . 15 |
---|
25 | 5.2. In-Browser Engines . . . . . . . . . . . . . . . . . . . 15 |
---|
26 | 6. Transforming to HTML . . . . . . . . . . . . . . . . . . . . . 17 |
---|
27 | 6.1. HTML compliance . . . . . . . . . . . . . . . . . . . . . 17 |
---|
28 | 6.2. Standard HTML LINK elements . . . . . . . . . . . . . . . 17 |
---|
29 | 6.3. Standard HTML metadata . . . . . . . . . . . . . . . . . 18 |
---|
30 | 6.4. Dublin Core (RFC2731) metadata . . . . . . . . . . . . . 18 |
---|
31 | 6.5. Experimental hCard support . . . . . . . . . . . . . . . 18 |
---|
32 | 7. Transforming to XHTML . . . . . . . . . . . . . . . . . . . . 19 |
---|
33 | 8. Transforming to CHM (Microsoft Compiled Help) . . . . . . . . 20 |
---|
34 | 9. Transforming to PDF . . . . . . . . . . . . . . . . . . . . . 21 |
---|
35 | 9.1. Via XSL-FO . . . . . . . . . . . . . . . . . . . . . . . 21 |
---|
36 | 9.1.1. Extension feature matrix . . . . . . . . . . . . . . . 21 |
---|
37 | 9.1.2. Example: producing output for Apache FOP . . . . . . . 22 |
---|
38 | 9.2. Via X(HTML) . . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
39 | 10. Transforming to ePub . . . . . . . . . . . . . . . . . . . . . 23 |
---|
40 | 11. Generic Extensions . . . . . . . . . . . . . . . . . . . . . . 24 |
---|
41 | 11.1. <abnf-char-sequence> element . . . . . . . . . . . . . . 24 |
---|
42 | 11.2. <anchor-alias> element . . . . . . . . . . . . . . . . . 24 |
---|
43 | 11.3. <bcp14> element . . . . . . . . . . . . . . . . . . . . . 24 |
---|
44 | 11.4. <bb> element . . . . . . . . . . . . . . . . . . . . . . 25 |
---|
45 | 11.5. <bc> element . . . . . . . . . . . . . . . . . . . . . . 25 |
---|
46 | 11.6. <blockquote> element . . . . . . . . . . . . . . . . . . 25 |
---|
47 | 11.7. <boilerplate> element . . . . . . . . . . . . . . . . . . 25 |
---|
48 | 11.8. <bt> element . . . . . . . . . . . . . . . . . . . . . . 26 |
---|
49 | 11.9. <dfn> element . . . . . . . . . . . . . . . . . . . . . . 26 |
---|
50 | 11.10. <h> element . . . . . . . . . . . . . . . . . . . . . . . 26 |
---|
51 | 11.11. <highlight> element . . . . . . . . . . . . . . . . . . . 26 |
---|
52 | |
---|
53 | |
---|
54 | |
---|
55 | Reschke [Page 1] |
---|
56 | |
---|
57 | Documentation RFC2629 through XSLT March 2011 |
---|
58 | |
---|
59 | |
---|
60 | 11.12. <length-of> element . . . . . . . . . . . . . . . . . . . 26 |
---|
61 | 11.13. <link> element . . . . . . . . . . . . . . . . . . . . . 26 |
---|
62 | 11.14. <lt> element . . . . . . . . . . . . . . . . . . . . . . 27 |
---|
63 | 11.15. <note> element . . . . . . . . . . . . . . . . . . . . . 27 |
---|
64 | 11.16. <parse-xml> element . . . . . . . . . . . . . . . . . . . 27 |
---|
65 | 11.17. <prose> element . . . . . . . . . . . . . . . . . . . . . 27 |
---|
66 | 11.18. <q> element . . . . . . . . . . . . . . . . . . . . . . . 27 |
---|
67 | 11.19. <ref> element . . . . . . . . . . . . . . . . . . . . . . 27 |
---|
68 | 11.20. <source> element . . . . . . . . . . . . . . . . . . . . 28 |
---|
69 | 11.21. <sup> element . . . . . . . . . . . . . . . . . . . . . . 28 |
---|
70 | 11.22. Extensions to Xml2rfc <artwork> element . . . . . . . . . 28 |
---|
71 | 11.23. Extensions to Xml2rfc <iref> element . . . . . . . . . . 29 |
---|
72 | 11.24. Extensions to Xml2rfc <list> element . . . . . . . . . . 29 |
---|
73 | 11.25. Extensions to Xml2rfc <rfc> element . . . . . . . . . . . 29 |
---|
74 | 11.26. Extensions to Xml2rfc <section> element . . . . . . . . . 29 |
---|
75 | 11.27. Extensions to Xml2rfc <xref> element . . . . . . . . . . 30 |
---|
76 | 12. Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . 31 |
---|
77 | 12.1. Checking References . . . . . . . . . . . . . . . . . . . 31 |
---|
78 | 12.2. Generating Graphs from References . . . . . . . . . . . . 33 |
---|
79 | 12.3. Producing reference entries for books . . . . . . . . . . 33 |
---|
80 | 12.4. Down-converting to RFC2629bis DTD . . . . . . . . . . . . 34 |
---|
81 | 12.5. Extracting artwork . . . . . . . . . . . . . . . . . . . 35 |
---|
82 | 12.6. GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 35 |
---|
83 | 13. Informative References . . . . . . . . . . . . . . . . . . . . 36 |
---|
84 | Appendix A. RELAX NG Compact Schema . . . . . . . . . . . . . . . 38 |
---|
85 | Appendix B. Implementation Notes . . . . . . . . . . . . . . . . 48 |
---|
86 | B.1. Recognized type attributes for <artwork> element . . . . 48 |
---|
87 | Appendix C. Examples . . . . . . . . . . . . . . . . . . . . . . 49 |
---|
88 | C.1. Using the 'Internal Subset' . . . . . . . . . . . . . . . 49 |
---|
89 | C.2. Customization . . . . . . . . . . . . . . . . . . . . . . 49 |
---|
90 | Appendix D. Producing the IETF 'Boilerplate' . . . . . . . . . . 51 |
---|
91 | D.1. The /rfc/@ipr Attribute . . . . . . . . . . . . . . . . . 51 |
---|
92 | D.1.1. Current Values: '*trust200902' . . . . . . . . . . . . 52 |
---|
93 | D.1.2. Historic Values . . . . . . . . . . . . . . . . . . . 53 |
---|
94 | D.2. The /rfc/@category Attribute . . . . . . . . . . . . . . 54 |
---|
95 | D.3. The /rfc/@submissionType Attribute . . . . . . . . . . . 54 |
---|
96 | D.4. The /rfc/@consensus Attribute . . . . . . . . . . . . . . 55 |
---|
97 | D.5. The /rfc/@number Attribute . . . . . . . . . . . . . . . 56 |
---|
98 | D.6. The /rfc/@docName Attribute . . . . . . . . . . . . . . . 56 |
---|
99 | D.7. The /rfc/@obsoletes Attribute . . . . . . . . . . . . . . 56 |
---|
100 | D.8. The /rfc/@updates Attribute . . . . . . . . . . . . . . . 56 |
---|
101 | Appendix E. License . . . . . . . . . . . . . . . . . . . . . . . 57 |
---|
102 | Appendix F. Change Logs . . . . . . . . . . . . . . . . . . . . . 58 |
---|
103 | F.1. Package . . . . . . . . . . . . . . . . . . . . . . . . . 58 |
---|
104 | F.2. amazon-asin.xslt . . . . . . . . . . . . . . . . . . . . 59 |
---|
105 | F.3. check-references.xslt . . . . . . . . . . . . . . . . . . 59 |
---|
106 | F.4. gen-reference-graph.xslt . . . . . . . . . . . . . . . . 60 |
---|
107 | F.5. rfc2629.xslt . . . . . . . . . . . . . . . . . . . . . . 60 |
---|
108 | |
---|
109 | |
---|
110 | |
---|
111 | Reschke [Page 2] |
---|
112 | |
---|
113 | Documentation RFC2629 through XSLT March 2011 |
---|
114 | |
---|
115 | |
---|
116 | F.6. rfc2629toFO.xslt . . . . . . . . . . . . . . . . . . . . 71 |
---|
117 | F.7. xsl11toAn.xslt . . . . . . . . . . . . . . . . . . . . . 73 |
---|
118 | F.8. xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 73 |
---|
119 | F.9. xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 73 |
---|
120 | Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 |
---|
121 | Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 82 |
---|
122 | |
---|
123 | |
---|
124 | |
---|
125 | |
---|
126 | |
---|
127 | |
---|
128 | |
---|
129 | |
---|
130 | |
---|
131 | |
---|
132 | |
---|
133 | |
---|
134 | |
---|
135 | |
---|
136 | |
---|
137 | |
---|
138 | |
---|
139 | |
---|
140 | |
---|
141 | |
---|
142 | |
---|
143 | |
---|
144 | |
---|
145 | |
---|
146 | |
---|
147 | |
---|
148 | |
---|
149 | |
---|
150 | |
---|
151 | |
---|
152 | |
---|
153 | |
---|
154 | |
---|
155 | |
---|
156 | |
---|
157 | |
---|
158 | |
---|
159 | |
---|
160 | |
---|
161 | |
---|
162 | |
---|
163 | |
---|
164 | |
---|
165 | |
---|
166 | |
---|
167 | Reschke [Page 3] |
---|
168 | |
---|
169 | Documentation RFC2629 through XSLT March 2011 |
---|
170 | |
---|
171 | |
---|
172 | 1. Introduction |
---|
173 | |
---|
174 | This document describes a set of XSLT transformations that can be |
---|
175 | used to transform RFC2629-compliant XML (see [RFC2629]) to various |
---|
176 | output formats, such as HTML and PDF. The main topics are |
---|
177 | |
---|
178 | o compliance to the xml2rfc XML element set (Section 2), |
---|
179 | |
---|
180 | o support for xml2rfc processing instructions (Section 3), |
---|
181 | |
---|
182 | o the names of anchor elements generated in HTML and PDF output |
---|
183 | (Section 4), |
---|
184 | |
---|
185 | o various XSLT engines that can be used (Section 5), |
---|
186 | |
---|
187 | o outputting HTML (Section 6) and XHTML (Section 7), |
---|
188 | |
---|
189 | o outputting CHM (Compiled Microsoft Help, Section 8), |
---|
190 | |
---|
191 | o outputting PDF (Section 9), |
---|
192 | |
---|
193 | o extensions to the xml2rfc vocabulary (Section 11). |
---|
194 | |
---|
195 | o various utilities (Section 12). |
---|
196 | |
---|
197 | The full distribution is available at |
---|
198 | <http://greenbytes.de/tech/webdav/rfc2629xslt.zip>. |
---|
199 | |
---|
200 | |
---|
201 | |
---|
202 | |
---|
203 | |
---|
204 | |
---|
205 | |
---|
206 | |
---|
207 | |
---|
208 | |
---|
209 | |
---|
210 | |
---|
211 | |
---|
212 | |
---|
213 | |
---|
214 | |
---|
215 | |
---|
216 | |
---|
217 | |
---|
218 | |
---|
219 | |
---|
220 | |
---|
221 | |
---|
222 | |
---|
223 | Reschke [Page 4] |
---|
224 | |
---|
225 | Documentation RFC2629 through XSLT March 2011 |
---|
226 | |
---|
227 | |
---|
228 | 2. Supported RFC2629 elements |
---|
229 | |
---|
230 | "rfc2629.xslt" supports both all RFC2629 grammar elements and the |
---|
231 | extensions implemented in xml2rfc 1.33. |
---|
232 | |
---|
233 | 2.1. Extension elements |
---|
234 | |
---|
235 | "rfc2629.xslt" supports two kind of extension elements, using |
---|
236 | different XML namespaces. |
---|
237 | |
---|
238 | The first set contains (hopefully) generally useful extensions, see |
---|
239 | Section 11. |
---|
240 | |
---|
241 | The second set is used for change and issue tracking and currently is |
---|
242 | not documented here. Please email the author in case you're |
---|
243 | interested in using these extensions. |
---|
244 | |
---|
245 | |
---|
246 | |
---|
247 | |
---|
248 | |
---|
249 | |
---|
250 | |
---|
251 | |
---|
252 | |
---|
253 | |
---|
254 | |
---|
255 | |
---|
256 | |
---|
257 | |
---|
258 | |
---|
259 | |
---|
260 | |
---|
261 | |
---|
262 | |
---|
263 | |
---|
264 | |
---|
265 | |
---|
266 | |
---|
267 | |
---|
268 | |
---|
269 | |
---|
270 | |
---|
271 | |
---|
272 | |
---|
273 | |
---|
274 | |
---|
275 | |
---|
276 | |
---|
277 | |
---|
278 | |
---|
279 | Reschke [Page 5] |
---|
280 | |
---|
281 | Documentation RFC2629 through XSLT March 2011 |
---|
282 | |
---|
283 | |
---|
284 | 3. Processing Instructions |
---|
285 | |
---|
286 | All PIs can be set as XSLT parameter as well, overriding any value |
---|
287 | that is found in the source file to be transformed. |
---|
288 | |
---|
289 | Using processing instructions: |
---|
290 | |
---|
291 | <?rfc toc="yes"?> |
---|
292 | <?rfc-ext support-rfc2731="no"?> |
---|
293 | |
---|
294 | Using XSLT parameters (Saxon): |
---|
295 | |
---|
296 | java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \ |
---|
297 | xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html |
---|
298 | |
---|
299 | Using XSLT parameters (xsltproc): |
---|
300 | |
---|
301 | xsltproc --param xml2rfc-toc '"yes"' \ |
---|
302 | --param xml2rfc-ext-support-rfc2731 '"no"' \ |
---|
303 | rfc2629.xslt source.xml > result.html |
---|
304 | |
---|
305 | (note the required quoting of string parameters) |
---|
306 | |
---|
307 | |
---|
308 | |
---|
309 | |
---|
310 | |
---|
311 | |
---|
312 | |
---|
313 | |
---|
314 | |
---|
315 | |
---|
316 | |
---|
317 | |
---|
318 | |
---|
319 | |
---|
320 | |
---|
321 | |
---|
322 | |
---|
323 | |
---|
324 | |
---|
325 | |
---|
326 | |
---|
327 | |
---|
328 | |
---|
329 | |
---|
330 | |
---|
331 | |
---|
332 | |
---|
333 | |
---|
334 | |
---|
335 | Reschke [Page 6] |
---|
336 | |
---|
337 | Documentation RFC2629 through XSLT March 2011 |
---|
338 | |
---|
339 | |
---|
340 | 3.1. Supported xml2rfc-compatible PIs |
---|
341 | |
---|
342 | +------+--------------+------------------+------------+-------------+ |
---|
343 | | PI | PI | XSLT parameter | default | comment | |
---|
344 | | targ | pseudo-attri | name | | | |
---|
345 | | et | bute | | | | |
---|
346 | +------+--------------+------------------+------------+-------------+ |
---|
347 | | rfc | background | xml2rfc-backgrou | (not set) | | |
---|
348 | | | | nd | | | |
---|
349 | | | | | | | |
---|
350 | | rfc | compact | xml2rfc-compact | "no" | only | |
---|
351 | | | | | | applies to | |
---|
352 | | | | | | HTML output | |
---|
353 | | | | | | method when | |
---|
354 | | | | | | printing | |
---|
355 | | | | | | | |
---|
356 | | rfc | comments | xml2rfc-comments | (not set) | | |
---|
357 | | | | | | | |
---|
358 | | rfc | editing | xml2rfc-editing | "no" | | |
---|
359 | | | | | | | |
---|
360 | | rfc | footer | xml2rfc-footer | (not set) | | |
---|
361 | | | | | | | |
---|
362 | | rfc | header | xml2rfc-header | (not set) | | |
---|
363 | | | | | | | |
---|
364 | | rfc | inline | xml2rfc-inline | (not set) | | |
---|
365 | | | | | | | |
---|
366 | | rfc | iprnotified | xml2rfc-iprnotif | "no" | | |
---|
367 | | | | ied | | | |
---|
368 | | | | | | | |
---|
369 | | rfc | linkmailto | xml2rfc-linkmail | "yes" | | |
---|
370 | | | | to | | | |
---|
371 | | | | | | | |
---|
372 | | rfc | private | xml2rfc-private | (not set) | | |
---|
373 | | | | | | | |
---|
374 | | rfc | refparent | xml2rfc-private | "Reference | Title for | |
---|
375 | | | | | s" | References | |
---|
376 | | | | | | sections | |
---|
377 | | | | | | when | |
---|
378 | | | | | | automatical | |
---|
379 | | | | | | ly inserted | |
---|
380 | | | | | | | |
---|
381 | | rfc | rfcedstyle | xml2rfc-rfcedsty | (not set) | (limited | |
---|
382 | | | | le | | support) | |
---|
383 | | | | | | | |
---|
384 | | rfc | sortrefs | xml2rfc-sortrefs | "no" | | |
---|
385 | | | | | | | |
---|
386 | |
---|
387 | |
---|
388 | |
---|
389 | |
---|
390 | |
---|
391 | Reschke [Page 7] |
---|
392 | |
---|
393 | Documentation RFC2629 through XSLT March 2011 |
---|
394 | |
---|
395 | |
---|
396 | | rfc | symrefs | xml2rfc-symrefs | "yes" | The default | |
---|
397 | | | | | | has changed | |
---|
398 | | | | | | from "no" | |
---|
399 | | | | | | to "yes" as | |
---|
400 | | | | | | of June 6, | |
---|
401 | | | | | | 2007 and | |
---|
402 | | | | | | xml2rfc | |
---|
403 | | | | | | 1.33pre4. | |
---|
404 | | | | | | | |
---|
405 | | rfc | toc | xml2rfc-toc | "no" | | |
---|
406 | | | | | | | |
---|
407 | | rfc | tocdepth | xml2rfc-tocdepth | 99 | | |
---|
408 | | | | | | | |
---|
409 | | rfc | topblock | xml2rfc-topblock | "yes" | | |
---|
410 | +------+--------------+------------------+------------+-------------+ |
---|
411 | |
---|
412 | 3.2. Unsupported xml2rfc-compatible PIs |
---|
413 | |
---|
414 | +--------+------------------+---------------------------------------+ |
---|
415 | | PI | PI | comment | |
---|
416 | | target | pseudo-attribute | | |
---|
417 | +--------+------------------+---------------------------------------+ |
---|
418 | | rfc | include | incompatible with XML/XSLT processing | |
---|
419 | | | | model, please use external entities | |
---|
420 | | | | instead | |
---|
421 | | | | | |
---|
422 | | rfc | needLines | | |
---|
423 | | | | | |
---|
424 | | rfc | slides | | |
---|
425 | | | | | |
---|
426 | | rfc | strict | | |
---|
427 | | | | | |
---|
428 | | rfc | subcompact | | |
---|
429 | | | | | |
---|
430 | | rfc | tocindent | (defaults to "yes") | |
---|
431 | | | | | |
---|
432 | | rfc | tocompact | | |
---|
433 | +--------+------------------+---------------------------------------+ |
---|
434 | |
---|
435 | |
---|
436 | |
---|
437 | |
---|
438 | |
---|
439 | |
---|
440 | |
---|
441 | |
---|
442 | |
---|
443 | |
---|
444 | |
---|
445 | |
---|
446 | |
---|
447 | Reschke [Page 8] |
---|
448 | |
---|
449 | Documentation RFC2629 through XSLT March 2011 |
---|
450 | |
---|
451 | |
---|
452 | 3.3. Extension PIs |
---|
453 | |
---|
454 | +------+-----------------+-----------------------+------+-----------+ |
---|
455 | | PI | PI | XSLT parameter name | defa | descripti | |
---|
456 | | targ | pseudo-attribut | | ult | on | |
---|
457 | | et | e | | | | |
---|
458 | +------+-----------------+-----------------------+------+-----------+ |
---|
459 | | rfc- | allow-markup-in | xml2rfc-allow-markup- | "no" | Enables | |
---|
460 | | ext | -artwork | in-artwork | | support | |
---|
461 | | | | | | for | |
---|
462 | | | | | | specific | |
---|
463 | | | | | | elements | |
---|
464 | | | | | | inside | |
---|
465 | | | | | | abstract | |
---|
466 | | | | | | elements | |
---|
467 | | | | | | (using | |
---|
468 | | | | | | this | |
---|
469 | | | | | | extension | |
---|
470 | | | | | | makes the | |
---|
471 | | | | | | document | |
---|
472 | | | | | | incompati | |
---|
473 | | | | | | ble to | |
---|
474 | | | | | | the | |
---|
475 | | | | | | RFC2629bi | |
---|
476 | | | | | | s DTD; | |
---|
477 | | | | | | see | |
---|
478 | | | | | | descripti | |
---|
479 | | | | | | on of | |
---|
480 | | | | | | conversio | |
---|
481 | | | | | | n XSLT in | |
---|
482 | | | | | | Section 1 | |
---|
483 | | | | | | 2.4). | |
---|
484 | | | | | | | |
---|
485 | |
---|
486 | |
---|
487 | |
---|
488 | |
---|
489 | |
---|
490 | |
---|
491 | |
---|
492 | |
---|
493 | |
---|
494 | |
---|
495 | |
---|
496 | |
---|
497 | |
---|
498 | |
---|
499 | |
---|
500 | |
---|
501 | |
---|
502 | |
---|
503 | Reschke [Page 9] |
---|
504 | |
---|
505 | Documentation RFC2629 through XSLT March 2011 |
---|
506 | |
---|
507 | |
---|
508 | | rfc- | authors-section | xml2rfc-ext-authors-s | | When | |
---|
509 | | ext | | ection | | "end", | |
---|
510 | | | | | | place the | |
---|
511 | | | | | | authors | |
---|
512 | | | | | | section | |
---|
513 | | | | | | at the | |
---|
514 | | | | | | end (just | |
---|
515 | | | | | | before | |
---|
516 | | | | | | the | |
---|
517 | | | | | | copyright | |
---|
518 | | | | | | statement | |
---|
519 | | | | | | s). This | |
---|
520 | | | | | | seems to | |
---|
521 | | | | | | be the | |
---|
522 | | | | | | preferred | |
---|
523 | | | | | | order in | |
---|
524 | | | | | | the | |
---|
525 | | | | | | newest | |
---|
526 | | | | | | RFCs. | |
---|
527 | | | | | | | |
---|
528 | | rfc- | duplex | xml2rfc-ext-duplex | no | When set | |
---|
529 | | ext | | | | to "yes", | |
---|
530 | | | | | | format | |
---|
531 | | | | | | the PDF | |
---|
532 | | | | | | output | |
---|
533 | | | | | | for | |
---|
534 | | | | | | doublesid | |
---|
535 | | | | | | ed | |
---|
536 | | | | | | printing. | |
---|
537 | | | | | | | |
---|
538 | | rfc- | include-referen | xml2rfc-ext-include-r | | When set | |
---|
539 | | ext | ces-in-index | eferences-in-index | | to "yes", | |
---|
540 | | | | | | index | |
---|
541 | | | | | | entries | |
---|
542 | | | | | | are | |
---|
543 | | | | | | generated | |
---|
544 | | | | | | for all | |
---|
545 | | | | | | reference | |
---|
546 | | | | | | s. | |
---|
547 | | | | | | | |
---|
548 | |
---|
549 | |
---|
550 | |
---|
551 | |
---|
552 | |
---|
553 | |
---|
554 | |
---|
555 | |
---|
556 | |
---|
557 | |
---|
558 | |
---|
559 | Reschke [Page 10] |
---|
560 | |
---|
561 | Documentation RFC2629 through XSLT March 2011 |
---|
562 | |
---|
563 | |
---|
564 | | rfc- | justification | xml2rfc-ext-justifica | "nev | "never": | |
---|
565 | | ext | | tion | er" | never | |
---|
566 | | | | | | emit | |
---|
567 | | | | | | justified | |
---|
568 | | | | | | text, | |
---|
569 | | | | | | "always": | |
---|
570 | | | | | | always | |
---|
571 | | | | | | emit | |
---|
572 | | | | | | justified | |
---|
573 | | | | | | text, | |
---|
574 | | | | | | "print": | |
---|
575 | | | | | | only emit | |
---|
576 | | | | | | justified | |
---|
577 | | | | | | text for | |
---|
578 | | | | | | print | |
---|
579 | | | | | | media. | |
---|
580 | | | | | | | |
---|
581 | | rfc- | parse-xml-in-ar | xml2rfc-parse-xml-in- | "no" | May be | |
---|
582 | | ext | twork | artwork | | used to | |
---|
583 | | | | | | enable | |
---|
584 | | | | | | parsing | |
---|
585 | | | | | | of XML | |
---|
586 | | | | | | content | |
---|
587 | | | | | | in | |
---|
588 | | | | | | figures | |
---|
589 | | | | | | (MSXML | |
---|
590 | | | | | | only). | |
---|
591 | | | | | | | |
---|
592 | | rfc- | support-rfc2731 | xml2rfc-ext-support-r | "yes | Decides | |
---|
593 | | ext | | fc2731 | " | whether | |
---|
594 | | | | | | the HTML | |
---|
595 | | | | | | transform | |
---|
596 | | | | | | ation | |
---|
597 | | | | | | should | |
---|
598 | | | | | | generate | |
---|
599 | | | | | | META tags | |
---|
600 | | | | | | according | |
---|
601 | | | | | | Section 6 | |
---|
602 | | | | | | .4. | |
---|
603 | | | | | | | |
---|
604 | |
---|
605 | |
---|
606 | |
---|
607 | |
---|
608 | |
---|
609 | |
---|
610 | |
---|
611 | |
---|
612 | |
---|
613 | |
---|
614 | |
---|
615 | Reschke [Page 11] |
---|
616 | |
---|
617 | Documentation RFC2629 through XSLT March 2011 |
---|
618 | |
---|
619 | |
---|
620 | | rfc- | sec-no-trailing | xml2rfc-ext-sec-no-tr | | When set | |
---|
621 | | ext | -dots | ailing-dots | | to "yes", | |
---|
622 | | | | | | add | |
---|
623 | | | | | | trailing | |
---|
624 | | | | | | dots to | |
---|
625 | | | | | | section | |
---|
626 | | | | | | numbers. | |
---|
627 | | | | | | This | |
---|
628 | | | | | | seems to | |
---|
629 | | | | | | be the | |
---|
630 | | | | | | preferred | |
---|
631 | | | | | | format in | |
---|
632 | | | | | | the | |
---|
633 | | | | | | newest | |
---|
634 | | | | | | RFCs. | |
---|
635 | +------+-----------------+-----------------------+------+-----------+ |
---|
636 | |
---|
637 | |
---|
638 | |
---|
639 | |
---|
640 | |
---|
641 | |
---|
642 | |
---|
643 | |
---|
644 | |
---|
645 | |
---|
646 | |
---|
647 | |
---|
648 | |
---|
649 | |
---|
650 | |
---|
651 | |
---|
652 | |
---|
653 | |
---|
654 | |
---|
655 | |
---|
656 | |
---|
657 | |
---|
658 | |
---|
659 | |
---|
660 | |
---|
661 | |
---|
662 | |
---|
663 | |
---|
664 | |
---|
665 | |
---|
666 | |
---|
667 | |
---|
668 | |
---|
669 | |
---|
670 | |
---|
671 | Reschke [Page 12] |
---|
672 | |
---|
673 | Documentation RFC2629 through XSLT March 2011 |
---|
674 | |
---|
675 | |
---|
676 | 4. Anchors |
---|
677 | |
---|
678 | The transformation automatically generates anchors that are supposed |
---|
679 | to be stable and predictable and that can be used to identify |
---|
680 | specific parts of the document. Anchors are generated both in HTML |
---|
681 | and XSL-FO content (but the latter will only be used for PDF output |
---|
682 | when the XSL-FO engine supports producing PDF anchors). |
---|
683 | |
---|
684 | |
---|
685 | |
---|
686 | |
---|
687 | |
---|
688 | |
---|
689 | |
---|
690 | |
---|
691 | |
---|
692 | |
---|
693 | |
---|
694 | |
---|
695 | |
---|
696 | |
---|
697 | |
---|
698 | |
---|
699 | |
---|
700 | |
---|
701 | |
---|
702 | |
---|
703 | |
---|
704 | |
---|
705 | |
---|
706 | |
---|
707 | |
---|
708 | |
---|
709 | |
---|
710 | |
---|
711 | |
---|
712 | |
---|
713 | |
---|
714 | |
---|
715 | |
---|
716 | |
---|
717 | |
---|
718 | |
---|
719 | |
---|
720 | |
---|
721 | |
---|
722 | |
---|
723 | |
---|
724 | |
---|
725 | |
---|
726 | |
---|
727 | Reschke [Page 13] |
---|
728 | |
---|
729 | Documentation RFC2629 through XSLT March 2011 |
---|
730 | |
---|
731 | |
---|
732 | The following anchors get auto-generated: |
---|
733 | |
---|
734 | +-----------------------+---------------------------------------+ |
---|
735 | | Anchor name | Description | |
---|
736 | +-----------------------+---------------------------------------+ |
---|
737 | | rfc.abstract | Abstract | |
---|
738 | | | | |
---|
739 | | rfc.authors | Authors section | |
---|
740 | | | | |
---|
741 | | rfc.copyright | Copyright section | |
---|
742 | | | | |
---|
743 | | rfc.copyrightnotice | Copyright notice | |
---|
744 | | | | |
---|
745 | | rfc.figure._n_ | Figures (titled) | |
---|
746 | | | | |
---|
747 | | rfc.figure.u._n_ | Figures (untitled) | |
---|
748 | | | | |
---|
749 | | rfc.index | Index | |
---|
750 | | | | |
---|
751 | | rfc.ipr | Intellectual Property | |
---|
752 | | | | |
---|
753 | | rfc.iref._n_ | Internal references | |
---|
754 | | | | |
---|
755 | | rfc.note._n_ | Notes (from front section) | |
---|
756 | | | | |
---|
757 | | rfc.references | References | |
---|
758 | | | | |
---|
759 | | rfc.references._n_ | Additional references | |
---|
760 | | | | |
---|
761 | | rfc.section._n_ | Section _n_ | |
---|
762 | | | | |
---|
763 | | rfc.section._n_.p._m_ | Section _n_, paragraph _m_ | |
---|
764 | | | | |
---|
765 | | rfc.status | Status of memo | |
---|
766 | | | | |
---|
767 | | rfc.table._n_ | Tables (titled) | |
---|
768 | | | | |
---|
769 | | rfc.table.u._n_ | Tables (untitled) | |
---|
770 | | | | |
---|
771 | | rfc.toc | Table of contents | |
---|
772 | | | | |
---|
773 | | rfc.xref._name_._n_ | References to reference _n_ to _name_ | |
---|
774 | +-----------------------+---------------------------------------+ |
---|
775 | |
---|
776 | |
---|
777 | |
---|
778 | |
---|
779 | |
---|
780 | |
---|
781 | |
---|
782 | |
---|
783 | Reschke [Page 14] |
---|
784 | |
---|
785 | Documentation RFC2629 through XSLT March 2011 |
---|
786 | |
---|
787 | |
---|
788 | 5. Supported XSLT engines |
---|
789 | |
---|
790 | The transformation requires a non-standard extension function (see |
---|
791 | exsl:node-set [1]) which is however widely available. XSLT |
---|
792 | processors that do not support this extension (or a functional |
---|
793 | equivalent) currently are not supported. |
---|
794 | |
---|
795 | 5.1. Standalone Engines |
---|
796 | |
---|
797 | The following XSLT engines are believed to work well: |
---|
798 | |
---|
799 | o Windows: MSXML3 and MSXML4 (<http://msdn.microsoft.com/xml>; |
---|
800 | command line processor "msxsl" is available from Microsoft |
---|
801 | Download Center [2]) |
---|
802 | |
---|
803 | o Java: Saxon (<http://saxon.sourceforge.net/>) |
---|
804 | |
---|
805 | o Java: Xalan (<http://xml.apache.org/xalan-j/>) |
---|
806 | |
---|
807 | o C/C++: xsltproc (libxslt) (<http://xmlsoft.org/XSLT/>, make sure |
---|
808 | that you have a current version) |
---|
809 | |
---|
810 | 5.2. In-Browser Engines |
---|
811 | |
---|
812 | The following browsers seem to work fine: |
---|
813 | |
---|
814 | o Internet Explorer 5.5 (Windows version, if MSXML3 is installed) |
---|
815 | |
---|
816 | o Internet Explorer 6 and newer |
---|
817 | |
---|
818 | o Firefox 3.0 and newer |
---|
819 | |
---|
820 | |
---|
821 | * Be aware that XSLT execution can be suppressed using |
---|
822 | NoScript [3] |
---|
823 | |
---|
824 | * Firefox does not load external DTDs nor external entities, see |
---|
825 | Mozilla Bug 22942 [4], thus entities like need to be |
---|
826 | declared in the internal subset (Appendix C.1) |
---|
827 | |
---|
828 | * There seems to be a new problem in Firefox 4 where it |
---|
829 | occasionally does the initial rendering with the wrong width |
---|
830 | (people who can reproduce this problem please comment on |
---|
831 | <https://bugzilla.mozilla.org/show_bug.cgi?id=640390>. |
---|
832 | |
---|
833 | o Safari 3 (starting with version 3.0.4) |
---|
834 | |
---|
835 | |
---|
836 | |
---|
837 | |
---|
838 | |
---|
839 | Reschke [Page 15] |
---|
840 | |
---|
841 | Documentation RFC2629 through XSLT March 2011 |
---|
842 | |
---|
843 | |
---|
844 | o Google Chrome |
---|
845 | |
---|
846 | o Opera (starting with version 10) |
---|
847 | |
---|
848 | The following browsers are known not to work properly: |
---|
849 | |
---|
850 | o Firefox 1.*/2.*: (missing extension function - see change request |
---|
851 | at Mozilla BugZilla 193678 [5]) |
---|
852 | |
---|
853 | o Opera 9.21: execution fails, potentially to a somewhat complex |
---|
854 | XPath expression (reported to Opera as bug 245725). |
---|
855 | |
---|
856 | o Opera 9.5 and 9.6: transformation appears to work, but CSS isn't |
---|
857 | getting applied (reported to Opera as bug 337388 on 2008-06-12). |
---|
858 | |
---|
859 | o Safari 2.* supports client-side XSLT as of MacOS X 10.4, but |
---|
860 | misses required extension functions. A problem with stylesheets |
---|
861 | producing non-ASCII output (such as NBSP characters) has been |
---|
862 | fixed as of OSX 10.4.4. Both problems have been reported through |
---|
863 | Apple's bug tracking system, see <http://drakken.dbc.mtview.ca.us/ |
---|
864 | pipermail/xml2rfc/2005-May/002073.html> and |
---|
865 | <http://bugs.webkit.org/show_bug.cgi?id=4079>. |
---|
866 | |
---|
867 | |
---|
868 | |
---|
869 | |
---|
870 | |
---|
871 | |
---|
872 | |
---|
873 | |
---|
874 | |
---|
875 | |
---|
876 | |
---|
877 | |
---|
878 | |
---|
879 | |
---|
880 | |
---|
881 | |
---|
882 | |
---|
883 | |
---|
884 | |
---|
885 | |
---|
886 | |
---|
887 | |
---|
888 | |
---|
889 | |
---|
890 | |
---|
891 | |
---|
892 | |
---|
893 | |
---|
894 | |
---|
895 | Reschke [Page 16] |
---|
896 | |
---|
897 | Documentation RFC2629 through XSLT March 2011 |
---|
898 | |
---|
899 | |
---|
900 | 6. Transforming to HTML |
---|
901 | |
---|
902 | Transformation to HTML can be done inside the browser if it supports |
---|
903 | XSLT. To enable this, add the following processing instruction to |
---|
904 | the start of the source file: |
---|
905 | |
---|
906 | <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> |
---|
907 | |
---|
908 | (and ensure that "rfc2629.xslt" is present). |
---|
909 | |
---|
910 | 6.1. HTML compliance |
---|
911 | |
---|
912 | The transformation result is supposed to conform to the HTML 4.01 |
---|
913 | strict DTD [HTML]. This can be checked using the W3C's online |
---|
914 | validator at <http://validator.w3.org>. |
---|
915 | |
---|
916 | 6.2. Standard HTML LINK elements |
---|
917 | |
---|
918 | LINK elements exist since HTML 2.0. They can be used to embed |
---|
919 | content-independant links inside the document. Unfortunately, only |
---|
920 | few user agents support this element. Firefox users may want to |
---|
921 | check the Link Widgets [6] extension. |
---|
922 | |
---|
923 | The following LINK elements are produced: |
---|
924 | |
---|
925 | +-----------+-------------------------------------------------------+ |
---|
926 | | LINK type | description | |
---|
927 | +-----------+-------------------------------------------------------+ |
---|
928 | | alternate | for RFCs, a link to the authorative ASCII version on | |
---|
929 | | | the IETF web site | |
---|
930 | | | | |
---|
931 | | appendic | pointer to all top-level appendics | |
---|
932 | | | | |
---|
933 | | author | pointer to "authors" section | |
---|
934 | | | | |
---|
935 | | chapter | pointer to all top-level sections | |
---|
936 | | | | |
---|
937 | | contents | pointer to table of contents | |
---|
938 | | | | |
---|
939 | | copyright | pointer to copyright statement | |
---|
940 | | | | |
---|
941 | | index | pointer to index | |
---|
942 | +-----------+-------------------------------------------------------+ |
---|
943 | |
---|
944 | The figure below shows how Mozilla Firefox 1.0 displays the Site |
---|
945 | Navigation Bar for rfc2396.xml. |
---|
946 | |
---|
947 | |
---|
948 | |
---|
949 | |
---|
950 | |
---|
951 | Reschke [Page 17] |
---|
952 | |
---|
953 | Documentation RFC2629 through XSLT March 2011 |
---|
954 | |
---|
955 | |
---|
956 | 6.3. Standard HTML metadata |
---|
957 | |
---|
958 | The following standard HTML META elements are produced: |
---|
959 | |
---|
960 | +-----------+-------------------------------------------------+ |
---|
961 | | META name | description | |
---|
962 | +-----------+-------------------------------------------------+ |
---|
963 | | generator | from XSLT engine version and stylesheet version | |
---|
964 | | | | |
---|
965 | | keywords | from keyword elements in front section | |
---|
966 | +-----------+-------------------------------------------------+ |
---|
967 | |
---|
968 | 6.4. Dublin Core (RFC2731) metadata |
---|
969 | |
---|
970 | Unless turned off using the "rfc-ext support-rfc2731" processing |
---|
971 | instruction, the transformation will generate metadata according to |
---|
972 | [RFC2731] and [DC-HTML]. |
---|
973 | |
---|
974 | The following DCMI properties are produced: |
---|
975 | |
---|
976 | +-------------------------+-----------------------------------------+ |
---|
977 | | META name | description | |
---|
978 | +-------------------------+-----------------------------------------+ |
---|
979 | | DC.Creator | from author information in front | |
---|
980 | | | section | |
---|
981 | | | | |
---|
982 | | DC.Date.Issued | from date information in front section | |
---|
983 | | | | |
---|
984 | | DC.Description.Abstract | from abstract | |
---|
985 | | | | |
---|
986 | | DC.Identifier | document URN [RFC2648] from "docName" | |
---|
987 | | | attribute | |
---|
988 | | | | |
---|
989 | | DC.isPartOf | RFC ISSN (for RFCs) | |
---|
990 | | | | |
---|
991 | | DC.Relation.Replaces | from "obsoletes" attribute | |
---|
992 | +-------------------------+-----------------------------------------+ |
---|
993 | |
---|
994 | 6.5. Experimental hCard support |
---|
995 | |
---|
996 | The generated author information is formatted in hCard [7] format. |
---|
997 | |
---|
998 | |
---|
999 | |
---|
1000 | |
---|
1001 | |
---|
1002 | |
---|
1003 | |
---|
1004 | |
---|
1005 | |
---|
1006 | |
---|
1007 | Reschke [Page 18] |
---|
1008 | |
---|
1009 | Documentation RFC2629 through XSLT March 2011 |
---|
1010 | |
---|
1011 | |
---|
1012 | 7. Transforming to XHTML |
---|
1013 | |
---|
1014 | Transforming to XHTML requires slightly different XSLT output options |
---|
1015 | and is implemented by the derived transformation script |
---|
1016 | "rfc2629toXHTML.xslt". |
---|
1017 | |
---|
1018 | Note: Microsoft Internet Explorer does _not_ support XHTML. |
---|
1019 | Therefore it usually makes more sense to generate plain old HTML. |
---|
1020 | |
---|
1021 | |
---|
1022 | |
---|
1023 | |
---|
1024 | |
---|
1025 | |
---|
1026 | |
---|
1027 | |
---|
1028 | |
---|
1029 | |
---|
1030 | |
---|
1031 | |
---|
1032 | |
---|
1033 | |
---|
1034 | |
---|
1035 | |
---|
1036 | |
---|
1037 | |
---|
1038 | |
---|
1039 | |
---|
1040 | |
---|
1041 | |
---|
1042 | |
---|
1043 | |
---|
1044 | |
---|
1045 | |
---|
1046 | |
---|
1047 | |
---|
1048 | |
---|
1049 | |
---|
1050 | |
---|
1051 | |
---|
1052 | |
---|
1053 | |
---|
1054 | |
---|
1055 | |
---|
1056 | |
---|
1057 | |
---|
1058 | |
---|
1059 | |
---|
1060 | |
---|
1061 | |
---|
1062 | |
---|
1063 | Reschke [Page 19] |
---|
1064 | |
---|
1065 | Documentation RFC2629 through XSLT March 2011 |
---|
1066 | |
---|
1067 | |
---|
1068 | 8. Transforming to CHM (Microsoft Compiled Help) |
---|
1069 | |
---|
1070 | To generate a CHM file using Microsoft's HTML Help Compiler (hhc), |
---|
1071 | three files are required in addition to the HTML file. |
---|
1072 | |
---|
1073 | 1. hhc - table of contents file (HTML) |
---|
1074 | |
---|
1075 | 2. hhk - index file (HTML) |
---|
1076 | |
---|
1077 | 3. hhp - project file (plain text) |
---|
1078 | |
---|
1079 | The three files are generated with three specific transformations, |
---|
1080 | each requiring the additional XSLT parameter "basename" to specify |
---|
1081 | the filename prefix. |
---|
1082 | |
---|
1083 | Example: |
---|
1084 | |
---|
1085 | saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616 > rfc2616.hhp |
---|
1086 | saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616 > rfc2616.hhc |
---|
1087 | saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616 > rfc2616.hhk |
---|
1088 | hhc rfc2616.hhp |
---|
1089 | |
---|
1090 | |
---|
1091 | |
---|
1092 | |
---|
1093 | |
---|
1094 | |
---|
1095 | |
---|
1096 | |
---|
1097 | |
---|
1098 | |
---|
1099 | |
---|
1100 | |
---|
1101 | |
---|
1102 | |
---|
1103 | |
---|
1104 | |
---|
1105 | |
---|
1106 | |
---|
1107 | |
---|
1108 | |
---|
1109 | |
---|
1110 | |
---|
1111 | |
---|
1112 | |
---|
1113 | |
---|
1114 | |
---|
1115 | |
---|
1116 | |
---|
1117 | |
---|
1118 | |
---|
1119 | Reschke [Page 20] |
---|
1120 | |
---|
1121 | Documentation RFC2629 through XSLT March 2011 |
---|
1122 | |
---|
1123 | |
---|
1124 | 9. Transforming to PDF |
---|
1125 | |
---|
1126 | 9.1. Via XSL-FO |
---|
1127 | |
---|
1128 | Transformation to XSL-FO [XSL-FO] format is available through |
---|
1129 | "rfc2629toFO.xslt" (which includes "rfc2629.xslt", so keep both in |
---|
1130 | the same folder). |
---|
1131 | |
---|
1132 | Compared to HTML user agents, XSL-FO engines unfortunately either |
---|
1133 | come as open source (for instance, Apache FOP) or feature-complete |
---|
1134 | (for instance, AntennaHouse XSL Formatter), but not both at the same |
---|
1135 | time. |
---|
1136 | |
---|
1137 | As Apache FOP needs special workarounds (index generation), and some |
---|
1138 | popular extensions aren't standardized yet, the translation produces |
---|
1139 | a generic output (hopefully) conforming to [XSL-FO]. Specific |
---|
1140 | backends ("xsl11toFop.xslt", "xsl11toXep.xslt", "xsl11toAn.xslt") |
---|
1141 | then provide post-processing for the individual processors. |
---|
1142 | |
---|
1143 | Note: the output is currently targeted at Apache FOP 1.0. |
---|
1144 | |
---|
1145 | 9.1.1. Extension feature matrix |
---|
1146 | |
---|
1147 | +------------+-------------+------------+-------------+-------------+ |
---|
1148 | | | PDF anchors | PDF | PDF | Index | |
---|
1149 | | | | bookmarks | document | cleanup | |
---|
1150 | | | | | information | | |
---|
1151 | +------------+-------------+------------+-------------+-------------+ |
---|
1152 | | XSL 1.1 | no, but can | yes | no, but | yes | |
---|
1153 | | WD [8] | be | | uses XEP | | |
---|
1154 | | | auto-genera | | output | | |
---|
1155 | | | ted from | | extensions | | |
---|
1156 | | | "id" | | | | |
---|
1157 | | | attributes | | | | |
---|
1158 | | | | | | | |
---|
1159 | | Antenna | no | yes [10] | yes [10] | yes [10] | |
---|
1160 | | House XSL | | (from XSL | (from XEP | (just page | |
---|
1161 | | formatter | | 1.1 | document | duplicate | |
---|
1162 | | [9] | | bookmarks) | info) | elimination | |
---|
1163 | | | | | | , from XSL | |
---|
1164 | | | | | | 1.1 page | |
---|
1165 | | | | | | index) | |
---|
1166 | | | | | | | |
---|
1167 | | Apache | yes | yes (from | yes | no | |
---|
1168 | | FOP [11] | | XSL 1.1 | | | |
---|
1169 | | | | bookmarks) | | | |
---|
1170 | | | | | | | |
---|
1171 | |
---|
1172 | |
---|
1173 | |
---|
1174 | |
---|
1175 | Reschke [Page 21] |
---|
1176 | |
---|
1177 | Documentation RFC2629 through XSLT March 2011 |
---|
1178 | |
---|
1179 | |
---|
1180 | | RenderX | no | yes [13] | yes [13] | yes [13] | |
---|
1181 | | XEP [12] | | (from XSL | | (from XSL | |
---|
1182 | | | | 1.1 | | 1.1 page | |
---|
1183 | | | | bookmarks) | | index) | |
---|
1184 | +------------+-------------+------------+-------------+-------------+ |
---|
1185 | |
---|
1186 | 9.1.2. Example: producing output for Apache FOP |
---|
1187 | |
---|
1188 | Example: |
---|
1189 | |
---|
1190 | saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo |
---|
1191 | saxon tmp.fo xsl11toFop.xslt > rfc2629.fo |
---|
1192 | |
---|
1193 | 9.2. Via X(HTML) |
---|
1194 | |
---|
1195 | PDF output can also be produced directly from (X)HTML. One simple |
---|
1196 | approach is to rely on the browser's printing function, and to use a |
---|
1197 | printer driver that produces PDF. Depending on the brower's CSS |
---|
1198 | capabilities, the output will behave properly with respect to table |
---|
1199 | breaks etc. |
---|
1200 | |
---|
1201 | An alternative is PrinceXML (see <http://www.princexml.com/>), which |
---|
1202 | can produce PDF directly from (X)HTML input, based on the CSS |
---|
1203 | printing information. |
---|
1204 | |
---|
1205 | For instance, PDF output with text justification turned on can be |
---|
1206 | produced with: |
---|
1207 | |
---|
1208 | saxon input.xml rfc2629toXHTML.xslt xml2rfc-ext-justification=print \ |
---|
1209 | > output.xhtml |
---|
1210 | prince output.xhtml output.pdf |
---|
1211 | |
---|
1212 | |
---|
1213 | |
---|
1214 | |
---|
1215 | |
---|
1216 | |
---|
1217 | |
---|
1218 | |
---|
1219 | |
---|
1220 | |
---|
1221 | |
---|
1222 | |
---|
1223 | |
---|
1224 | |
---|
1225 | |
---|
1226 | |
---|
1227 | |
---|
1228 | |
---|
1229 | |
---|
1230 | |
---|
1231 | Reschke [Page 22] |
---|
1232 | |
---|
1233 | Documentation RFC2629 through XSLT March 2011 |
---|
1234 | |
---|
1235 | |
---|
1236 | 10. Transforming to ePub |
---|
1237 | |
---|
1238 | Experimental transformation to ePub format is available through a set |
---|
1239 | of stylesheets, and the Unix Shell script "mkepub.sh" (which requires |
---|
1240 | that "zip" and either "saxon" or "xsltproc" are installed). |
---|
1241 | |
---|
1242 | For instance, an epub version of rfc2616.xml can be generated like |
---|
1243 | this: |
---|
1244 | |
---|
1245 | mkepub.sh rfc2616.xml |
---|
1246 | |
---|
1247 | |
---|
1248 | |
---|
1249 | |
---|
1250 | |
---|
1251 | |
---|
1252 | |
---|
1253 | |
---|
1254 | |
---|
1255 | |
---|
1256 | |
---|
1257 | |
---|
1258 | |
---|
1259 | |
---|
1260 | |
---|
1261 | |
---|
1262 | |
---|
1263 | |
---|
1264 | |
---|
1265 | |
---|
1266 | |
---|
1267 | |
---|
1268 | |
---|
1269 | |
---|
1270 | |
---|
1271 | |
---|
1272 | |
---|
1273 | |
---|
1274 | |
---|
1275 | |
---|
1276 | |
---|
1277 | |
---|
1278 | |
---|
1279 | |
---|
1280 | |
---|
1281 | |
---|
1282 | |
---|
1283 | |
---|
1284 | |
---|
1285 | |
---|
1286 | |
---|
1287 | Reschke [Page 23] |
---|
1288 | |
---|
1289 | Documentation RFC2629 through XSLT March 2011 |
---|
1290 | |
---|
1291 | |
---|
1292 | 11. Generic Extensions |
---|
1293 | |
---|
1294 | This section documents extensions implemented in "rfc2629.xslt", |
---|
1295 | using the extension namespace "http://purl.org/net/xml2rfc/ext". |
---|
1296 | |
---|
1297 | 11.1. <abnf-char-sequence> element |
---|
1298 | |
---|
1299 | Converts the contained quoted string into a hex-encoded character |
---|
1300 | sequence, for use in case-sensitive ABNF productions. |
---|
1301 | |
---|
1302 | For instance, "<x:abnf-char-sequence>"HTTP"</x:abnf-char-sequence>" |
---|
1303 | gets converted to "%x48.54.54.50". |
---|
1304 | |
---|
1305 | 11.2. <anchor-alias> element |
---|
1306 | |
---|
1307 | Using its "value" attribute, this element allows the definition of an |
---|
1308 | internal link target alias for the enclosing element. This alias can |
---|
1309 | then be used with the <ref> element for intra-document references. |
---|
1310 | |
---|
1311 | Note that the anchor alias is not subject to the naming constraints |
---|
1312 | that apply to anchor elements (which are XML names). |
---|
1313 | |
---|
1314 | 11.3. <bcp14> element |
---|
1315 | |
---|
1316 | This element marks the content as being one of the normative keywords |
---|
1317 | defined in [RFC2119]. |
---|
1318 | |
---|
1319 | |
---|
1320 | |
---|
1321 | |
---|
1322 | |
---|
1323 | |
---|
1324 | |
---|
1325 | |
---|
1326 | |
---|
1327 | |
---|
1328 | |
---|
1329 | |
---|
1330 | |
---|
1331 | |
---|
1332 | |
---|
1333 | |
---|
1334 | |
---|
1335 | |
---|
1336 | |
---|
1337 | |
---|
1338 | |
---|
1339 | |
---|
1340 | |
---|
1341 | |
---|
1342 | |
---|
1343 | Reschke [Page 24] |
---|
1344 | |
---|
1345 | Documentation RFC2629 through XSLT March 2011 |
---|
1346 | |
---|
1347 | |
---|
1348 | The DOCTYPE definition below allows using these keywords using XML |
---|
1349 | entity expansion: such as in "...server &MUST; accept...". |
---|
1350 | |
---|
1351 | <!DOCTYPE rfc [ |
---|
1352 | <!ENTITY MAY "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1353 | >MAY</bcp14>"> |
---|
1354 | <!ENTITY MUST "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1355 | >MUST</bcp14>"> |
---|
1356 | <!ENTITY MUST-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1357 | >MUST NOT</bcp14>"> |
---|
1358 | <!ENTITY OPTIONAL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1359 | >OPTIONAL</bcp14>"> |
---|
1360 | <!ENTITY RECOMMENDED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1361 | >RECOMMENDED</bcp14>"> |
---|
1362 | <!ENTITY REQUIRED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1363 | >REQUIRED</bcp14>"> |
---|
1364 | <!ENTITY SHALL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1365 | >SHALL</bcp14>"> |
---|
1366 | <!ENTITY SHALL-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1367 | >SHALL NOT</bcp14>"> |
---|
1368 | <!ENTITY SHOULD "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1369 | >SHOULD</bcp14>"> |
---|
1370 | <!ENTITY SHOULD-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1371 | >SHOULD NOT</bcp14>">]> |
---|
1372 | |
---|
1373 | 11.4. <bb> element |
---|
1374 | |
---|
1375 | Marking up a string as <bb> indicates that it represents the bottom |
---|
1376 | line of a box drawing, replacing the "+" and "-" characters |
---|
1377 | accordingly. |
---|
1378 | |
---|
1379 | 11.5. <bc> element |
---|
1380 | |
---|
1381 | Marking up a string as <bc> indicates that it represents a center |
---|
1382 | line of a box drawing, replacing the "|" character accordingly. |
---|
1383 | |
---|
1384 | 11.6. <blockquote> element |
---|
1385 | |
---|
1386 | This element is like the "blockquote" element in [HTML] (note this is |
---|
1387 | a block-level element!). It should contain one or more <t> child |
---|
1388 | elements. |
---|
1389 | |
---|
1390 | 11.7. <boilerplate> element |
---|
1391 | |
---|
1392 | Can be used to include boilerplate (status, copyright, ...) into the |
---|
1393 | front or back section. <section> elements within <x:boilerplate> |
---|
1394 | appear as unnumbered sections in the output. |
---|
1395 | |
---|
1396 | |
---|
1397 | |
---|
1398 | |
---|
1399 | Reschke [Page 25] |
---|
1400 | |
---|
1401 | Documentation RFC2629 through XSLT March 2011 |
---|
1402 | |
---|
1403 | |
---|
1404 | _This element currently can not be "down-translated" for use in |
---|
1405 | xml2rfc!_ |
---|
1406 | |
---|
1407 | 11.8. <bt> element |
---|
1408 | |
---|
1409 | Marking up a string as <bt> indicates that it represents the top line |
---|
1410 | of a box drawing, replacing the "+" and "-" characters accordingly. |
---|
1411 | |
---|
1412 | 11.9. <dfn> element |
---|
1413 | |
---|
1414 | This element is like the "dfn" element in [HTML]. |
---|
1415 | |
---|
1416 | 11.10. <h> element |
---|
1417 | |
---|
1418 | This element is like the "h" element in [XHTML2]. |
---|
1419 | |
---|
1420 | 11.11. <highlight> element |
---|
1421 | |
---|
1422 | Used to highlight text passages, currently only allowed in <artwork>. |
---|
1423 | |
---|
1424 | Note: this is stripped when generating input for xml2rfc, so please |
---|
1425 | use with care. |
---|
1426 | |
---|
1427 | 11.12. <length-of> element |
---|
1428 | |
---|
1429 | This element can be used to insert the length of another formatted |
---|
1430 | section (in decimal). |
---|
1431 | |
---|
1432 | Example: computing the Content-Length header value |
---|
1433 | |
---|
1434 | <artwork> |
---|
1435 | ... |
---|
1436 | Content-Length: <x:length-of target="req"/> |
---|
1437 | |
---|
1438 | <x:span anchor="req">123456789 |
---|
1439 | <x:span><artwork/> |
---|
1440 | |
---|
1441 | The lenght computation counts line ends as two characters (CRLF). |
---|
1442 | |
---|
1443 | Note that indentation characters in artwork _will_ be counted. The |
---|
1444 | "indented" attribute allows to specify the amount of indentation to |
---|
1445 | be substracted from the computed length. |
---|
1446 | |
---|
1447 | 11.13. <link> element |
---|
1448 | |
---|
1449 | This element can be added as a top-level child element below <rfc> to |
---|
1450 | indicate additional link information. It's currently used only when |
---|
1451 | generating HTML output, in which case an HTML <link> element with |
---|
1452 | |
---|
1453 | |
---|
1454 | |
---|
1455 | Reschke [Page 26] |
---|
1456 | |
---|
1457 | Documentation RFC2629 through XSLT March 2011 |
---|
1458 | |
---|
1459 | |
---|
1460 | identical attributes gets generated. |
---|
1461 | |
---|
1462 | Example: generating HTML link element |
---|
1463 | |
---|
1464 | <x:link xmlns="http://purl.org/net/xml2rfc/ext" |
---|
1465 | rel="Bookmark" |
---|
1466 | title="IETF WEBDAV Working Group" |
---|
1467 | href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/> |
---|
1468 | |
---|
1469 | 11.14. <lt> element |
---|
1470 | |
---|
1471 | Used for grouping multiple <t> elements into a single list item. |
---|
1472 | |
---|
1473 | 11.15. <note> element |
---|
1474 | |
---|
1475 | Can be used to add a note, usually indented by a few characters. It |
---|
1476 | should contain one or more <t> child elements. |
---|
1477 | |
---|
1478 | 11.16. <parse-xml> element |
---|
1479 | |
---|
1480 | This element instructs the processor to parse the contents as XML and |
---|
1481 | to warn when there's a problem (requires either MSXML or Saxon8 or |
---|
1482 | newer). |
---|
1483 | |
---|
1484 | 11.17. <prose> element |
---|
1485 | |
---|
1486 | This element can be used inside <reference> to add plain text (before |
---|
1487 | the date, when present). |
---|
1488 | |
---|
1489 | 11.18. <q> element |
---|
1490 | |
---|
1491 | This element is like the "q" element in [HTML]. |
---|
1492 | |
---|
1493 | 11.19. <ref> element |
---|
1494 | |
---|
1495 | This element is a simplified variant of the <xref> element, in that |
---|
1496 | no "target" attribute needs to be specified, instead the text |
---|
1497 | contents acts as identifier. That in itself wouldn't be terribly |
---|
1498 | useful, but together with the <anchor-alias>, it allows referring to |
---|
1499 | other parts of the document with minimal additional markup. |
---|
1500 | |
---|
1501 | For instance, given an alias definition such as |
---|
1502 | |
---|
1503 | <section title="Test" anchor="test"> |
---|
1504 | <x:anchor-alias value="alias1"/> |
---|
1505 | <x:anchor-alias value="alias 2"/> |
---|
1506 | ... |
---|
1507 | </section> |
---|
1508 | |
---|
1509 | |
---|
1510 | |
---|
1511 | Reschke [Page 27] |
---|
1512 | |
---|
1513 | Documentation RFC2629 through XSLT March 2011 |
---|
1514 | |
---|
1515 | |
---|
1516 | the following simple references |
---|
1517 | |
---|
1518 | <x:ref>test</x:ref> |
---|
1519 | <x:ref>alias1</x:ref> |
---|
1520 | <x:ref>alias 2</x:ref> |
---|
1521 | |
---|
1522 | are equivalent to...: |
---|
1523 | |
---|
1524 | <xref target="test">test</xref> |
---|
1525 | <xref target="test">alias1</xref> |
---|
1526 | <xref target="test">alias 2</xref> |
---|
1527 | |
---|
1528 | 11.20. <source> element |
---|
1529 | |
---|
1530 | Can be used to enhance a <reference> with information about the |
---|
1531 | location for the XML source. This can be used by the <xref> |
---|
1532 | processing code to automatically extract the target section number. |
---|
1533 | |
---|
1534 | For example: |
---|
1535 | |
---|
1536 | ... |
---|
1537 | <xref target="RFC2616" x:fmt="of" x:rel="#PUT" /> |
---|
1538 | ... |
---|
1539 | |
---|
1540 | <reference target="RFC2616"/> |
---|
1541 | ... |
---|
1542 | <x:source href="rfc2616.xml"/> |
---|
1543 | ... |
---|
1544 | |
---|
1545 | 11.21. <sup> element |
---|
1546 | |
---|
1547 | This element is like the "sup" element in [HTML]. |
---|
1548 | |
---|
1549 | Note: the down conversion to RFC2629 format replaces "x^y" by "x^y". |
---|
1550 | |
---|
1551 | 11.22. Extensions to Xml2rfc <artwork> element |
---|
1552 | |
---|
1553 | Sometimes, artwork occurs inside lists. To get it indent properly in |
---|
1554 | xml2rfc's text output, it needs to be indented in the source. This |
---|
1555 | is sub-optimal, as this whitespace will also appear in the HTML |
---|
1556 | output, where it's already indented due to HTML's semantics. |
---|
1557 | |
---|
1558 | As a workaround, a "x:indent-with" attribute can be specified, |
---|
1559 | containing a string that will be prepended to each line when |
---|
1560 | "clean-for-DTD.xslt" is run (see Section 12.4). |
---|
1561 | |
---|
1562 | |
---|
1563 | |
---|
1564 | |
---|
1565 | |
---|
1566 | |
---|
1567 | Reschke [Page 28] |
---|
1568 | |
---|
1569 | Documentation RFC2629 through XSLT March 2011 |
---|
1570 | |
---|
1571 | |
---|
1572 | 11.23. Extensions to Xml2rfc <iref> element |
---|
1573 | |
---|
1574 | The extension attribute below is allowed on the standard <iref> |
---|
1575 | element: |
---|
1576 | |
---|
1577 | o x:for-anchor specifies that the <iref> will also be automatically |
---|
1578 | inserted whenever the specified anchor is cross-referenced -- this |
---|
1579 | may save entering lots of <iref> instances. As a special case, a |
---|
1580 | value of "" (empty string) refers to the anchor attribute of the |
---|
1581 | closest ancestor. |
---|
1582 | |
---|
1583 | 11.24. Extensions to Xml2rfc <list> element |
---|
1584 | |
---|
1585 | The extension attribute below is allowed on the standard <list> |
---|
1586 | element: |
---|
1587 | |
---|
1588 | o x:indent specifies the amount of indentation for list items in |
---|
1589 | hanging lists. This can be useful when the output format, such as |
---|
1590 | XSL-FO, does not support automatical formatting. The value takes |
---|
1591 | an XSL-FO width, such as "5em". The default is _length of longest |
---|
1592 | label in characters_ times _0.8em_. |
---|
1593 | |
---|
1594 | Also, the <list> element can take <x:lt> child elements instead of |
---|
1595 | <t>, allowing to insert multiple paragraphs into a single list item. |
---|
1596 | |
---|
1597 | 11.25. Extensions to Xml2rfc <rfc> element |
---|
1598 | |
---|
1599 | The extension attributes below are allowed on the standard <rfc> |
---|
1600 | element: |
---|
1601 | |
---|
1602 | o grddl:transformation can be used to reference a GRDDL transform. |
---|
1603 | |
---|
1604 | o x:maturiy-level can be used to specify the IETF Standards Track |
---|
1605 | Maturity Level of "proposed", "draft" or "internet" (see Section |
---|
1606 | 4.1 of [RFC2026]). |
---|
1607 | |
---|
1608 | 11.26. Extensions to Xml2rfc <section> element |
---|
1609 | |
---|
1610 | The extension attribute below is allowed on the standard <list> |
---|
1611 | element: |
---|
1612 | |
---|
1613 | o x:fixed-section-number can be used to specify a fixed section |
---|
1614 | number. This can be useful when formatting historic documents |
---|
1615 | that used a different numbering style. |
---|
1616 | |
---|
1617 | |
---|
1618 | |
---|
1619 | |
---|
1620 | |
---|
1621 | |
---|
1622 | |
---|
1623 | Reschke [Page 29] |
---|
1624 | |
---|
1625 | Documentation RFC2629 through XSLT March 2011 |
---|
1626 | |
---|
1627 | |
---|
1628 | 11.27. Extensions to Xml2rfc <xref> element |
---|
1629 | |
---|
1630 | Three extension attributes are allowed on the standard <xref> |
---|
1631 | element: |
---|
1632 | |
---|
1633 | 1. x:sec can be specified to point to a specific section of the |
---|
1634 | referenced document, |
---|
1635 | |
---|
1636 | 2. x:rel may specify a relative reference to use when linking into |
---|
1637 | the referenced document (if linking by section number is not |
---|
1638 | available), |
---|
1639 | |
---|
1640 | 3. x:fmt defines the text format to be used. |
---|
1641 | |
---|
1642 | The following formats are defined for the x:fmt attribute: |
---|
1643 | |
---|
1644 | , (Comma) [_reference_], Section _sec_ |
---|
1645 | |
---|
1646 | () [_reference_] (Section _sec_) |
---|
1647 | |
---|
1648 | anchor Like the default format, but without brackets. |
---|
1649 | |
---|
1650 | of Section _sec_ of [_reference_] |
---|
1651 | |
---|
1652 | number _sec_ |
---|
1653 | |
---|
1654 | none No output (can be used to have xrefs to references without |
---|
1655 | having them rendered as such) |
---|
1656 | |
---|
1657 | sec Section _sec_ |
---|
1658 | |
---|
1659 | These extensions are currently only supported for <xref> elements |
---|
1660 | without child nodes. |
---|
1661 | |
---|
1662 | If the processor knows how to reference the target section, it will |
---|
1663 | generate a link directly to the target section, such as in [RFC2119], |
---|
1664 | Section 5. |
---|
1665 | |
---|
1666 | |
---|
1667 | |
---|
1668 | |
---|
1669 | |
---|
1670 | |
---|
1671 | |
---|
1672 | |
---|
1673 | |
---|
1674 | |
---|
1675 | |
---|
1676 | |
---|
1677 | |
---|
1678 | |
---|
1679 | Reschke [Page 30] |
---|
1680 | |
---|
1681 | Documentation RFC2629 through XSLT March 2011 |
---|
1682 | |
---|
1683 | |
---|
1684 | 12. Utilities |
---|
1685 | |
---|
1686 | 12.1. Checking References |
---|
1687 | |
---|
1688 | "check-references.xslt" can be used to check all references to RFC- |
---|
1689 | and ID-series IETF publications and to W3C publications (note this |
---|
1690 | script requires local copies of |
---|
1691 | <ftp://ftp.isi.edu/in-notes/rfc-index.xml> and |
---|
1692 | <http://www.w3.org/2002/01/tr-automation/tr.rdf> and will use the XML |
---|
1693 | status information provided at <http://tools.ietf.org/>). |
---|
1694 | |
---|
1695 | If the document is supposed to be published on the IETF standards |
---|
1696 | track, the desired level can be specified using the parameter |
---|
1697 | "intended-level" as 'proposed', 'draft' or 'internet'. |
---|
1698 | Alternatively, it can be specified inside the document using the |
---|
1699 | attribute x:maturity-level on the <rfc> element. |
---|
1700 | |
---|
1701 | Note: Downward references should be annotated using the <annotate> |
---|
1702 | element, containing an <xref> to [BCP97]. |
---|
1703 | |
---|
1704 | When an XSLT 2.0 processor is used, links in the document can be |
---|
1705 | checked as well using the "link-check" paramerer ('yes' or 'no'). |
---|
1706 | Note that this only works for http links to documents of type text/*. |
---|
1707 | |
---|
1708 | |
---|
1709 | |
---|
1710 | |
---|
1711 | |
---|
1712 | |
---|
1713 | |
---|
1714 | |
---|
1715 | |
---|
1716 | |
---|
1717 | |
---|
1718 | |
---|
1719 | |
---|
1720 | |
---|
1721 | |
---|
1722 | |
---|
1723 | |
---|
1724 | |
---|
1725 | |
---|
1726 | |
---|
1727 | |
---|
1728 | |
---|
1729 | |
---|
1730 | |
---|
1731 | |
---|
1732 | |
---|
1733 | |
---|
1734 | |
---|
1735 | Reschke [Page 31] |
---|
1736 | |
---|
1737 | Documentation RFC2629 through XSLT March 2011 |
---|
1738 | |
---|
1739 | |
---|
1740 | For instance, as of 2008-07-12, the script produces for |
---|
1741 | <http://greenbytes.de/tech/webdav/rfc2518.xml>: |
---|
1742 | |
---|
1743 | > saxon rfc2518.xml check-references.xslt intended-status=PROPOSED \ |
---|
1744 | link-check=yes |
---|
1745 | |
---|
1746 | Normative References: |
---|
1747 | ISO-11578: not checked |
---|
1748 | ISO-639: not checked |
---|
1749 | ISO-8601: not checked |
---|
1750 | REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006 |
---|
1751 | REC-xml-names-19990114: [FirstEdition] obsoleted by |
---|
1752 | REC-xml-names-20060816 |
---|
1753 | RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282 |
---|
1754 | RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616 |
---|
1755 | RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617 |
---|
1756 | RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok |
---|
1757 | RFC2141: [PROPOSED STANDARD] ok |
---|
1758 | RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok |
---|
1759 | RFC2396: [DRAFT STANDARD] obsoleted by RFC3986 |
---|
1760 | RFC2279: [DRAFT STANDARD] obsoleted by RFC3629 |
---|
1761 | |
---|
1762 | Informational References: |
---|
1763 | REC-PICS-labels-961031: [REC] ok |
---|
1764 | RFC1807: [INFORMATIONAL] ok |
---|
1765 | RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok |
---|
1766 | RFC2291: [INFORMATIONAL] ok |
---|
1767 | RFC2376: [INFORMATIONAL] obsoleted by RFC3023 |
---|
1768 | RFC2413: [INFORMATIONAL] obsoleted by RFC5013 |
---|
1769 | USMARC: not checked |
---|
1770 | WF: not checked |
---|
1771 | |
---|
1772 | Link Targets |
---|
1773 | <http://www.w3.org/TR/1998/REC-xml-19980210>: ok |
---|
1774 | <http://www.w3.org/TR/1999/REC-xml-names-19990114>: ok |
---|
1775 | <http://www.dlib.org/dlib/july96/lagoze/07lagoze.html>: ok |
---|
1776 | <http://www.w3.org/pub/WWW/TR/REC-PICS-labels-961031.html>: ok |
---|
1777 | |
---|
1778 | Recognized formats in the <seriesInfo> element are: |
---|
1779 | |
---|
1780 | o for RFCs, the name attribute must be "RFC", and the value |
---|
1781 | attribute must be the number of the RFC, |
---|
1782 | |
---|
1783 | o for Internet Drafs, the name attribute must be "ID" or "Internet- |
---|
1784 | Draft", and the value attribute must be the file name of the draft |
---|
1785 | (including the two-digit running number, but excluding a file |
---|
1786 | extension), |
---|
1787 | |
---|
1788 | |
---|
1789 | |
---|
1790 | |
---|
1791 | Reschke [Page 32] |
---|
1792 | |
---|
1793 | Documentation RFC2629 through XSLT March 2011 |
---|
1794 | |
---|
1795 | |
---|
1796 | o for W3C documents, the name attribute must be "W3C", must start |
---|
1797 | with "W3C ", or must start with "World Wide Web Consortium ", and |
---|
1798 | the value attribute must be the "shorthand" name of the |
---|
1799 | specification, such as "REC-xml-19980210". |
---|
1800 | |
---|
1801 | Note: this stylesheet will need network access to check links and |
---|
1802 | status of Internet Drafts. When running a Java-based XSLT engine, |
---|
1803 | you may have to supply Java system properties specifying the HTTP |
---|
1804 | proxy to be used, such as "-Dhttp.proxyHost=hostname |
---|
1805 | -Dhttp.proxyPort=80". |
---|
1806 | |
---|
1807 | 12.2. Generating Graphs from References |
---|
1808 | |
---|
1809 | "gen-reference-graph.xslt" generates a graph of RFC dependencies, |
---|
1810 | using the same base data as in "check-references.xslt" (see |
---|
1811 | Section 12.1). Its output is a "dot" file, to be processed by |
---|
1812 | GraphViz (see <http://www.graphviz.org/>). |
---|
1813 | |
---|
1814 | The picture below shows the RFC dependencies in RFC2629. |
---|
1815 | |
---|
1816 | |
---|
1817 | 12.3. Producing reference entries for books |
---|
1818 | |
---|
1819 | "amazon-asin.xslt" uses the Amazon web services to generate a |
---|
1820 | <reference> element for a given ASIN (ISBN). |
---|
1821 | |
---|
1822 | For instance: |
---|
1823 | |
---|
1824 | <?xml version="1.0" encoding="utf-8"?> |
---|
1825 | <references> |
---|
1826 | <reference target="urn:isbn:0134516591"> |
---|
1827 | <front> |
---|
1828 | <title>Simple Book, The: An Introduction to Internet Management, |
---|
1829 | Revised Second Edition</title> |
---|
1830 | <author surname="Rose" |
---|
1831 | fullname="Marshall T. Rose" initials="M. T. "> |
---|
1832 | <organization/> |
---|
1833 | </author> |
---|
1834 | <author surname="Marshall" |
---|
1835 | fullname="Rose T. Marshall" initials="R. T."> |
---|
1836 | <organization/> |
---|
1837 | </author> |
---|
1838 | <date year="1996" month="March"/> |
---|
1839 | </front> |
---|
1840 | <seriesInfo name="Prentice Hall" value=""/> |
---|
1841 | </reference> |
---|
1842 | </references> |
---|
1843 | |
---|
1844 | |
---|
1845 | |
---|
1846 | |
---|
1847 | Reschke [Page 33] |
---|
1848 | |
---|
1849 | Documentation RFC2629 through XSLT March 2011 |
---|
1850 | |
---|
1851 | |
---|
1852 | Note that the resulting XML usually requires checking, in this case |
---|
1853 | Amazon's database is playing tricks with Marshall's name... |
---|
1854 | |
---|
1855 | 12.4. Down-converting to RFC2629bis DTD |
---|
1856 | |
---|
1857 | "clean-for-DTD.xslt" can be used to down-convert some extensions to a |
---|
1858 | format that is supported by the base xml2rfc distribution. Note that |
---|
1859 | these extensions are experimental (feedback appreciated). |
---|
1860 | |
---|
1861 | The following mappings are done: |
---|
1862 | |
---|
1863 | o <iref> elements inside <artwork> elements are moved in front of |
---|
1864 | the enclosing <figure> element. |
---|
1865 | |
---|
1866 | o <xref> elements inside <artwork> are expanded just like in regular |
---|
1867 | text (that is, the markup is stripped, but the element is replaced |
---|
1868 | by the applicable replacement text). |
---|
1869 | |
---|
1870 | o <x:anchor-alias> elements get stripped. |
---|
1871 | |
---|
1872 | o <x:bcp14> elements get stripped. |
---|
1873 | |
---|
1874 | o <x:bb>, <x:bc> and <x:bt> elements get stripped. |
---|
1875 | |
---|
1876 | o <x:blockquote> elements get converted to indented text (through a |
---|
1877 | <list> element). |
---|
1878 | |
---|
1879 | o <x:dfn> elements get stripped. |
---|
1880 | |
---|
1881 | o <x:h> elements get stripped. |
---|
1882 | |
---|
1883 | o <x:link> elements get stripped. |
---|
1884 | |
---|
1885 | o <x:lt> elements get collapsed into a single <lt> element with |
---|
1886 | added <vspace> added to simulate paragraph breaks. |
---|
1887 | |
---|
1888 | o <x:note> elements get converted to indented text (through a <list> |
---|
1889 | element). |
---|
1890 | |
---|
1891 | o <x:q> elements get stripped, with apostrophes added around the |
---|
1892 | text. |
---|
1893 | |
---|
1894 | o <x:prose> elements are transformed into <seriesInfo> elements |
---|
1895 | (which is an abuse of the element and only a workaround until |
---|
1896 | xml2rfc gets a matching extension). |
---|
1897 | |
---|
1898 | o <x:ref> elements get replaced by <xref> elements, targetting |
---|
1899 | either the anchor or another anchor with matching <x:anchor-alias> |
---|
1900 | |
---|
1901 | |
---|
1902 | |
---|
1903 | Reschke [Page 34] |
---|
1904 | |
---|
1905 | Documentation RFC2629 through XSLT March 2011 |
---|
1906 | |
---|
1907 | |
---|
1908 | child element. |
---|
1909 | |
---|
1910 | 12.5. Extracting artwork |
---|
1911 | |
---|
1912 | With "extract-artwork.xslt", artwork elements named through the |
---|
1913 | "name" attribute can be extracted. This can be used to automatically |
---|
1914 | check their syntax (for instance, when ABNFs appear within a figure |
---|
1915 | element). |
---|
1916 | |
---|
1917 | For instance: |
---|
1918 | saxon rfc3986.xml extract-artwork.xslt name=uri.abnf |
---|
1919 | |
---|
1920 | In addition, artwork of a specific type can be extracted, such as |
---|
1921 | with: |
---|
1922 | saxon rfc3986.xml extract-artwork.xslt type=abnf |
---|
1923 | |
---|
1924 | When extracting by type, artwork elements with a specified name can |
---|
1925 | be excluded; this can be handy when the document uses some kind of |
---|
1926 | schema language, and an appendix contains the collected schema, |
---|
1927 | repeating definitions from earlier on. Example: |
---|
1928 | saxon rfc3986.xml extract-artwork.xslt type=abnf except-name=clschm |
---|
1929 | |
---|
1930 | 12.6. GRRDL |
---|
1931 | |
---|
1932 | "rfc2629grddl.xslt" extracts RDF information. This is experimental |
---|
1933 | work-in-progress. See <http://www.w3.org/TR/grddl/> for more |
---|
1934 | information. |
---|
1935 | |
---|
1936 | |
---|
1937 | |
---|
1938 | |
---|
1939 | |
---|
1940 | |
---|
1941 | |
---|
1942 | |
---|
1943 | |
---|
1944 | |
---|
1945 | |
---|
1946 | |
---|
1947 | |
---|
1948 | |
---|
1949 | |
---|
1950 | |
---|
1951 | |
---|
1952 | |
---|
1953 | |
---|
1954 | |
---|
1955 | |
---|
1956 | |
---|
1957 | |
---|
1958 | |
---|
1959 | Reschke [Page 35] |
---|
1960 | |
---|
1961 | Documentation RFC2629 through XSLT March 2011 |
---|
1962 | |
---|
1963 | |
---|
1964 | 13. Informative References |
---|
1965 | |
---|
1966 | [BCP97] Klensin, J. and S. Hartman, "Handling Normative References |
---|
1967 | to Standards-Track Documents", BCP 97, RFC 4897, |
---|
1968 | June 2007. |
---|
1969 | |
---|
1970 | [DC-HTML] Johnston, P. and A. Powell, "Expressing Dublin Core |
---|
1971 | metadata using HTML/XHTML meta and link elements", Dublin |
---|
1972 | Core Metadata Initiative , August 2008, |
---|
1973 | <http://dublincore.org/documents/2008/08/04/dc-html/>. |
---|
1974 | |
---|
1975 | [HTML] Raggett, D., Hors, A., and I. Jacobs, "HTML 4.01 |
---|
1976 | Specification", W3C REC-html401-19991224, December 1999, |
---|
1977 | <http://www.w3.org/TR/html401/>. |
---|
1978 | |
---|
1979 | [RFC2026] Bradner, S., "The Internet Standards Process -- Revision |
---|
1980 | 3", BCP 9, RFC 2026, October 1996. |
---|
1981 | |
---|
1982 | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate |
---|
1983 | Requirement Levels", BCP 14, RFC 2119, March 1997. |
---|
1984 | |
---|
1985 | [RFC2616] Fielding, R., Gettys, J., Mogul, J., Nielsen, H., |
---|
1986 | Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext |
---|
1987 | Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999. |
---|
1988 | |
---|
1989 | [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, |
---|
1990 | June 1999. |
---|
1991 | |
---|
1992 | [RFC2648] Moats, R., "A URN Namespace for IETF Documents", RFC 2648, |
---|
1993 | August 1999. |
---|
1994 | |
---|
1995 | [RFC2731] Kunze, J., "Encoding Dublin Core Metadata in HTML", |
---|
1996 | RFC 2731, December 1999. |
---|
1997 | |
---|
1998 | [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax |
---|
1999 | Specifications: ABNF", STD 68, RFC 5234, January 2008. |
---|
2000 | |
---|
2001 | [RFC5741] Daigle, L. and O. Kolkman, "RFC Streams, Headers, and |
---|
2002 | Boilerplates", RFC 5741, December 2009. |
---|
2003 | |
---|
2004 | [RNC] Clark, J., "RELAX NG Compact Syntax", OASIS , Nov 2002, <h |
---|
2005 | ttp://www.oasis-open.org/committees/relax-ng/ |
---|
2006 | compact-20021121.html>. |
---|
2007 | |
---|
2008 | [XHTML2] Axelsson, J., Birbeck, M., Dubinko, M., Epperson, B., |
---|
2009 | Ishikawa, M., McCarron, S., Navarro, A., and S. Pemberton, |
---|
2010 | "XHTML[TM] 2.0", W3C WD-xhtml2-20060726, July 2006, |
---|
2011 | <http://www.w3.org/TR/xhtml2>. |
---|
2012 | |
---|
2013 | |
---|
2014 | |
---|
2015 | Reschke [Page 36] |
---|
2016 | |
---|
2017 | Documentation RFC2629 through XSLT March 2011 |
---|
2018 | |
---|
2019 | |
---|
2020 | [XML] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E., and |
---|
2021 | F. Yergeau, "Extensible Markup Language (XML) 1.0 (Fifth |
---|
2022 | Edition)", W3C REC-xml-20081126, November 2008, |
---|
2023 | <http://www.w3.org/TR/2008/REC-xml-20081126/>. |
---|
2024 | |
---|
2025 | [XSL-FO] Berglund, A., "Extensible Stylesheet Language (XSL) |
---|
2026 | Version 1.1", W3C REC-xsl11-20061205, Dec 2006, |
---|
2027 | <http://www.w3.org/TR/2006/REC-xsl11-20061205/>. |
---|
2028 | |
---|
2029 | [1] <http://www.exslt.org/exsl/functions/node-set/ |
---|
2030 | exsl.node-set.html> |
---|
2031 | |
---|
2032 | [2] <http://www.microsoft.com/downloads/ |
---|
2033 | details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41> |
---|
2034 | |
---|
2035 | [3] <https://addons.mozilla.org/de/firefox/addon/722> |
---|
2036 | |
---|
2037 | [4] <https://bugzilla.mozilla.org/show_bug.cgi?id=22942> |
---|
2038 | |
---|
2039 | [5] <http://bugzilla.mozilla.org/show_bug.cgi?id=193678> |
---|
2040 | |
---|
2041 | [6] <https://addons.mozilla.org/firefox/2933/> |
---|
2042 | |
---|
2043 | [7] <http://microformats.org/wiki/hcard> |
---|
2044 | |
---|
2045 | [8] <http://www.w3.org/TR/2003/WD-xsl11-20031217/> |
---|
2046 | |
---|
2047 | [9] <http://www.antennahouse.com/> |
---|
2048 | |
---|
2049 | [10] <http://www.antennahouse.com/XSL20/axf-extension.htm> |
---|
2050 | |
---|
2051 | [11] <http://xml.apache.org/fop/> |
---|
2052 | |
---|
2053 | [12] <http://xep.xattic.com/> |
---|
2054 | |
---|
2055 | [13] <http://xep.xattic.com/xep/spec.html> |
---|
2056 | |
---|
2057 | [14] <http://www.thaiopensource.com/relaxng/jing.html> |
---|
2058 | |
---|
2059 | [15] <http://dpcarlisle.blogspot.com/2007/05/ |
---|
2060 | exslt-node-set-function.html> |
---|
2061 | |
---|
2062 | |
---|
2063 | |
---|
2064 | |
---|
2065 | |
---|
2066 | |
---|
2067 | |
---|
2068 | |
---|
2069 | |
---|
2070 | |
---|
2071 | Reschke [Page 37] |
---|
2072 | |
---|
2073 | Documentation RFC2629 through XSLT March 2011 |
---|
2074 | |
---|
2075 | |
---|
2076 | Appendix A. RELAX NG Compact Schema |
---|
2077 | |
---|
2078 | The RelaxNG schema ([RNC]) below can be used to validate input |
---|
2079 | documents (for instance, with Jing [14]). |
---|
2080 | |
---|
2081 | _Note that this is work in progress, and doesn't yet cover all |
---|
2082 | extensions completely._ |
---|
2083 | |
---|
2084 | # WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR. |
---|
2085 | |
---|
2086 | # Define our extension namespace |
---|
2087 | namespace x = "http://purl.org/net/xml2rfc/ext" |
---|
2088 | |
---|
2089 | # Define GRDDL namespace |
---|
2090 | namespace grddl = "http://www.w3.org/2003/g/data-view#" |
---|
2091 | |
---|
2092 | # Define RDF namespace |
---|
2093 | namespace rdf = "http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
---|
2094 | |
---|
2095 | # Include rfc2629bis RNC grammar |
---|
2096 | include "rfc2629.rnc" { |
---|
2097 | |
---|
2098 | # Redefine <artwork> to allow markup |
---|
2099 | artwork = |
---|
2100 | element artwork { |
---|
2101 | attlist.artwork, |
---|
2102 | (TEXT |
---|
2103 | | eref |
---|
2104 | | iref |
---|
2105 | | spanx |
---|
2106 | | xref |
---|
2107 | | x_abnf-char-sequence |
---|
2108 | | x_bb |
---|
2109 | | x_bc |
---|
2110 | | x_bcp14 |
---|
2111 | | x_bt |
---|
2112 | | x_highlight |
---|
2113 | | x_length-of |
---|
2114 | | x_parse-xml |
---|
2115 | | x_ref |
---|
2116 | | x_span |
---|
2117 | | x_x)* |
---|
2118 | } |
---|
2119 | |
---|
2120 | # Redefine <back> to allow boilerplate |
---|
2121 | back = |
---|
2122 | element back { |
---|
2123 | attlist.back, |
---|
2124 | |
---|
2125 | |
---|
2126 | |
---|
2127 | Reschke [Page 38] |
---|
2128 | |
---|
2129 | Documentation RFC2629 through XSLT March 2011 |
---|
2130 | |
---|
2131 | |
---|
2132 | references*, |
---|
2133 | section*, |
---|
2134 | x_boilerplate? |
---|
2135 | } |
---|
2136 | |
---|
2137 | # Redefine <c> to allow our extension elements |
---|
2138 | c = |
---|
2139 | element c { |
---|
2140 | attlist.c, |
---|
2141 | (TEXT |
---|
2142 | | xref |
---|
2143 | | eref |
---|
2144 | | iref |
---|
2145 | | cref |
---|
2146 | | spanx |
---|
2147 | | x_ref)* |
---|
2148 | } |
---|
2149 | |
---|
2150 | # Redefine <cref> to allow more child elements |
---|
2151 | cref = |
---|
2152 | element cref { |
---|
2153 | attlist.cref, |
---|
2154 | (TEXT |
---|
2155 | | eref |
---|
2156 | | xref)* |
---|
2157 | } |
---|
2158 | |
---|
2159 | # Redefine <front> to allow boilerplate |
---|
2160 | front = |
---|
2161 | element front { |
---|
2162 | attlist.front, |
---|
2163 | title, |
---|
2164 | author+, |
---|
2165 | date, |
---|
2166 | area*, |
---|
2167 | workgroup*, |
---|
2168 | keyword*, |
---|
2169 | x_boilerplate?, |
---|
2170 | abstract?, |
---|
2171 | note* |
---|
2172 | } |
---|
2173 | |
---|
2174 | # Redefine <list> element to allow <x:lt> child elements |
---|
2175 | \list = |
---|
2176 | element list { |
---|
2177 | attlist.list, |
---|
2178 | (t+ | x_lt+) |
---|
2179 | } |
---|
2180 | |
---|
2181 | |
---|
2182 | |
---|
2183 | Reschke [Page 39] |
---|
2184 | |
---|
2185 | Documentation RFC2629 through XSLT March 2011 |
---|
2186 | |
---|
2187 | |
---|
2188 | # Redefine <preamble> to allow our extension elements |
---|
2189 | preamble = |
---|
2190 | element preamble { |
---|
2191 | attlist.preamble, |
---|
2192 | (TEXT |
---|
2193 | | xref |
---|
2194 | | eref |
---|
2195 | | iref |
---|
2196 | | cref |
---|
2197 | | spanx |
---|
2198 | | x_anchor-alias)* |
---|
2199 | } |
---|
2200 | |
---|
2201 | # Redefine <postamble> to allow our extension elements |
---|
2202 | postamble = |
---|
2203 | element postamble { |
---|
2204 | attlist.postamble, |
---|
2205 | (TEXT |
---|
2206 | | xref |
---|
2207 | | eref |
---|
2208 | | iref |
---|
2209 | | cref |
---|
2210 | | spanx |
---|
2211 | | x_bcp14)* |
---|
2212 | } |
---|
2213 | |
---|
2214 | # Redefine <reference> to allow our extension elements |
---|
2215 | reference = |
---|
2216 | element reference { |
---|
2217 | attlist.reference, |
---|
2218 | front, |
---|
2219 | seriesInfo*, |
---|
2220 | x_prose? |
---|
2221 | format*, |
---|
2222 | annotation*, |
---|
2223 | x_source? |
---|
2224 | } |
---|
2225 | |
---|
2226 | # Redefine <rfc> to allow our extension elements |
---|
2227 | rfc = |
---|
2228 | element rfc { |
---|
2229 | attlist.rfc, |
---|
2230 | x_link*, |
---|
2231 | x_assign-section-number*, |
---|
2232 | front, |
---|
2233 | middle, |
---|
2234 | back? |
---|
2235 | } |
---|
2236 | |
---|
2237 | |
---|
2238 | |
---|
2239 | Reschke [Page 40] |
---|
2240 | |
---|
2241 | Documentation RFC2629 through XSLT March 2011 |
---|
2242 | |
---|
2243 | |
---|
2244 | # Redefine <section> to allow our extension elements |
---|
2245 | section = |
---|
2246 | element section { |
---|
2247 | attlist.section, |
---|
2248 | (t |
---|
2249 | | figure |
---|
2250 | | texttable |
---|
2251 | | iref |
---|
2252 | | section |
---|
2253 | | x_anchor-alias |
---|
2254 | | x_blockquote |
---|
2255 | | x_include-author |
---|
2256 | | x_note |
---|
2257 | | rdf_Description)* |
---|
2258 | } |
---|
2259 | |
---|
2260 | # Redefine <spanx> to allow some markup |
---|
2261 | spanx = |
---|
2262 | element spanx { |
---|
2263 | attlist.spanx, |
---|
2264 | (TEXT |
---|
2265 | | iref |
---|
2266 | | xref |
---|
2267 | | x_ref)* |
---|
2268 | } |
---|
2269 | |
---|
2270 | # Redefine <t> to allow our extension elements |
---|
2271 | t = |
---|
2272 | element t { |
---|
2273 | attlist.t, |
---|
2274 | (TEXT |
---|
2275 | | \list |
---|
2276 | | figure |
---|
2277 | | xref |
---|
2278 | | eref |
---|
2279 | | iref |
---|
2280 | | cref |
---|
2281 | | spanx |
---|
2282 | | vspace |
---|
2283 | | x_abnf-char-sequence |
---|
2284 | | x_anchor-alias |
---|
2285 | | x_bcp14 |
---|
2286 | | x_dfn |
---|
2287 | | x_h |
---|
2288 | | x_q |
---|
2289 | | x_ref |
---|
2290 | | x_sup)* |
---|
2291 | } |
---|
2292 | |
---|
2293 | |
---|
2294 | |
---|
2295 | Reschke [Page 41] |
---|
2296 | |
---|
2297 | Documentation RFC2629 through XSLT March 2011 |
---|
2298 | |
---|
2299 | |
---|
2300 | } |
---|
2301 | |
---|
2302 | # Allow x:indent-with attribute on <artwork> |
---|
2303 | attlist.artwork &= |
---|
2304 | attribute x:indent-with { ATEXT }? |
---|
2305 | |
---|
2306 | # Allow anchor and x:annotation attributes on <author> |
---|
2307 | attlist.author &= |
---|
2308 | attribute anchor { xsd:ID }?, |
---|
2309 | attribute x:annotation { ATEXT }? |
---|
2310 | |
---|
2311 | # Extend attribute set for <iref> (see Section 11.23) |
---|
2312 | attlist.iref &= |
---|
2313 | attribute x:for-anchor { ATEXT }? |
---|
2314 | |
---|
2315 | # Extend attribute set for <list> (see Section 11.24) |
---|
2316 | attlist.list &= |
---|
2317 | attribute x:indent { ATEXT }? |
---|
2318 | |
---|
2319 | # Extend attribute set for <preamble> |
---|
2320 | attlist.preamble &= |
---|
2321 | attribute anchor { xsd:ID }? |
---|
2322 | |
---|
2323 | # Extend attribute set for <rfc> |
---|
2324 | attlist.rfc &= |
---|
2325 | attribute grddl:transformation { ATEXT }?, |
---|
2326 | attribute x:maturity-level { "proposed" | "draft" | "internet" }? |
---|
2327 | |
---|
2328 | # Extend attribute set for <section> (see Section 11.26) |
---|
2329 | attlist.section &= |
---|
2330 | attribute x:fixed-section-number { ATEXT }? |
---|
2331 | |
---|
2332 | # Allow anchor attribute on <spanx> |
---|
2333 | attlist.spanx &= |
---|
2334 | attribute anchor { xsd:ID }? |
---|
2335 | |
---|
2336 | # Allow x:quotes attribute on <title> |
---|
2337 | attlist.title &= |
---|
2338 | attribute x:quotes { "true" | "false" }? |
---|
2339 | |
---|
2340 | # Allow annotation attribute on <uri> |
---|
2341 | attlist.uri &= |
---|
2342 | attribute x:annotation { ATEXT }? |
---|
2343 | |
---|
2344 | # Extend attribute set for <xref> (see Section 11.27) |
---|
2345 | attlist.xref &= |
---|
2346 | attribute x:fmt { "()" | "," | "anchor" | "of" | "number" | "sec" | |
---|
2347 | "none" }?, |
---|
2348 | |
---|
2349 | |
---|
2350 | |
---|
2351 | Reschke [Page 42] |
---|
2352 | |
---|
2353 | Documentation RFC2629 through XSLT March 2011 |
---|
2354 | |
---|
2355 | |
---|
2356 | attribute x:rel { ATEXT }?, |
---|
2357 | attribute x:sec { ATEXT }? |
---|
2358 | |
---|
2359 | # Conversion to ABNF char sequence (see Section 11.1) |
---|
2360 | x_abnf-char-sequence = |
---|
2361 | element x:abnf-char-sequence { |
---|
2362 | TEXT |
---|
2363 | } |
---|
2364 | |
---|
2365 | # Aliasing of anchors (see Section 11.2) |
---|
2366 | x_anchor-alias = |
---|
2367 | element x:anchor-alias { |
---|
2368 | attribute value { TEXT }, |
---|
2369 | empty |
---|
2370 | } |
---|
2371 | |
---|
2372 | # Including Author information |
---|
2373 | # (experimental) |
---|
2374 | x_include-author = |
---|
2375 | element x:include-author { |
---|
2376 | attribute target { xsd:IDREF } |
---|
2377 | } |
---|
2378 | |
---|
2379 | # Setting section numbers for internally generated sections |
---|
2380 | # (experimental) |
---|
2381 | x_assign-section-number = |
---|
2382 | element x:assign-section-number { |
---|
2383 | attribute builtin-target { "authors" }, |
---|
2384 | attribute number { TEXT }, |
---|
2385 | empty |
---|
2386 | } |
---|
2387 | |
---|
2388 | # Bottom line of box drawing (see Section 11.4) |
---|
2389 | x_bb = |
---|
2390 | element x:bb { |
---|
2391 | (TEXT |
---|
2392 | | iref |
---|
2393 | | xref |
---|
2394 | | x_bb |
---|
2395 | | x_bc |
---|
2396 | | x_bt |
---|
2397 | | x_ref)* |
---|
2398 | } |
---|
2399 | |
---|
2400 | # Center line of box drawing (see Section 11.5) |
---|
2401 | x_bc = |
---|
2402 | element x:bc { |
---|
2403 | (TEXT |
---|
2404 | |
---|
2405 | |
---|
2406 | |
---|
2407 | Reschke [Page 43] |
---|
2408 | |
---|
2409 | Documentation RFC2629 through XSLT March 2011 |
---|
2410 | |
---|
2411 | |
---|
2412 | | iref |
---|
2413 | | spanx |
---|
2414 | | xref |
---|
2415 | | x_bb |
---|
2416 | | x_bc |
---|
2417 | | x_bt |
---|
2418 | | x_ref)* |
---|
2419 | } |
---|
2420 | |
---|
2421 | # BCP14/RFC2119 keywords (see Section 11.3) |
---|
2422 | x_bcp14 = |
---|
2423 | element x:bcp14 { |
---|
2424 | "MAY" |
---|
2425 | | "MUST" |
---|
2426 | | "MUST NOT" |
---|
2427 | | "NOT RECOMMENDED" |
---|
2428 | | "OPTIONAL" |
---|
2429 | | "RECOMMENDED" |
---|
2430 | | "REQUIRED" |
---|
2431 | | "SHALL" |
---|
2432 | | "SHALL NOT" |
---|
2433 | | "SHOULD" |
---|
2434 | | "SHOULD NOT" |
---|
2435 | } |
---|
2436 | |
---|
2437 | # Blockquote (see Section 11.6) |
---|
2438 | x_blockquote = |
---|
2439 | element x:blockquote { |
---|
2440 | attribute cite { URI }?, |
---|
2441 | t+ |
---|
2442 | } |
---|
2443 | |
---|
2444 | # Boilerplate (see Section 11.6) |
---|
2445 | x_boilerplate = |
---|
2446 | element x:boilerplate { |
---|
2447 | section+ |
---|
2448 | } |
---|
2449 | |
---|
2450 | # Top line of box drawing (see Section 11.8) |
---|
2451 | x_bt = |
---|
2452 | element x:bt { |
---|
2453 | (TEXT |
---|
2454 | | iref |
---|
2455 | | xref |
---|
2456 | | x_bb |
---|
2457 | | x_bc |
---|
2458 | | x_bt |
---|
2459 | | x_ref)* |
---|
2460 | |
---|
2461 | |
---|
2462 | |
---|
2463 | Reschke [Page 44] |
---|
2464 | |
---|
2465 | Documentation RFC2629 through XSLT March 2011 |
---|
2466 | |
---|
2467 | |
---|
2468 | } |
---|
2469 | |
---|
2470 | # Definition (see Section 11.9) |
---|
2471 | x_dfn = |
---|
2472 | element x:dfn { |
---|
2473 | attribute anchor { xsd:ID }?, |
---|
2474 | (TEXT |
---|
2475 | | iref)* |
---|
2476 | } |
---|
2477 | |
---|
2478 | # Heading (see Section 11.10) |
---|
2479 | x_h = |
---|
2480 | element x:h { |
---|
2481 | TEXT |
---|
2482 | } |
---|
2483 | |
---|
2484 | # Heading (see Section 11.11) |
---|
2485 | x_highlight = |
---|
2486 | element x:highlight { |
---|
2487 | TEXT |
---|
2488 | } |
---|
2489 | |
---|
2490 | # Length Measurement (see Section 11.12) |
---|
2491 | x_length-of = |
---|
2492 | element x:length-of { |
---|
2493 | attribute indented { NUMBER }?, |
---|
2494 | attribute target { xsd:IDREF }, |
---|
2495 | empty |
---|
2496 | } |
---|
2497 | |
---|
2498 | # Link (see Section 11.13) |
---|
2499 | x_link = |
---|
2500 | element x:link { |
---|
2501 | attribute href { URI }, |
---|
2502 | attribute title { TEXT }?, |
---|
2503 | attribute rel { TEXT }, |
---|
2504 | empty |
---|
2505 | } |
---|
2506 | |
---|
2507 | # Extended list item (see Section 11.14) |
---|
2508 | x_lt = |
---|
2509 | element x:lt { |
---|
2510 | attribute anchor { xsd:ID }?, |
---|
2511 | attribute hangText { TEXT }?, |
---|
2512 | t+ |
---|
2513 | } |
---|
2514 | |
---|
2515 | # Note (see Section 11.15) |
---|
2516 | |
---|
2517 | |
---|
2518 | |
---|
2519 | Reschke [Page 45] |
---|
2520 | |
---|
2521 | Documentation RFC2629 through XSLT March 2011 |
---|
2522 | |
---|
2523 | |
---|
2524 | x_note = |
---|
2525 | element x:note { |
---|
2526 | t+ |
---|
2527 | } |
---|
2528 | |
---|
2529 | # Signal XML content (see Section 11.16) |
---|
2530 | x_parse-xml = |
---|
2531 | element x:parse-xml { |
---|
2532 | (TEXT |
---|
2533 | | xref)* |
---|
2534 | } |
---|
2535 | |
---|
2536 | # Inline prose in a reference (see Section 11.17) |
---|
2537 | x_prose = |
---|
2538 | element x:prose { |
---|
2539 | TEXT |
---|
2540 | } |
---|
2541 | |
---|
2542 | # Inline quote (see Section 11.18) |
---|
2543 | x_q = |
---|
2544 | element x:q { |
---|
2545 | TEXT |
---|
2546 | } |
---|
2547 | |
---|
2548 | # Anchor reference (see Section 11.19) |
---|
2549 | x_ref = |
---|
2550 | element x:ref { |
---|
2551 | attribute anchor { xsd:ID }?, |
---|
2552 | TEXT |
---|
2553 | } |
---|
2554 | |
---|
2555 | # source information (see Section 11.20) |
---|
2556 | x_source = |
---|
2557 | element x:source { |
---|
2558 | attribute basename { ATEXT }?, |
---|
2559 | attribute href { URI }, |
---|
2560 | empty |
---|
2561 | } |
---|
2562 | |
---|
2563 | # superscript (see Section 11.21) |
---|
2564 | x_sup = |
---|
2565 | element x:sup { |
---|
2566 | TEXT |
---|
2567 | } |
---|
2568 | |
---|
2569 | # Inline Span |
---|
2570 | x_span = |
---|
2571 | element x:span { |
---|
2572 | |
---|
2573 | |
---|
2574 | |
---|
2575 | Reschke [Page 46] |
---|
2576 | |
---|
2577 | Documentation RFC2629 through XSLT March 2011 |
---|
2578 | |
---|
2579 | |
---|
2580 | attribute anchor { xsd:ID }?, |
---|
2581 | (TEXT |
---|
2582 | | x_parse-xml)* |
---|
2583 | } |
---|
2584 | |
---|
2585 | # Nop (for alignment in source) |
---|
2586 | x_x = |
---|
2587 | element x:x { |
---|
2588 | empty |
---|
2589 | } |
---|
2590 | |
---|
2591 | # Embed RDF statements |
---|
2592 | rdf_Description = |
---|
2593 | element rdf:Description { |
---|
2594 | rdf_content |
---|
2595 | } |
---|
2596 | |
---|
2597 | rdf_content = |
---|
2598 | ( TEXT | element * { rdf_content })* |
---|
2599 | |
---|
2600 | |
---|
2601 | |
---|
2602 | |
---|
2603 | |
---|
2604 | |
---|
2605 | |
---|
2606 | |
---|
2607 | |
---|
2608 | |
---|
2609 | |
---|
2610 | |
---|
2611 | |
---|
2612 | |
---|
2613 | |
---|
2614 | |
---|
2615 | |
---|
2616 | |
---|
2617 | |
---|
2618 | |
---|
2619 | |
---|
2620 | |
---|
2621 | |
---|
2622 | |
---|
2623 | |
---|
2624 | |
---|
2625 | |
---|
2626 | |
---|
2627 | |
---|
2628 | |
---|
2629 | |
---|
2630 | |
---|
2631 | Reschke [Page 47] |
---|
2632 | |
---|
2633 | Documentation RFC2629 through XSLT March 2011 |
---|
2634 | |
---|
2635 | |
---|
2636 | Appendix B. Implementation Notes |
---|
2637 | |
---|
2638 | B.1. Recognized type attributes for <artwork> element |
---|
2639 | |
---|
2640 | Specific values in the <artwork> element's "type" attribute are |
---|
2641 | recognized and cause a different visual style to be used: |
---|
2642 | |
---|
2643 | +-------------------------------------+-----------------------------+ |
---|
2644 | | Media Type | Comment | |
---|
2645 | +-------------------------------------+-----------------------------+ |
---|
2646 | | abnf | ABNF as per [RFC5234] | |
---|
2647 | | | | |
---|
2648 | | abnf2616 | ABNF as per [RFC2616], | |
---|
2649 | | | Section 2.1 | |
---|
2650 | | | | |
---|
2651 | | application/relax-ng-compact-syntax | Relax NG Compact Syntax as | |
---|
2652 | | | per [RNC] | |
---|
2653 | | | | |
---|
2654 | | application/xml-dtd | XML DTD | |
---|
2655 | | | | |
---|
2656 | | message/http; msgtype="request" | HTTP message, as per | |
---|
2657 | | | [RFC2616], Section 19.1 | |
---|
2658 | | | | |
---|
2659 | | message/http; msgtype="response" | HTTP message, as per | |
---|
2660 | | | [RFC2616], Section 19.1 | |
---|
2661 | +-------------------------------------+-----------------------------+ |
---|
2662 | |
---|
2663 | |
---|
2664 | |
---|
2665 | |
---|
2666 | |
---|
2667 | |
---|
2668 | |
---|
2669 | |
---|
2670 | |
---|
2671 | |
---|
2672 | |
---|
2673 | |
---|
2674 | |
---|
2675 | |
---|
2676 | |
---|
2677 | |
---|
2678 | |
---|
2679 | |
---|
2680 | |
---|
2681 | |
---|
2682 | |
---|
2683 | |
---|
2684 | |
---|
2685 | |
---|
2686 | |
---|
2687 | Reschke [Page 48] |
---|
2688 | |
---|
2689 | Documentation RFC2629 through XSLT March 2011 |
---|
2690 | |
---|
2691 | |
---|
2692 | Appendix C. Examples |
---|
2693 | |
---|
2694 | C.1. Using the 'Internal Subset' |
---|
2695 | |
---|
2696 | The prolog of the XML document can both be used to refer to an |
---|
2697 | external DTD, and also to define internal entities (Section 2.8 of |
---|
2698 | [XML]): |
---|
2699 | |
---|
2700 | <?xml version="1.0"?> |
---|
2701 | <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> |
---|
2702 | |
---|
2703 | <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [ |
---|
2704 | |
---|
2705 | <!-- use "&MAY;" for a BCP 14 "MAY", see Section 11.3 --> |
---|
2706 | <!ENTITY MAY |
---|
2707 | "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY</bcp14>"> |
---|
2708 | |
---|
2709 | <!-- re-declare " " as code point 160 (non-breaking space) --> |
---|
2710 | <!-- you may need this for UAs that do not read external DTDs --> |
---|
2711 | <!ENTITY nbsp |
---|
2712 | " "> |
---|
2713 | |
---|
2714 | <!-- allow later RFC2616 reference using "&rfc2616;" --> |
---|
2715 | <!-- the data will be fetched from xml.resource.org --> |
---|
2716 | <!ENTITY rfc2616 PUBLIC |
---|
2717 | "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml"> |
---|
2718 | |
---|
2719 | <!-- allow a custom reference using "&mydraft;" --> |
---|
2720 | <!-- the data will be fetched from the same location as the |
---|
2721 | source file --> |
---|
2722 | <!ENTITY mydraft PUBLIC "reference.mydraft.xml"> |
---|
2723 | ]> |
---|
2724 | |
---|
2725 | Note: including entities from a remote site will not work in Firefox, |
---|
2726 | see <https://bugzilla.mozilla.org/show_bug.cgi?id=22942>. |
---|
2727 | |
---|
2728 | C.2. Customization |
---|
2729 | |
---|
2730 | The XSLT code can be customized by creating a custom XSLT file that |
---|
2731 | uses <xsl:import> to include the original code, and just overrides |
---|
2732 | particular rules. |
---|
2733 | |
---|
2734 | |
---|
2735 | |
---|
2736 | |
---|
2737 | |
---|
2738 | |
---|
2739 | |
---|
2740 | |
---|
2741 | |
---|
2742 | |
---|
2743 | Reschke [Page 49] |
---|
2744 | |
---|
2745 | Documentation RFC2629 through XSLT March 2011 |
---|
2746 | |
---|
2747 | |
---|
2748 | For instance, the code below overrides several attributes in |
---|
2749 | "rfc2629toFO.xslt", changing the color, spacing and font family for |
---|
2750 | headers. |
---|
2751 | |
---|
2752 | <xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" |
---|
2753 | version="1.0"> |
---|
2754 | |
---|
2755 | <xsl:import href="rfc2629toFO.xslt"/> |
---|
2756 | |
---|
2757 | <xsl:attribute-set name="h1"> |
---|
2758 | <xsl:attribute name="color">darkblue</xsl:attribute> |
---|
2759 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
---|
2760 | <xsl:attribute name="space-before">24pt</xsl:attribute> |
---|
2761 | </xsl:attribute-set> |
---|
2762 | |
---|
2763 | <xsl:attribute-set name="h2"> |
---|
2764 | <xsl:attribute name="color">darkblue</xsl:attribute> |
---|
2765 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
---|
2766 | <xsl:attribute name="space-before">18pt</xsl:attribute> |
---|
2767 | <xsl:attribute name="space-after">3pt</xsl:attribute> |
---|
2768 | </xsl:attribute-set> |
---|
2769 | |
---|
2770 | <xsl:attribute-set name="h3"> |
---|
2771 | <xsl:attribute name="color">darkblue</xsl:attribute> |
---|
2772 | <xsl:attribute name="font-family">sans-serif</xsl:attribute> |
---|
2773 | <xsl:attribute name="space-before">16pt</xsl:attribute> |
---|
2774 | <xsl:attribute name="space-after">2pt</xsl:attribute> |
---|
2775 | </xsl:attribute-set> |
---|
2776 | |
---|
2777 | </xsl:transform> |
---|
2778 | |
---|
2779 | Note: the name for the attribute sets may change in the future as |
---|
2780 | more working is done with respect to customizability. In any |
---|
2781 | case, overriding the settings in a separate file will be easier to |
---|
2782 | maintain. Please contact the author if you find yourself trying |
---|
2783 | to override style definitions that currently do not use attribute |
---|
2784 | sets. |
---|
2785 | |
---|
2786 | Note: the CSS style information used in "rfc2629.xslt" can be |
---|
2787 | overriden in a similar (but less granular) way: just overwrite the |
---|
2788 | template called "insertCss". As for XSL-FO, the class names may |
---|
2789 | change in future. |
---|
2790 | |
---|
2791 | |
---|
2792 | |
---|
2793 | |
---|
2794 | |
---|
2795 | |
---|
2796 | |
---|
2797 | |
---|
2798 | |
---|
2799 | Reschke [Page 50] |
---|
2800 | |
---|
2801 | Documentation RFC2629 through XSLT March 2011 |
---|
2802 | |
---|
2803 | |
---|
2804 | Appendix D. Producing the IETF 'Boilerplate' |
---|
2805 | |
---|
2806 | Various attributes of the "<rfc>" element plus some child elements of |
---|
2807 | "<front>" affect the automatically generated parts of the front page, |
---|
2808 | such as the tabular information at the beginning, the "Status Of This |
---|
2809 | Memo", and the "Copyright Notice". |
---|
2810 | |
---|
2811 | When submitting an Internet Draft, this "boilerplate" is checked by |
---|
2812 | "Idnits" (<http://tools.ietf.org/tools/idnits/>) for compliance with |
---|
2813 | the current Intellectual Property rules, and thus it is important to |
---|
2814 | set the correct values. |
---|
2815 | |
---|
2816 | Furthermore, the RFC Production Center uses RFC2629-based tools to |
---|
2817 | generate the final RFC text, so the more accurate the supplied |
---|
2818 | information is, the less additional work is left, and the risk for |
---|
2819 | errors in producing the final (and immutable!) document is reduced. |
---|
2820 | |
---|
2821 | Note: this only applies to the case when IETF documents are |
---|
2822 | produced. The "private" processing instruction allows to switch |
---|
2823 | off most of the autogeneration logic. |
---|
2824 | |
---|
2825 | D.1. The /rfc/@ipr Attribute |
---|
2826 | |
---|
2827 | As of the time of this writing, this attribute value can take a long |
---|
2828 | list of values. As frequently, this is not the result of a grand |
---|
2829 | plan, but simply for historic reasons. Of these values, only a few |
---|
2830 | are currently in use; all others are supported by the various tools |
---|
2831 | for backwards compatibility with old source files. |
---|
2832 | |
---|
2833 | Note: some variations of the boilerplate are selected based on the |
---|
2834 | document's date; therefore it is important to specify the "year", |
---|
2835 | "month" and "day" attributes of the "<date>" element when |
---|
2836 | archiving the XML source of an Internet Draft on the day of |
---|
2837 | submission. |
---|
2838 | |
---|
2839 | _Disclaimer: THIS ONLY PROVIDES IMPLEMENTATION INFORMATION. IF YOU |
---|
2840 | NEED LEGAL ADVICE, PLEASE CONTACT A LAWYER._ For further information, |
---|
2841 | refer to <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf>. |
---|
2842 | |
---|
2843 | Finally, for the current "Status Of This Memo" text, the |
---|
2844 | "submissionType" attribute determines whether a statement about "Code |
---|
2845 | Components" is inserted (this is the case for the value "IETF", which |
---|
2846 | also happens to be the default). Other values, such as |
---|
2847 | "independent", suppress this part of the text. |
---|
2848 | |
---|
2849 | |
---|
2850 | |
---|
2851 | |
---|
2852 | |
---|
2853 | |
---|
2854 | |
---|
2855 | Reschke [Page 51] |
---|
2856 | |
---|
2857 | Documentation RFC2629 through XSLT March 2011 |
---|
2858 | |
---|
2859 | |
---|
2860 | D.1.1. Current Values: '*trust200902' |
---|
2861 | |
---|
2862 | The name for these values refers to the "TLP" ("IETF TRUST Legal |
---|
2863 | Provisions Relating to IETF Documents"), on effect February 15, 2009 |
---|
2864 | (see <http://trustee.ietf.org/license-info/archive/ |
---|
2865 | IETF-Trust-License-Policy-20090215.pdf>). Updates to this document |
---|
2866 | were published on September 12, 2009 (TLP 3.0, <http:// |
---|
2867 | trustee.ietf.org/license-info/archive/ |
---|
2868 | IETF-Trust-License-Policy-20090912.pdf>) and on December 28, 2009 |
---|
2869 | (TLP 4.0, <http://trustee.ietf.org/license-info/archive/ |
---|
2870 | IETF-Trust-License-Policy-20091228.pdf>), modifying the license for |
---|
2871 | code components. The actual text is located in Section 6 ("Text To |
---|
2872 | Be Included in IETF Documents") of these documents. |
---|
2873 | |
---|
2874 | The tools will automatically produce the "right" text depending on |
---|
2875 | the document's date information (see above): |
---|
2876 | |
---|
2877 | +----+----------------------------------------------------+---------+ |
---|
2878 | | TL | URI | startin | |
---|
2879 | | P | | g with | |
---|
2880 | | | | publica | |
---|
2881 | | | | tion | |
---|
2882 | | | | date | |
---|
2883 | +----+----------------------------------------------------+---------+ |
---|
2884 | | 3. | <http://trustee.ietf.org/license-info/archive/IETF | 2009-11 | |
---|
2885 | | 0 | -Trust-License-Policy-20090912.pdf> | -01 | |
---|
2886 | | | | | |
---|
2887 | | 4. | <http://trustee.ietf.org/license-info/archive/IETF | 2010-04 | |
---|
2888 | | 0 | -Trust-License-Policy-20091228.pdf> | -01 | |
---|
2889 | +----+----------------------------------------------------+---------+ |
---|
2890 | |
---|
2891 | D.1.1.1. trust200902 |
---|
2892 | |
---|
2893 | This should be the default, unless one of the more specific |
---|
2894 | '*trust200902' values is a better fit. It produces the text in |
---|
2895 | Sections 6.a and 6.b of the TLP. |
---|
2896 | |
---|
2897 | D.1.1.2. noModificationTrust200902 |
---|
2898 | |
---|
2899 | This produces the additional text from Section 6.c.i of the TLP: |
---|
2900 | |
---|
2901 | This document may not be modified, and derivative works of it may |
---|
2902 | not be created, except to format it for publication as an RFC or |
---|
2903 | to translate it into languages other than English. |
---|
2904 | |
---|
2905 | |
---|
2906 | |
---|
2907 | |
---|
2908 | |
---|
2909 | |
---|
2910 | |
---|
2911 | Reschke [Page 52] |
---|
2912 | |
---|
2913 | Documentation RFC2629 through XSLT March 2011 |
---|
2914 | |
---|
2915 | |
---|
2916 | D.1.1.3. noDerivativesTrust200902 |
---|
2917 | |
---|
2918 | This produces the additional text from Section 6.c.ii of the TLP: |
---|
2919 | |
---|
2920 | This document may not be modified, and derivative works of it may |
---|
2921 | not be created, and it may not be published except as an Internet- |
---|
2922 | Draft. |
---|
2923 | |
---|
2924 | D.1.1.4. pre5378Trust200902 |
---|
2925 | |
---|
2926 | This produces the additional text from Section 6.c.iii of the TLP, |
---|
2927 | frequently called the "pre-5378 escape clause": |
---|
2928 | |
---|
2929 | This document may contain material from IETF Documents or IETF |
---|
2930 | Contributions published or made publicly available before November |
---|
2931 | 10, 2008. The person(s) controlling the copyright in some of this |
---|
2932 | material may not have granted the IETF Trust the right to allow |
---|
2933 | modifications of such material outside the IETF Standards Process. |
---|
2934 | Without obtaining an adequate license from the person(s) |
---|
2935 | controlling the copyright in such materials, this document may not |
---|
2936 | be modified outside the IETF Standards Process, and derivative |
---|
2937 | works of it may not be created outside the IETF Standards Process, |
---|
2938 | except to format it for publication as an RFC or to translate it |
---|
2939 | into languages other than English. |
---|
2940 | |
---|
2941 | See Section 4 of |
---|
2942 | <http://trustee.ietf.org/docs/IETF-Copyright-FAQ.pdf> for further |
---|
2943 | information about when to use this value. |
---|
2944 | |
---|
2945 | Note: this text appears under "Copyright Notice", unless the |
---|
2946 | document was published before November 2009, in which case it |
---|
2947 | appears under "Status Of This Memo". |
---|
2948 | |
---|
2949 | D.1.2. Historic Values |
---|
2950 | |
---|
2951 | D.1.2.1. Historic Values: '*trust200811' |
---|
2952 | |
---|
2953 | The attribute values "trust200811", "noModificationTrust200811" and |
---|
2954 | "noDerivativesTrust200811" are similar to their "trust200902" |
---|
2955 | counterparts, except that they use text specified in <http:// |
---|
2956 | trustee.ietf.org/license-info/archive/ |
---|
2957 | IETF-Trust-License-Policy_11-10-08.pdf>. |
---|
2958 | |
---|
2959 | D.1.2.2. Historic Values: '*3978' |
---|
2960 | |
---|
2961 | The attribute values "full3978", "noModification3978" and |
---|
2962 | "noDerivatives3978" are similar to their counterparts above, except |
---|
2963 | that they use text specified in RFC 3978 (March 2005). |
---|
2964 | |
---|
2965 | |
---|
2966 | |
---|
2967 | Reschke [Page 53] |
---|
2968 | |
---|
2969 | Documentation RFC2629 through XSLT March 2011 |
---|
2970 | |
---|
2971 | |
---|
2972 | D.1.2.3. Historic Values: '*3667' |
---|
2973 | |
---|
2974 | The attribute values "full3667", "noModification3667" and |
---|
2975 | "noDerivatives3667" are similar to their counterparts above, except |
---|
2976 | that they use text specified in RFC 3667 (February 2004). |
---|
2977 | |
---|
2978 | D.1.2.4. Historic Values: '*2026' |
---|
2979 | |
---|
2980 | The attribute values "full2026" and "noDerivativeWorks2026" are |
---|
2981 | similar to their counterparts above, except that they use text |
---|
2982 | specified in RFC 2026 (October 1996). |
---|
2983 | |
---|
2984 | The special value "none" was also used back then, and denied the IETF |
---|
2985 | any rights beyond publication as Internet Draft. |
---|
2986 | |
---|
2987 | D.2. The /rfc/@category Attribute |
---|
2988 | |
---|
2989 | For RFCs, the "category" determines the "maturity level" (see Section |
---|
2990 | 4 of [RFC2026]). The allowed values are "std" for "Standards Track", |
---|
2991 | "bcp" for "BCP", "info" for "Informational", "exp" for |
---|
2992 | "Experimental", and "historic" for - surprise - "Historic". |
---|
2993 | |
---|
2994 | For Internet Drafts, the category attribute is not needed, but _will_ |
---|
2995 | appear on the front page ("Intended Status"). Supplying this |
---|
2996 | information can be useful, because reviewers may want to know. |
---|
2997 | |
---|
2998 | Note: the Standards Track consists of "Proposed Standard", "Draft |
---|
2999 | Standards", and "Internet Standard". These do not appear in the |
---|
3000 | boilerplate, thus the category attribute doesn't handle them. |
---|
3001 | However, this information can be useful for validity checkers, and |
---|
3002 | thus "rfc2629.xslt" supports an extension attribute for that |
---|
3003 | purpose (see Section 11.25 for details). |
---|
3004 | |
---|
3005 | D.3. The /rfc/@submissionType Attribute |
---|
3006 | |
---|
3007 | The RFC Editor publishes documents from different "document streams", |
---|
3008 | of which the "IETF stream" of course is the most prominent one. |
---|
3009 | Other streams are the "independent stream" (used for things like |
---|
3010 | administrative information or April 1st RFCs), the "IAB stream" |
---|
3011 | (Internet Architecture Board) and the "IRTF stream" (Internet |
---|
3012 | Research Task Force). |
---|
3013 | |
---|
3014 | Not surprisingly, the values for the attribute are "IETF" (the |
---|
3015 | default value), "independent", "IAB", and "IRTF". |
---|
3016 | |
---|
3017 | _The values "IAB" and "IRTF" are supported by rfc2629.xslt, but not |
---|
3018 | yet allowed by the DTD (waiting for release 1.36 of xml2rfc)._ |
---|
3019 | |
---|
3020 | |
---|
3021 | |
---|
3022 | |
---|
3023 | Reschke [Page 54] |
---|
3024 | |
---|
3025 | Documentation RFC2629 through XSLT March 2011 |
---|
3026 | |
---|
3027 | |
---|
3028 | Historically, this did not affect the final appearance of RFCs, |
---|
3029 | except for subtle differences in Copyright notices. Nowadays (as of |
---|
3030 | [RFC5741]), the stream name appears in the first line of the front |
---|
3031 | page, and it also affects the text in the "Status Of This Memo" |
---|
3032 | section. |
---|
3033 | |
---|
3034 | For current documents, setting "submissionType" attribute will have |
---|
3035 | the following effect: |
---|
3036 | |
---|
3037 | o For RFCs, the stream name appears in the upper left corner of the |
---|
3038 | first page (in Internet Drafts, this is either "Network Working |
---|
3039 | Group", or the value of the "<workgroup>" element). |
---|
3040 | |
---|
3041 | o For RFCs, if affects the whole "Status Of This Memo" section (see |
---|
3042 | Section 3.2.2 of [RFC5741]). |
---|
3043 | |
---|
3044 | o For all RFCs and Internet Drafts, it determines whether the |
---|
3045 | "Copyright Notice" mentions the Copyright on Code Components (see |
---|
3046 | TLP, Section "Text To Be Included in IETF Documents"). |
---|
3047 | |
---|
3048 | Note: as of Version 1.35, "xml2rfc" (as opposed to "rfc2629.xslt") |
---|
3049 | does _not_ implement support values other than "IETF" or |
---|
3050 | "independent". |
---|
3051 | |
---|
3052 | D.4. The /rfc/@consensus Attribute |
---|
3053 | |
---|
3054 | _Supported by rfc2629.xslt, but not yet allowed by the DTD (waiting |
---|
3055 | for release 1.36 of xml2rfc)._ |
---|
3056 | |
---|
3057 | For some of the publication streams (see Appendix D.3), the "Status |
---|
3058 | Of This Memo" section depends on whether there was a consensus to |
---|
3059 | publish (again, see Section 3.2.2 of [RFC5741]). |
---|
3060 | |
---|
3061 | The "consensus" attribute ("yes"/"no", defaulting to "yes") can be |
---|
3062 | used to supply this information. The effect for the various streams |
---|
3063 | is: |
---|
3064 | |
---|
3065 | o "independent" and "IAB": none. |
---|
3066 | |
---|
3067 | o "IETF": mention that there was an IETF consensus. |
---|
3068 | |
---|
3069 | o "IRTF": mention that there was a research group consensus (where |
---|
3070 | the name of the research group is extracted from the "<workgroup>" |
---|
3071 | element). |
---|
3072 | |
---|
3073 | |
---|
3074 | |
---|
3075 | |
---|
3076 | |
---|
3077 | |
---|
3078 | |
---|
3079 | Reschke [Page 55] |
---|
3080 | |
---|
3081 | Documentation RFC2629 through XSLT March 2011 |
---|
3082 | |
---|
3083 | |
---|
3084 | D.5. The /rfc/@number Attribute |
---|
3085 | |
---|
3086 | For RFCs, this attribute supplies the RFC number. |
---|
3087 | |
---|
3088 | D.6. The /rfc/@docName Attribute |
---|
3089 | |
---|
3090 | For Internet Drafts, this specifies the draft name (which appears |
---|
3091 | below the title). The file extension is _not_ part of the draft, so |
---|
3092 | in general it should end with the current draft number ("-", plus two |
---|
3093 | digits). |
---|
3094 | |
---|
3095 | Note: "Idnits" (<http://tools.ietf.org/tools/idnits/>) checks the |
---|
3096 | in-document draft name for consistency with the filename of the |
---|
3097 | submitted document. |
---|
3098 | |
---|
3099 | D.7. The /rfc/@obsoletes Attribute |
---|
3100 | |
---|
3101 | The RFC Editor maintains a database |
---|
3102 | (<http://www.rfc-editor.org/rfc.html>) of all RFCs, including |
---|
3103 | information about which one obsoletes which. Upon publication of an |
---|
3104 | RFC, this database is updated from the data on the front page. |
---|
3105 | |
---|
3106 | This attribute takes a list of comma-separated RFC _numbers_. Do |
---|
3107 | _not_ put the string "RFC" here. |
---|
3108 | |
---|
3109 | D.8. The /rfc/@updates Attribute |
---|
3110 | |
---|
3111 | This is like "obsoletes", but for the "updates" relation. |
---|
3112 | |
---|
3113 | |
---|
3114 | |
---|
3115 | |
---|
3116 | |
---|
3117 | |
---|
3118 | |
---|
3119 | |
---|
3120 | |
---|
3121 | |
---|
3122 | |
---|
3123 | |
---|
3124 | |
---|
3125 | |
---|
3126 | |
---|
3127 | |
---|
3128 | |
---|
3129 | |
---|
3130 | |
---|
3131 | |
---|
3132 | |
---|
3133 | |
---|
3134 | |
---|
3135 | Reschke [Page 56] |
---|
3136 | |
---|
3137 | Documentation RFC2629 through XSLT March 2011 |
---|
3138 | |
---|
3139 | |
---|
3140 | Appendix E. License |
---|
3141 | |
---|
3142 | Copyright (c) 2006-2010, Julian Reschke |
---|
3143 | (julian.reschke@greenbytes.de) |
---|
3144 | |
---|
3145 | All rights reserved. |
---|
3146 | |
---|
3147 | Redistribution and use in source and binary forms, with or without |
---|
3148 | modification, are permitted provided that the following conditions |
---|
3149 | are met: |
---|
3150 | |
---|
3151 | o Redistributions of source code must retain the above copyright |
---|
3152 | notice, this list of conditions and the following disclaimer. |
---|
3153 | |
---|
3154 | o Redistributions in binary form must reproduce the above copyright |
---|
3155 | notice, this list of conditions and the following disclaimer in |
---|
3156 | the documentation and/or other materials provided with the |
---|
3157 | distribution. |
---|
3158 | |
---|
3159 | o Neither the name of Julian Reschke nor the names of its |
---|
3160 | contributors may be used to endorse or promote products derived |
---|
3161 | from this software without specific prior written permission. |
---|
3162 | |
---|
3163 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
---|
3164 | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
---|
3165 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
---|
3166 | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
---|
3167 | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
---|
3168 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
---|
3169 | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
---|
3170 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
---|
3171 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
---|
3172 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
---|
3173 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
---|
3174 | |
---|
3175 | |
---|
3176 | |
---|
3177 | |
---|
3178 | |
---|
3179 | |
---|
3180 | |
---|
3181 | |
---|
3182 | |
---|
3183 | |
---|
3184 | |
---|
3185 | |
---|
3186 | |
---|
3187 | |
---|
3188 | |
---|
3189 | |
---|
3190 | |
---|
3191 | Reschke [Page 57] |
---|
3192 | |
---|
3193 | Documentation RFC2629 through XSLT March 2011 |
---|
3194 | |
---|
3195 | |
---|
3196 | Appendix F. Change Logs |
---|
3197 | |
---|
3198 | F.1. Package |
---|
3199 | |
---|
3200 | 2006-01-01 Switch to BSD License. |
---|
3201 | |
---|
3202 | 2007-01-12 Update to xml2rfc v1.33pre2. |
---|
3203 | |
---|
3204 | 2007-03-31 Update to xml2rfc v1.33pre3. |
---|
3205 | |
---|
3206 | 2007-05-01 Add XSLT test cases. |
---|
3207 | |
---|
3208 | 2008-07-18 Experimental support for inlined rdf:Description elements |
---|
3209 | (ignored by the formatter, extracted by rfc2629grddl). |
---|
3210 | |
---|
3211 | 2008-12-04 Update to xml2rfc v1.34pre2. |
---|
3212 | |
---|
3213 | 2009-02-24 Experimental support for February 2009 boilerplate |
---|
3214 | changes, and for the x:boilerplate element. |
---|
3215 | |
---|
3216 | 2009-07-08 Support new boilerplate ordering in RFCs published since |
---|
3217 | July 2009. Fix problems with one-column text tables. |
---|
3218 | |
---|
3219 | 2009-07-19 When possible, calculate the actual Expiry date for |
---|
3220 | Internet Drafts (full date must be available). |
---|
3221 | |
---|
3222 | 2009-08-01 For '$xml2rfc-ext-authors-section='end'", move the index |
---|
3223 | in front of the authors section. |
---|
3224 | |
---|
3225 | 2009-08-04 Consider /rfc/@ipr="pre5378Trust200902" when producing |
---|
3226 | RFCs, not IDs. |
---|
3227 | |
---|
3228 | 2009-08-29 Support alignment for artwork containing images (as |
---|
3229 | opposed to, well, artwork). |
---|
3230 | |
---|
3231 | 2009-09-01 Allow xref in cref (as extension). |
---|
3232 | |
---|
3233 | 2009-09-14 Refactor handling of processing instructions. |
---|
3234 | |
---|
3235 | 2009-09-24 Fix typo in Status Of This Memo, present since November |
---|
3236 | 2008. Fix formatting of iprExtract attribute. Starting with |
---|
3237 | Internet Draft publication dates after 2009-11-30: use new Trust |
---|
3238 | Legal Provisions text; for Internet Drafts: move Abstract up, and |
---|
3239 | move "pre5378" escape clause to the Copyright Notice. Add support |
---|
3240 | for refparent PI. For RFCs: use new TLP text as of September |
---|
3241 | 2009. Incorporate xml2rfc v1.34pre4. |
---|
3242 | |
---|
3243 | |
---|
3244 | |
---|
3245 | |
---|
3246 | |
---|
3247 | Reschke [Page 58] |
---|
3248 | |
---|
3249 | Documentation RFC2629 through XSLT March 2011 |
---|
3250 | |
---|
3251 | |
---|
3252 | 2009-10-06 Starting with Internet Draft publication dates after |
---|
3253 | 2009-10-31: use new Trust Legal Provisions text; for Internet |
---|
3254 | Drafts: move Abstract up, and move "pre5378" escape clause to the |
---|
3255 | Copyright Notice. Incorporate xml2rfc v1.34pre5. |
---|
3256 | |
---|
3257 | 2009-10-27 Upgrade to xml2rfc v1.34. |
---|
3258 | |
---|
3259 | 2010-01-08 For RFC generation (not IDs), experimentally support RFC |
---|
3260 | 5741 headers and boilerplate and Trust Legal Provisions 4.0. |
---|
3261 | |
---|
3262 | 2010-03-31 Upgrade to xml2rfc v1.35. |
---|
3263 | |
---|
3264 | 2010-06-27 Be consistent with xml2rfc.tcl in formatting initials |
---|
3265 | (truncate after the first); see |
---|
3266 | <http://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/10>. |
---|
3267 | |
---|
3268 | 2010-08-31 Experimental support for prose in references. |
---|
3269 | |
---|
3270 | 2011-01-27 Update to xml2rfc v1.36pre1. |
---|
3271 | |
---|
3272 | F.2. amazon-asin.xslt |
---|
3273 | |
---|
3274 | 2003-11-16 Initial release. |
---|
3275 | |
---|
3276 | 2005-04-02 Fix two DTD issues. |
---|
3277 | |
---|
3278 | F.3. check-references.xslt |
---|
3279 | |
---|
3280 | 2003-11-16 Initial release. |
---|
3281 | |
---|
3282 | 2004-05-11 Add document status; print references type. |
---|
3283 | |
---|
3284 | 2005-01-01 Add experimental check for ID status. |
---|
3285 | |
---|
3286 | 2005-04-01 Add fixes from Bill Fenner. |
---|
3287 | |
---|
3288 | 2005-12-03 Add checks against local copy of |
---|
3289 | <http://www.w3.org/2002/01/tr-automation/tr.rdf>. |
---|
3290 | |
---|
3291 | 2006-07-22 Add checks for standards levels. |
---|
3292 | |
---|
3293 | 2006-08-06 "check-ietf-references.xslt" replaced by "check- |
---|
3294 | references.xslt". |
---|
3295 | |
---|
3296 | 2007-01-04 Use information online at <http://tools.ietf.org/> to |
---|
3297 | retrieve Internet-Draft status information. |
---|
3298 | |
---|
3299 | |
---|
3300 | |
---|
3301 | |
---|
3302 | |
---|
3303 | Reschke [Page 59] |
---|
3304 | |
---|
3305 | Documentation RFC2629 through XSLT March 2011 |
---|
3306 | |
---|
3307 | |
---|
3308 | 2007-06-16 Fix bug looking up ref type when inside change markup. |
---|
3309 | |
---|
3310 | 2008-06-14 Enhance output when draft was updated, and then published |
---|
3311 | as RFC. |
---|
3312 | |
---|
3313 | 2008-07-12 Add XSLT2-based link target checking. |
---|
3314 | |
---|
3315 | 2008-08-10 Change keywords for "intended-level" to proposed/draft/ |
---|
3316 | internet, optionally extract intended level from /rfc/@ |
---|
3317 | x:maturity-level attribute. |
---|
3318 | |
---|
3319 | F.4. gen-reference-graph.xslt |
---|
3320 | |
---|
3321 | 2006-09-03 New. |
---|
3322 | |
---|
3323 | 2007-06-07 Use Carlisle method [15] to define exslt:node-set in |
---|
3324 | msxsml (which means that the stylesheet can now be used with MSXML |
---|
3325 | as well). |
---|
3326 | |
---|
3327 | 2007-10-15 Use W3C data from tr.rdf as well (experimental). |
---|
3328 | |
---|
3329 | F.5. rfc2629.xslt |
---|
3330 | |
---|
3331 | 2001-03-28 Code rearranged, generate numbered section anchors for |
---|
3332 | paragraphs (t) as well. Fixes in index handling. |
---|
3333 | |
---|
3334 | 2001-04-12 Moved HTML output into XHTML namespace. |
---|
3335 | |
---|
3336 | 2001-10-02 Fixed default location for RFCs and numbering of section |
---|
3337 | references. Support ?rfc editing processing instruction. |
---|
3338 | |
---|
3339 | 2001-10-07 Made telephone number links active. |
---|
3340 | |
---|
3341 | 2001-10-08 Support for vspace element. |
---|
3342 | |
---|
3343 | 2001-10-09 Experimental support for rfc-issue PI. |
---|
3344 | |
---|
3345 | 2001-11-11 Support rfc private PI. Removed bogus code reporting the |
---|
3346 | WG in the header. |
---|
3347 | |
---|
3348 | 2001-11-11 Support rfc private PI. Removed bogus code reporting the |
---|
3349 | WG in the header. |
---|
3350 | |
---|
3351 | 2001-12-17 Support title attribute on references element |
---|
3352 | |
---|
3353 | |
---|
3354 | |
---|
3355 | |
---|
3356 | |
---|
3357 | |
---|
3358 | |
---|
3359 | Reschke [Page 60] |
---|
3360 | |
---|
3361 | Documentation RFC2629 through XSLT March 2011 |
---|
3362 | |
---|
3363 | |
---|
3364 | 2002-01-05 Support for list/@style="@format" |
---|
3365 | |
---|
3366 | 2002-01-09 Display "closed" RFC issues as deleted |
---|
3367 | |
---|
3368 | 2002-01-14 Experimentally and optionally parse XML encountered in |
---|
3369 | artwork elements (requires MSXSL). |
---|
3370 | |
---|
3371 | 2002-01-27 Some cleanup. Moved RFC issues from PIs into namespaced |
---|
3372 | elements. |
---|
3373 | |
---|
3374 | 2002-01-29 Added support for sortrefs PI. Added support for figure |
---|
3375 | names. |
---|
3376 | |
---|
3377 | 2002-02-07 Highlight parts of artwork which are too wide (72 |
---|
3378 | characters). |
---|
3379 | |
---|
3380 | 2002-02-12 Code rearrangement for static texts. Fixes for section |
---|
3381 | numbering. TOC generation rewritten. |
---|
3382 | |
---|
3383 | 2002-02-15 Support for irefs in sections; support iref @primary=true |
---|
3384 | |
---|
3385 | 2002-03-03 Moved anchor prefix into a constant. Added sanity checks |
---|
3386 | on user anchor names. |
---|
3387 | |
---|
3388 | 2002-03-23 Bugfix in detection of matching org names when creating |
---|
3389 | the header. Fixed sorting in subitems. |
---|
3390 | |
---|
3391 | 2002-04-02 Fix TOC link HTML generation when no TOC is generated |
---|
3392 | (created broken HTML table code). |
---|
3393 | |
---|
3394 | 2002-04-03 Made rendering of references more tolerant re: missing |
---|
3395 | parts. |
---|
3396 | |
---|
3397 | 2002-04-08 Fixed reference numbering when references are split into |
---|
3398 | separate sections. |
---|
3399 | |
---|
3400 | 2002-04-16 Fix default namespace (shouldn't be set for HTML output |
---|
3401 | method). |
---|
3402 | |
---|
3403 | 2002-04-19 Lowercase internal CSS selectors for Mozilla compliance. |
---|
3404 | Do not put TOC into ul element. |
---|
3405 | |
---|
3406 | 2002-04-21 Make numbered list inside numbered lists use alphanumeric |
---|
3407 | numbering. |
---|
3408 | |
---|
3409 | |
---|
3410 | |
---|
3411 | |
---|
3412 | |
---|
3413 | |
---|
3414 | |
---|
3415 | Reschke [Page 61] |
---|
3416 | |
---|
3417 | Documentation RFC2629 through XSLT March 2011 |
---|
3418 | |
---|
3419 | |
---|
3420 | 2002-05-05 Updated issue/editing support. |
---|
3421 | |
---|
3422 | 2002-05-15 Bugfix for section numbering after introduction of ed: |
---|
3423 | replace |
---|
3424 | |
---|
3425 | 2002-06-21 When producing private documents, do not include document |
---|
3426 | status, copyright etc. |
---|
3427 | |
---|
3428 | 2002-07-08 Fix xrefs to Appendices. |
---|
3429 | |
---|
3430 | 2002-07-19 Make artwork lightyellow for easier reading. (fielding) |
---|
3431 | |
---|
3432 | 2002-10-09 Translate references title to anchor name to avoid non- |
---|
3433 | uri characters. (fielding) |
---|
3434 | |
---|
3435 | 2002-10-13 Support for tocdepth PI. |
---|
3436 | |
---|
3437 | 2002-11-03 Added temporariry workaround for Mozilla/Transformiix |
---|
3438 | result tree fragment problem. (search for |
---|
3439 | 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668') |
---|
3440 | |
---|
3441 | 2002-12-25 xref code: attempt to uppercase "section" and "appendix" |
---|
3442 | when at the start of a sentence. |
---|
3443 | |
---|
3444 | 2003-02-02 fixed code for vspace blankLines="0", enhanced display |
---|
3445 | for list with "format" style, got rid of HTML blockquote elements, |
---|
3446 | added support for "hangIndent" |
---|
3447 | |
---|
3448 | 2003-04-10 experimental support for appendix and spanx elements |
---|
3449 | |
---|
3450 | 2003-04-19 fixed counting of list numbers in "format %" styles (one |
---|
3451 | counter per unique format string). Added more spanx styles. |
---|
3452 | |
---|
3453 | 2003-05-02 experimental texttable support |
---|
3454 | |
---|
3455 | 2003-05-02 Make mailto links optional (default = none) (jre: default |
---|
3456 | and PI name changed) (fielding) |
---|
3457 | |
---|
3458 | 2003-05-04 experimental support for HTML link elements; fix default |
---|
3459 | for table header alignment default |
---|
3460 | |
---|
3461 | 2003-05-06 support for "background" PI. |
---|
3462 | |
---|
3463 | 2003-05-11 change %c format to lowercase alphabetic. add support for |
---|
3464 | keyword elements (generate META tag). fix various HTML conformance |
---|
3465 | problems. added experimental support for role attribute. do not |
---|
3466 | number paragraphs in unnumbered sections. update boilerplate |
---|
3467 | texts. support for "iprnotified" PI. bugfix list numbering. strip |
---|
3468 | |
---|
3469 | |
---|
3470 | |
---|
3471 | Reschke [Page 62] |
---|
3472 | |
---|
3473 | Documentation RFC2629 through XSLT March 2011 |
---|
3474 | |
---|
3475 | |
---|
3476 | whitespace when building tel: URIs. |
---|
3477 | |
---|
3478 | 2003-05-12 more conformance fixes (layout moved into CSS, move lists |
---|
3479 | and figures out of para content, do not use tables for list |
---|
3480 | formatting) |
---|
3481 | |
---|
3482 | 2003-05-13 add DC.Creator meta tag, refactoring |
---|
3483 | |
---|
3484 | 2003-05-16 put nbsps between "section" and section number (xref). |
---|
3485 | |
---|
3486 | 2003-05-18 author summary: add missing comma. |
---|
3487 | |
---|
3488 | 2003-06-06 fix index generation bug (transposed characters in key |
---|
3489 | generation). Enhance sentence start detection (xref starting a |
---|
3490 | section was using lowercase "section"). |
---|
3491 | |
---|
3492 | 2003-06-22 exp. support for xref/@format. Add missing support for |
---|
3493 | eref w/o content. exp. support for annotations in reference |
---|
3494 | elements. Code cleanup reference table formatting. |
---|
3495 | |
---|
3496 | 2003-07-09 Another fix for DC.Creator meta tag creation based on |
---|
3497 | RFC2731 |
---|
3498 | |
---|
3499 | 2003-07-24 Fix namespace name for DC.Creator. |
---|
3500 | |
---|
3501 | 2003-08-06 Cleanup node-set support (only use exslt (saxon, xalan, |
---|
3502 | libxslt) extension functions; remove Transformix workarounds that |
---|
3503 | stopped to work in Moz 1.4) |
---|
3504 | |
---|
3505 | 2003-08-09 Generate HTML lang tag. |
---|
3506 | |
---|
3507 | 2003-08-10 Map spanx/verb to HTML "samp" element. Fix author name |
---|
3508 | display in references (reverse surname/initials for last author), |
---|
3509 | add "Ed.". Fix internal bookmark generation. |
---|
3510 | |
---|
3511 | 2003-08-17 Add DCMI dates, identifiers and abstract. Add PI to |
---|
3512 | suppress DCMI generation. Do not add TOC entry to Copyright |
---|
3513 | Statement when there is none. Align RFC2629 PI names and |
---|
3514 | parameter names. Change style for inline URIs generated by eref. |
---|
3515 | Add header and footer support. Enhance CSS paging properties. |
---|
3516 | Support topblock PI. Added hooks for proper XHTML generation |
---|
3517 | through separate XSLT. Enhance warning and error messages. Add |
---|
3518 | support for artwork image display. Table formatting fixes |
---|
3519 | (borders, thead continuation). |
---|
3520 | |
---|
3521 | |
---|
3522 | |
---|
3523 | |
---|
3524 | |
---|
3525 | |
---|
3526 | |
---|
3527 | Reschke [Page 63] |
---|
3528 | |
---|
3529 | Documentation RFC2629 through XSLT March 2011 |
---|
3530 | |
---|
3531 | |
---|
3532 | 2003-08-18 Add workaround for MSXML4 node-set and Mozilla node-set |
---|
3533 | issues (fallback just displays are warning). |
---|
3534 | |
---|
3535 | 2003-10-06 Add workaround for broken pre/ins handling in Mozilla |
---|
3536 | (see <http://bugzilla.mozilla.org/show_bug.cgi?id=204401>). Make |
---|
3537 | use of cite attribute on ed:replace. CSS cleanup. |
---|
3538 | |
---|
3539 | 2003-10-08 Fix minor issue detecting the same org for the header |
---|
3540 | (caused by IE's non-standard whitespace handling). Fix default |
---|
3541 | handling for /rfc/@category. |
---|
3542 | |
---|
3543 | 2003-11-09 Inherit ed:entered-by from ancestor elements. Change CSS |
---|
3544 | color for inserted text to green. Generate issues-list anchor. |
---|
3545 | Do not complain about missing targets when the xref element is |
---|
3546 | below ed:del. Remove code that attempted to distinguish section/ |
---|
3547 | Section when producing links - always use uppercase. Fix date |
---|
3548 | rendering for issue resolutions. |
---|
3549 | |
---|
3550 | 2003-11-29 Fix color values for table backgrounds for issue |
---|
3551 | rendering. Change rendering of issue links to use inline-styles. |
---|
3552 | Add colored issue markers to issues. |
---|
3553 | |
---|
3554 | 2003-12-13 Fix inheritance of ed:entered-by attribute. Display note |
---|
3555 | elements inside change tracking as well. |
---|
3556 | |
---|
3557 | 2004-01-18 When PI compact = 'yes', make most CSS print page breaks |
---|
3558 | conditional. |
---|
3559 | |
---|
3560 | 2004-02-20 Support for RFC3667 IPR changes (xml2rfc 1.22); see <http |
---|
3561 | ://lists.xml.resource.org/pipermail/xml2rfc/2004-February/ |
---|
3562 | 001088.html>. |
---|
3563 | |
---|
3564 | 2004-03-11 Add "(if approved)" to "updates" and "obsoletes" unless |
---|
3565 | the document has an RFC number. |
---|
3566 | |
---|
3567 | 2004-04-01 Fix RFC3667 output, see <http://lists.xml.resource.org/ |
---|
3568 | pipermail/xml2rfc/2004-April/001208.html>. |
---|
3569 | |
---|
3570 | 2004-04-04 Add support for section/top attribute. Move references |
---|
3571 | into plain section container. |
---|
3572 | |
---|
3573 | 2004-04-06 Do not emit identical para anchors for deleted content. |
---|
3574 | |
---|
3575 | 2004-04-14 Fix references TOC generation when there are no |
---|
3576 | references. |
---|
3577 | |
---|
3578 | |
---|
3579 | |
---|
3580 | |
---|
3581 | |
---|
3582 | |
---|
3583 | Reschke [Page 64] |
---|
3584 | |
---|
3585 | Documentation RFC2629 through XSLT March 2011 |
---|
3586 | |
---|
3587 | |
---|
3588 | 2004-04-24 Fix RFC3667 output, see |
---|
3589 | <http://xml.resource.org/pipermail/xml2rfc/2004-April/ |
---|
3590 | 001246.html>. |
---|
3591 | |
---|
3592 | 2004-05-09 Add custom support for generating compound index |
---|
3593 | documents. Add anchors for each Index letter. Add experimental |
---|
3594 | cref support. Fix conditional page breaks before References |
---|
3595 | section. |
---|
3596 | |
---|
3597 | 2004-05-16 Refactor external index generation. |
---|
3598 | |
---|
3599 | 2004-05-20 Rewrite anchor generation for comments. |
---|
3600 | |
---|
3601 | 2004-05-22 Enhance issues rendering (add links to changes). |
---|
3602 | |
---|
3603 | 2004-05-30 Allow single quote as delimiter in processing |
---|
3604 | instructions as well. Move block-level issue pointers to floats. |
---|
3605 | Disable issue pointers for print media. Add "purple numbers". |
---|
3606 | Add hrefs to section headings. Add non-printing index key letter |
---|
3607 | list to start of index. |
---|
3608 | |
---|
3609 | 2004-06-01 Use ¶ instead of # for PNs. |
---|
3610 | |
---|
3611 | 2004-07-18 Add support for list style=letters (thanks Roy F.). Make |
---|
3612 | PNs optional; add new PI. |
---|
3613 | |
---|
3614 | 2004-09-05 Fix index links into unnumbered sections. Bring IPR |
---|
3615 | boilerplate in-line with xml2rfc 1.25. Add experimental CSS3 |
---|
3616 | paged media support. Various HTML fixes. |
---|
3617 | |
---|
3618 | 2004-09-21 Enhance checking of artwork width. |
---|
3619 | |
---|
3620 | 2004-09-26 Add check for unused references. Uppercase letters in |
---|
3621 | list style letters when nested into another list. |
---|
3622 | |
---|
3623 | 2004-10-10 Fix internal change track pointers. |
---|
3624 | |
---|
3625 | 2004-11-01 Allow change tracking on references (as a whole). |
---|
3626 | Rewrite artwork handling so that it allows change tracking inside |
---|
3627 | artwork. Also allow a subset of text markup inside artwork, such |
---|
3628 | as xrefs (note this requires post-processing the source to make it |
---|
3629 | compliant to RFC2629bis). |
---|
3630 | |
---|
3631 | 2004-11-03 Enhanced placement of iref anchors. |
---|
3632 | |
---|
3633 | |
---|
3634 | |
---|
3635 | |
---|
3636 | |
---|
3637 | |
---|
3638 | |
---|
3639 | Reschke [Page 65] |
---|
3640 | |
---|
3641 | Documentation RFC2629 through XSLT March 2011 |
---|
3642 | |
---|
3643 | |
---|
3644 | 2004-11-06 Index: display irefs that appeared (with primary=true) |
---|
3645 | inside artwork elements in a monospaced font. |
---|
3646 | |
---|
3647 | 2004-11-14 Add special code so that changes in section titles can be |
---|
3648 | change-tracked. |
---|
3649 | |
---|
3650 | 2005-01-14 Bugfixes for HtmlToXhtml converter. |
---|
3651 | |
---|
3652 | 2005-01-22 Enhance generation of HTML h* elements (for Mozilla |
---|
3653 | Outliner). |
---|
3654 | |
---|
3655 | 2005-01-31 Put vertical space around top-level TOC entries in TOC. |
---|
3656 | Switch to pt-based CSS. Re-arrange top section. Make hr elements |
---|
3657 | reflect new-page settings in TXT output (compact-PI). Fix page |
---|
3658 | number in footer (CSS print) and add some more experimental |
---|
3659 | support for paged media (tested with Prince 4.1 alpha). Rewrite |
---|
3660 | TOC and Index generation to generate HTML lists. Cleanup id |
---|
3661 | generation for paragraphs. Reduce whitespace in output. Fix |
---|
3662 | vspace implementation. Use right/left dqoutes and copyright sign |
---|
3663 | where appropriate. |
---|
3664 | |
---|
3665 | 2005-02-04 Add <link> element to references section. Fix newly |
---|
3666 | introduced bug in references processing. |
---|
3667 | |
---|
3668 | 2005-02-05 Integrate various fixes/enhancements by Roy Fielding: |
---|
3669 | spelling of "Authors' Addresses", comma setting in references, |
---|
3670 | position of "Authors" section, optionally place authors addresses |
---|
3671 | at end (PI), trailing dots in section numbers, switch to verdana |
---|
3672 | default font in CSS. Add experimental support for centered |
---|
3673 | artwork. |
---|
3674 | |
---|
3675 | 2005-02-09 Fixes in spacing and links of references section titles. |
---|
3676 | Enhance sorting in references when change tracking is in place. |
---|
3677 | Re-add figure centering support. Add missing 2nd part of |
---|
3678 | "Author's Adresses" fix. |
---|
3679 | |
---|
3680 | 2005-02-25 Align section number format with xml2rfc1.29. |
---|
3681 | |
---|
3682 | 2005-03-28 Get rid of table elements in Author's section. Add |
---|
3683 | experimental hCard (<http://developers.technorati.com/wiki/hCard>) |
---|
3684 | support. |
---|
3685 | |
---|
3686 | 2005-04-03 Add RFC3978-style IPR statement support. |
---|
3687 | (fenner@research.att.com) |
---|
3688 | |
---|
3689 | |
---|
3690 | |
---|
3691 | |
---|
3692 | |
---|
3693 | |
---|
3694 | |
---|
3695 | Reschke [Page 66] |
---|
3696 | |
---|
3697 | Documentation RFC2629 through XSLT March 2011 |
---|
3698 | |
---|
3699 | |
---|
3700 | 2005-04-11 Cleanup author display. hCard related fixes. |
---|
3701 | |
---|
3702 | 2005-05-07 Minor fixes to allow change tracking in doc title. Add |
---|
3703 | experimental support for table border styles. CSS cleanup. |
---|
3704 | |
---|
3705 | 2005-06-18 Implement missing support for references to texttables. |
---|
3706 | |
---|
3707 | 2005-09-25 Use (-moz-)column-count when printing the index. |
---|
3708 | |
---|
3709 | 2005-10-04 Report missing element templates with xsl:message. |
---|
3710 | |
---|
3711 | 2005-10-15 Process t/@anchor. |
---|
3712 | |
---|
3713 | 2005-10-23 More workarounds for Mozilla's broken del/ins handling |
---|
3714 | (this time for figures). |
---|
3715 | |
---|
3716 | 2005-10-27 lowercase hCard class names |
---|
3717 | |
---|
3718 | 2005-11-22 Enhance diagnostics for XML-in-artwork extension |
---|
3719 | |
---|
3720 | 2005-11-26 Fix formatting of section numbers for sections inserted |
---|
3721 | into <back>. |
---|
3722 | |
---|
3723 | 2005-12-12 Fix some validity problems when change tracking occured |
---|
3724 | inside lists. |
---|
3725 | |
---|
3726 | 2005-12-18 Add change tracking inside the index. |
---|
3727 | |
---|
3728 | 2006-02-04 Add prev/next links to highlighted changes (change |
---|
3729 | tracking extension). |
---|
3730 | |
---|
3731 | 2006-02-10 Catch errors instantiating MSXML component. |
---|
3732 | |
---|
3733 | 2006-02-11 References: add "work in progress" for Internet Drafts. |
---|
3734 | |
---|
3735 | 2006-02-27 Fix front matter (lowercase Internet-Draft, say "Intended |
---|
3736 | status" for non-RFC documents). Start work on experimental |
---|
3737 | extension for simplified internal links. |
---|
3738 | |
---|
3739 | 2006-03-19 Tweaks to IESG Copyright stuff; support submissionType |
---|
3740 | attribute. Fix duplicate reference anchors in HTML output. |
---|
3741 | Reduce HTML Tidy warnings. Fix reference to normative ASCII |
---|
3742 | version (now requires trailing ".txt"). Tweaks to hCard |
---|
3743 | generation. Started to move non-issue-tracking extensions into |
---|
3744 | namespace "http://purl.org/net/xml2rfc/ext". |
---|
3745 | |
---|
3746 | |
---|
3747 | |
---|
3748 | |
---|
3749 | |
---|
3750 | |
---|
3751 | Reschke [Page 67] |
---|
3752 | |
---|
3753 | Documentation RFC2629 through XSLT March 2011 |
---|
3754 | |
---|
3755 | |
---|
3756 | 2006-03-27 Moved "simple reference" extension into namespace |
---|
3757 | "http://purl.org/net/xml2rfc/ext" and add documentation. HTML |
---|
3758 | conformance enhancements. |
---|
3759 | |
---|
3760 | 2006-04-02 Cleanup special code for automated XHTML XSLT generation. |
---|
3761 | |
---|
3762 | 2006-04-21 Generate <CITE> elements where appropiate. Introduce |
---|
3763 | x:blockquote, x:dfn, x:h and x:q elements. |
---|
3764 | |
---|
3765 | 2006-05-06 Introduce x:bcp14 element. |
---|
3766 | |
---|
3767 | 2006-05-14 Fix content model for x:blockquote. |
---|
3768 | |
---|
3769 | 2006-06-18 Add box drawing support (x:bt, x:bc, x:bb). |
---|
3770 | |
---|
3771 | 2006-06-20 HTML validity fixes (legal chars in anchors in index). |
---|
3772 | |
---|
3773 | 2006-06-24 Reduce leading empty lines in artwork. Move <dt> style |
---|
3774 | info into CSS. |
---|
3775 | |
---|
3776 | 2006-07-14 Fix rendering of multiple street address entries (missing |
---|
3777 | line break). |
---|
3778 | |
---|
3779 | 2006-07-24 Add extension for deep linking into RFCs, do not generate |
---|
3780 | empty list items in TOC output, avoid empty <dt> elements for list |
---|
3781 | items without hangText attribute. |
---|
3782 | |
---|
3783 | 2006-08-01 Allow @anchor on more elements; start work on Relax NG |
---|
3784 | grammar for extensions. Reduce generated style elements (use CSS |
---|
3785 | classes instead). Consistently use "id" instead of "name". |
---|
3786 | Change default target for RFC links to |
---|
3787 | "http://tools.ietf.org/html/rfcNNNN". |
---|
3788 | |
---|
3789 | 2006-08-06 Include appendices defined in <appendix> elements in TOC |
---|
3790 | (please consider them deprecated anyhow!). Generate links to |
---|
3791 | "http://tools.ietf.org/html/draft-*" for Internet Drafts. Replace |
---|
3792 | x:frag by x:rel, allowing any kind of relative reference instead |
---|
3793 | of just fragments. |
---|
3794 | |
---|
3795 | 2006-08-30 Reduce textual differences between HTML output and what |
---|
3796 | xml2rfc produces in TXT output mode (section refs/reference |
---|
3797 | targets). Add small workaround for Opera 9.0.1's problem with |
---|
3798 | node-set(). |
---|
3799 | |
---|
3800 | 2006-10-29 Fix problem generating internal links to change markup |
---|
3801 | within references section. Enhancements when generating numbered |
---|
3802 | references for deleted references. Allow inclusion of references |
---|
3803 | into the index (through include-references-in-index extension). |
---|
3804 | |
---|
3805 | |
---|
3806 | |
---|
3807 | Reschke [Page 68] |
---|
3808 | |
---|
3809 | Documentation RFC2629 through XSLT March 2011 |
---|
3810 | |
---|
3811 | |
---|
3812 | Fix a bug that caused the newer version of the IETF boilerplate to |
---|
3813 | be produced rather than the pre-RFC3667 one. Update to RFC4287 |
---|
3814 | boilerplate. |
---|
3815 | |
---|
3816 | 2006-11-11 Add extension attribute x:for-anchor to <iref> handling. |
---|
3817 | |
---|
3818 | 2006-11-26 Experimental (and limited) support for <x:lt>. |
---|
3819 | |
---|
3820 | 2006-12-04 Fix bugs in processing documents that have both the ipr |
---|
3821 | and the number attribute set on the rfc root element. Add support |
---|
3822 | for x:fmt='none' on xrefs. Add different pre style based on |
---|
3823 | artwork type attributes (experimental). |
---|
3824 | |
---|
3825 | 2006-12-13 Add x:fmt='anchor' for xref elements. |
---|
3826 | |
---|
3827 | 2007-01-07 Fix root template for compatibility for the exslt:node- |
---|
3828 | set implementation in Firefox3. |
---|
3829 | |
---|
3830 | 2007-01-29 Avoid empty table entry in front matter when organization |
---|
3831 | is not specified for an author. |
---|
3832 | |
---|
3833 | 2007-02-10 Allow change tracking in table rows. |
---|
3834 | |
---|
3835 | 2007-03-09 Add hcard profile URI (<http://www.w3.org/2006/03/hcard>) |
---|
3836 | to head element. Add warning for misplaced <t> elements (after |
---|
3837 | section). |
---|
3838 | |
---|
3839 | 2007-03-21 Fix internal linking from reference entries in index for |
---|
3840 | some xref types. Minor CSS tweaks contributed by MTR. Allow |
---|
3841 | turning on text justification through a PI. Improve iref anchor |
---|
3842 | generation to generate less instable anchors. |
---|
3843 | |
---|
3844 | 2007-03-28 Fixes for numbering of ed:inserted references sections. |
---|
3845 | |
---|
3846 | 2007-05-04 Do not generate anchors for edits in deleted sections. |
---|
3847 | Enhance HTML conformance. |
---|
3848 | |
---|
3849 | 2007-05-19 Enhance diagnostics when using Saxon (needs Saxon's "-l" |
---|
3850 | command line parameter to keep line number information). Add |
---|
3851 | warning when symref PI is missing (default will change in the |
---|
3852 | future). Add support for overriding computed section numbers |
---|
3853 | (when formatting historic documents). |
---|
3854 | |
---|
3855 | 2007-06-07 Change default for symrefs PI to "yes" (see change in |
---|
3856 | xml2rfc 1.33pre4). Warn about docName attributes that appear to |
---|
3857 | contain a file extension. |
---|
3858 | |
---|
3859 | |
---|
3860 | |
---|
3861 | |
---|
3862 | |
---|
3863 | Reschke [Page 69] |
---|
3864 | |
---|
3865 | Documentation RFC2629 through XSLT March 2011 |
---|
3866 | |
---|
3867 | |
---|
3868 | 2007-06-26 Workaround author/@initials values without trailing dot, |
---|
3869 | as in xml2rfc.tcl. |
---|
3870 | |
---|
3871 | 2007-07-14 Enhance index generation for references that use @x:sec |
---|
3872 | attribute. |
---|
3873 | |
---|
3874 | 2007-09-09 Fix: sortrefs is a nop when symrefs=no. |
---|
3875 | |
---|
3876 | 2007-10-17 Work in progress: add support for referencing sections in |
---|
3877 | sibling documents by anchor name. |
---|
3878 | |
---|
3879 | 2007-10-17 Work in progress (continued): support for referencing |
---|
3880 | sections in sibling documents by anchor name. |
---|
3881 | |
---|
3882 | 2007-12-31 Emit warning when updating/obsoleting stuff that's not |
---|
3883 | referenced. |
---|
3884 | |
---|
3885 | 2008-02-03 Support xml2rfc-1.33pre5's suppress-title attribute on |
---|
3886 | texttable and figure. |
---|
3887 | |
---|
3888 | 2008-02-06 Extension: allow <eref> below <cref>. |
---|
3889 | |
---|
3890 | 2008-02-17 Extensions: add x:span and x:length-of. |
---|
3891 | |
---|
3892 | 2008-02-20 Add new RFC boilerplate (as changed in 2007-08). |
---|
3893 | |
---|
3894 | 2008-02-27 Improve diagnostics for artwork width problems; add |
---|
3895 | defaulting of publication dates (requires XSLT processor |
---|
3896 | supporting exslt:date, or msxml). |
---|
3897 | |
---|
3898 | 2008-02-29 Enhance CSS for link elements in the front header, update |
---|
3899 | rules for generating "Acknowledgment" statement. |
---|
3900 | |
---|
3901 | 2008-03-01 Use line numbers in diagnostics in Saxon8/9 as well. |
---|
3902 | |
---|
3903 | 2008-03-02 Fix a bug in the logic choosing the boilerplate, |
---|
3904 | resulting in obsolete text being inserted into IDs. |
---|
3905 | |
---|
3906 | 2008-04-01 Add support for superscript element. |
---|
3907 | |
---|
3908 | 2008-06-28 Add sanity checks for email addresses, allow multiple |
---|
3909 | email elements. |
---|
3910 | |
---|
3911 | 2008-07-06 Add x:abnf-char-sequence. |
---|
3912 | |
---|
3913 | |
---|
3914 | |
---|
3915 | |
---|
3916 | |
---|
3917 | |
---|
3918 | |
---|
3919 | Reschke [Page 70] |
---|
3920 | |
---|
3921 | Documentation RFC2629 through XSLT March 2011 |
---|
3922 | |
---|
3923 | |
---|
3924 | 2008-08-21 Add x:note. |
---|
3925 | |
---|
3926 | 2008-09-06 Add experimental support for SVG images. |
---|
3927 | |
---|
3928 | 2008-09-17 Add experimental support for x:author. Fix xref/@ |
---|
3929 | format=none. |
---|
3930 | |
---|
3931 | 2008-10-10 Fix a huge bug, causing text content after an XML comment |
---|
3932 | to be ignored. |
---|
3933 | |
---|
3934 | 2009-02-24 Use table/caption when needed. |
---|
3935 | |
---|
3936 | 2009-03-07 Fix bug that caused text to disappear in the output in |
---|
3937 | presence of processing instructions. |
---|
3938 | |
---|
3939 | 2009-03-12 Make inlined comments bookmarkable. |
---|
3940 | |
---|
3941 | 2009-04-09 Upgrade to DC-HTML from RFC 2731 (affects head/@profile). |
---|
3942 | |
---|
3943 | 2009-07-08 Remove table/@summary in output; the value getting |
---|
3944 | inserted was just repeating stuff that appeared in the preamble. |
---|
3945 | |
---|
3946 | 2009-08-01 Implement table alignment (HTML output only for now). |
---|
3947 | |
---|
3948 | 2009-08-18 Replicate Dublin Core "abstract" metadata into meta/@ |
---|
3949 | name=description (search engines do use it). |
---|
3950 | |
---|
3951 | 2009-09-02 Fix default/left alignment of table columns, remove silly |
---|
3952 | table summmary attributes. |
---|
3953 | |
---|
3954 | 2009-09-24 Support double-sided layout using CSS page:left/right |
---|
3955 | selectors. |
---|
3956 | |
---|
3957 | 2009-11-27 Generate unordered lists instead of broken definition |
---|
3958 | lists for list style empty. |
---|
3959 | |
---|
3960 | F.6. rfc2629toFO.xslt |
---|
3961 | |
---|
3962 | 2003-11-16 Initial release. |
---|
3963 | |
---|
3964 | 2003-11-29 Enhance handling of unknown list styles. |
---|
3965 | |
---|
3966 | 2004-04-04 Update reference section handling. |
---|
3967 | |
---|
3968 | 2004-04-17 Use XSL-WD-1.1-style fo:bookmark and index handling and |
---|
3969 | add postprocessors for existing implementations. Unify PDF info |
---|
3970 | generation by using XEP (postprocessors) will convert. |
---|
3971 | |
---|
3972 | |
---|
3973 | |
---|
3974 | |
---|
3975 | Reschke [Page 71] |
---|
3976 | |
---|
3977 | Documentation RFC2629 through XSLT March 2011 |
---|
3978 | |
---|
3979 | |
---|
3980 | 2004-04-20 Add experimental cref support. |
---|
3981 | |
---|
3982 | 2004-06-14 Set correct index-item defaults. |
---|
3983 | |
---|
3984 | 2004-07-18 Add list style=letters. |
---|
3985 | |
---|
3986 | 2004-09-03 Make URLs in text break where they are allowed to break |
---|
3987 | by inserting zero-width spaces. |
---|
3988 | |
---|
3989 | 2004-09-26 Fix letter-style inside nested lists. |
---|
3990 | |
---|
3991 | 2004-10-31 Update handling of artwork. |
---|
3992 | |
---|
3993 | 2004-11-13 Fix handling of references inside ed:* markup. Fix |
---|
3994 | whitespace handling in artwork. |
---|
3995 | |
---|
3996 | 2004-11-27 Irefs in artwork generate monospaced entries in index. |
---|
3997 | |
---|
3998 | 2005-01-31 Fix TOC generation that was broken after changes in main |
---|
3999 | XSLT. |
---|
4000 | |
---|
4001 | 2005-02-05 Bring in sync with cosmetic changes in rfc2629.xslt. |
---|
4002 | |
---|
4003 | 2005-05-07 Minor fix for change tracking in document title. Support |
---|
4004 | for table styles. |
---|
4005 | |
---|
4006 | 2005-06-18 Fix references to tables. |
---|
4007 | |
---|
4008 | 2005-10-15 Process t/@anchor. |
---|
4009 | |
---|
4010 | 2006-02-11 References: add "work in progress" for Internet Drafts. |
---|
4011 | |
---|
4012 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
4013 | |
---|
4014 | 2007-03-21 Support optional text justification. |
---|
4015 | |
---|
4016 | 2007-05-19 Various improvements in spacing; also allow overriding |
---|
4017 | the automatic list indentation via list/x:indent. |
---|
4018 | |
---|
4019 | 2009-04-08 Fix spacing in headers; add support for formatting for |
---|
4020 | double-sided printing. |
---|
4021 | |
---|
4022 | 2009-08-01 Remove surplus empty pages when not generating double- |
---|
4023 | sided output. |
---|
4024 | |
---|
4025 | |
---|
4026 | |
---|
4027 | |
---|
4028 | |
---|
4029 | |
---|
4030 | |
---|
4031 | Reschke [Page 72] |
---|
4032 | |
---|
4033 | Documentation RFC2629 through XSLT March 2011 |
---|
4034 | |
---|
4035 | |
---|
4036 | F.7. xsl11toAn.xslt |
---|
4037 | |
---|
4038 | 2004-05-17 Initial release. |
---|
4039 | |
---|
4040 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
4041 | |
---|
4042 | F.8. xsl11toFop.xslt |
---|
4043 | |
---|
4044 | 2010-08-25 Switch to Apache FOP 1.0. |
---|
4045 | |
---|
4046 | 2009-09-12 Support for FOP 0.20.5 and FOP 0.93 removed. Please use |
---|
4047 | FOP 0.95. |
---|
4048 | |
---|
4049 | 2008-03-15 Add a workaround to the fo:inline workaround (sigh). |
---|
4050 | |
---|
4051 | F.9. xsl11toXep.xslt |
---|
4052 | |
---|
4053 | 2004-05-17 Initial release. |
---|
4054 | |
---|
4055 | 2004-09-04 Fix xep:index-item attributes. |
---|
4056 | |
---|
4057 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
4058 | |
---|
4059 | |
---|
4060 | |
---|
4061 | |
---|
4062 | |
---|
4063 | |
---|
4064 | |
---|
4065 | |
---|
4066 | |
---|
4067 | |
---|
4068 | |
---|
4069 | |
---|
4070 | |
---|
4071 | |
---|
4072 | |
---|
4073 | |
---|
4074 | |
---|
4075 | |
---|
4076 | |
---|
4077 | |
---|
4078 | |
---|
4079 | |
---|
4080 | |
---|
4081 | |
---|
4082 | |
---|
4083 | |
---|
4084 | |
---|
4085 | |
---|
4086 | |
---|
4087 | Reschke [Page 73] |
---|
4088 | |
---|
4089 | Documentation RFC2629 through XSLT March 2011 |
---|
4090 | |
---|
4091 | |
---|
4092 | Index |
---|
4093 | |
---|
4094 | A |
---|
4095 | abnf-char-sequence Extension Element 24, 38 |
---|
4096 | allow-markup-in-artwork PI pseudo-attribute 9 |
---|
4097 | alternate HTML LINK element 17 |
---|
4098 | anchor-alias Extension Element 24, 38 |
---|
4099 | Anchors |
---|
4100 | rfc.abstract 14 |
---|
4101 | rfc.authors 14 |
---|
4102 | rfc.copyright 14 |
---|
4103 | rfc.copyrightnotice 14 |
---|
4104 | rfc.figure.n 14 |
---|
4105 | rfc.figure.u.n 14 |
---|
4106 | rfc.index 14 |
---|
4107 | rfc.ipr 14 |
---|
4108 | rfc.iref.n 14 |
---|
4109 | rfc.note.n 14 |
---|
4110 | rfc.references 14 |
---|
4111 | rfc.section.n 14 |
---|
4112 | rfc.section.n.p.m 14 |
---|
4113 | rfc.status 14 |
---|
4114 | rfc.toc 14 |
---|
4115 | rfc.xref.name.n 14 |
---|
4116 | AntennaHouse XSL Formatter 21 |
---|
4117 | Apache FOP 21 |
---|
4118 | appendix HTML LINK element 17 |
---|
4119 | assign-section-number Extension Element 38 |
---|
4120 | author HTML LINK element 17 |
---|
4121 | authors-section PI pseudo-attribute 9 |
---|
4122 | |
---|
4123 | B |
---|
4124 | background PI pseudo-attribute 7 |
---|
4125 | bb Extension Element 25, 38 |
---|
4126 | bc Extension Element 25, 38 |
---|
4127 | bcp14 Extension Element 24, 38 |
---|
4128 | blockquote Extension Element 25, 38 |
---|
4129 | boilerplate Extension Element 25, 38 |
---|
4130 | bt Extension Element 26, 38 |
---|
4131 | |
---|
4132 | C |
---|
4133 | chapter HTML LINK element 17 |
---|
4134 | CHM format 20 |
---|
4135 | comments PI pseudo-attribute 7 |
---|
4136 | compact PI pseudo-attribute 7 |
---|
4137 | contents HTML LINK element 17 |
---|
4138 | copyright HTML LINK element 17 |
---|
4139 | Creator DCMI property 18 |
---|
4140 | |
---|
4141 | |
---|
4142 | |
---|
4143 | Reschke [Page 74] |
---|
4144 | |
---|
4145 | Documentation RFC2629 through XSLT March 2011 |
---|
4146 | |
---|
4147 | |
---|
4148 | D |
---|
4149 | Date.Issued DCMI property 18 |
---|
4150 | DCMI properties |
---|
4151 | Creator 18 |
---|
4152 | Date.Issued 18 |
---|
4153 | Description.Abstract 18 |
---|
4154 | Identifier 18 |
---|
4155 | isPartOf 18 |
---|
4156 | Relation.Replaces 18 |
---|
4157 | Description.Abstract DCMI property 18 |
---|
4158 | dfn Extension Element 26, 38 |
---|
4159 | duplex PI pseudo-attribute 9 |
---|
4160 | |
---|
4161 | E |
---|
4162 | editing PI pseudo-attribute 7 |
---|
4163 | Extension Elements |
---|
4164 | abnf-char-sequence 24, 38 |
---|
4165 | anchor-alias 24, 38 |
---|
4166 | assign-section-number 38 |
---|
4167 | bb 25, 38 |
---|
4168 | bc 25, 38 |
---|
4169 | bcp14 24, 38 |
---|
4170 | blockquote 25, 38 |
---|
4171 | boilerplate 25, 38 |
---|
4172 | bt 26, 38 |
---|
4173 | dfn 26, 38 |
---|
4174 | h 26, 38 |
---|
4175 | highlight 26, 38 |
---|
4176 | include-author 38 |
---|
4177 | length-of 26, 38 |
---|
4178 | link 26, 38 |
---|
4179 | lt 27, 38 |
---|
4180 | note 27, 38 |
---|
4181 | parse-xml 27, 38 |
---|
4182 | prose 27, 38 |
---|
4183 | q 27, 38 |
---|
4184 | rdf:Description 38 |
---|
4185 | ref 27, 38 |
---|
4186 | source 28, 38 |
---|
4187 | span 38 |
---|
4188 | sup 28, 38 |
---|
4189 | x 38 |
---|
4190 | |
---|
4191 | F |
---|
4192 | Firefox |
---|
4193 | 1.*/2.* 16 |
---|
4194 | 3.* 15 |
---|
4195 | footer PI pseudo-attribute 7 |
---|
4196 | |
---|
4197 | |
---|
4198 | |
---|
4199 | Reschke [Page 75] |
---|
4200 | |
---|
4201 | Documentation RFC2629 through XSLT March 2011 |
---|
4202 | |
---|
4203 | |
---|
4204 | G |
---|
4205 | generator HTML META element 18 |
---|
4206 | Google Chrome 16 |
---|
4207 | Grammar 38 |
---|
4208 | |
---|
4209 | H |
---|
4210 | h Extension Element 26, 38 |
---|
4211 | header PI pseudo-attribute 7 |
---|
4212 | highlight Extension Element 26, 38 |
---|
4213 | HTML compliance 17 |
---|
4214 | HTML LINK elements |
---|
4215 | alternate 17 |
---|
4216 | appendix 17 |
---|
4217 | author 17 |
---|
4218 | chapter 17 |
---|
4219 | contents 17 |
---|
4220 | copyright 17 |
---|
4221 | index 17 |
---|
4222 | HTML META elements |
---|
4223 | generator 18 |
---|
4224 | keywords 18 |
---|
4225 | |
---|
4226 | I |
---|
4227 | Identifier DCMI property 18 |
---|
4228 | include PI pseudo-attribute 8 |
---|
4229 | include-author Extension Element 38 |
---|
4230 | include-references-in-index PI pseudo-attribute 9 |
---|
4231 | index HTML LINK element 17 |
---|
4232 | inline PI pseudo-attribute 7 |
---|
4233 | Internet Explorer 5.5 15 |
---|
4234 | Internet Explorer 6 15 |
---|
4235 | Internet Explorer 7 15 |
---|
4236 | Internet Explorer 8 15 |
---|
4237 | iprnotified PI pseudo-attribute 7 |
---|
4238 | isPartOf DCMI property 18 |
---|
4239 | |
---|
4240 | J |
---|
4241 | justification PI pseudo-attribute 9 |
---|
4242 | |
---|
4243 | K |
---|
4244 | keywords HTML META element 18 |
---|
4245 | |
---|
4246 | L |
---|
4247 | length-of Extension Element 26, 38 |
---|
4248 | link Extension Element 26, 38 |
---|
4249 | linkmailto PI pseudo-attribute 7 |
---|
4250 | lt Extension Element 27, 38 |
---|
4251 | |
---|
4252 | |
---|
4253 | |
---|
4254 | |
---|
4255 | Reschke [Page 76] |
---|
4256 | |
---|
4257 | Documentation RFC2629 through XSLT March 2011 |
---|
4258 | |
---|
4259 | |
---|
4260 | M |
---|
4261 | Microsoft Help 20 |
---|
4262 | Mozilla 15-16 |
---|
4263 | MSXML3 15 |
---|
4264 | MSXML4 15 |
---|
4265 | |
---|
4266 | N |
---|
4267 | needLines PI pseudo-attribute 8 |
---|
4268 | NoScript 15 |
---|
4269 | note Extension Element 27, 38 |
---|
4270 | |
---|
4271 | O |
---|
4272 | Opera 16 |
---|
4273 | |
---|
4274 | P |
---|
4275 | Parameters |
---|
4276 | xml2rfc-background 7 |
---|
4277 | xml2rfc-comments 7 |
---|
4278 | xml2rfc-compact 7 |
---|
4279 | xml2rfc-editing 7 |
---|
4280 | xml2rfc-ext-allow-markup-in-artwork 9 |
---|
4281 | xml2rfc-ext-authors-section 9 |
---|
4282 | xml2rfc-ext-duplex 9 |
---|
4283 | xml2rfc-ext-include-references-in-index 9 |
---|
4284 | xml2rfc-ext-justification 9 |
---|
4285 | xml2rfc-ext-parse-xml-in-artwork 9 |
---|
4286 | xml2rfc-ext-sec-no-trailing-dots 9 |
---|
4287 | xml2rfc-ext-support-rfc2731 9 |
---|
4288 | xml2rfc-footer 7 |
---|
4289 | xml2rfc-header 7 |
---|
4290 | xml2rfc-inline 7 |
---|
4291 | xml2rfc-iprnotified 7 |
---|
4292 | xml2rfc-linkmailto 7 |
---|
4293 | xml2rfc-private 7 |
---|
4294 | xml2rfc-refparent 7 |
---|
4295 | xml2rfc-rfcedstyle 7 |
---|
4296 | xml2rfc-sortrefs 7 |
---|
4297 | xml2rfc-symrefs 7 |
---|
4298 | xml2rfc-toc 7 |
---|
4299 | xml2rfc-tocdepth 7 |
---|
4300 | xml2rfc-topblock 7 |
---|
4301 | parse-xml Extension Element 27, 38 |
---|
4302 | parse-xml-in-artwork PI pseudo-attribute 9 |
---|
4303 | private PI pseudo-attribute 7, 51 |
---|
4304 | Processing Instruction pseudo attributes |
---|
4305 | allow-markup-in-artwork 9 |
---|
4306 | authors-section 9 |
---|
4307 | background 7 |
---|
4308 | |
---|
4309 | |
---|
4310 | |
---|
4311 | Reschke [Page 77] |
---|
4312 | |
---|
4313 | Documentation RFC2629 through XSLT March 2011 |
---|
4314 | |
---|
4315 | |
---|
4316 | comments 7 |
---|
4317 | compact 7 |
---|
4318 | duplex 9 |
---|
4319 | editing 7 |
---|
4320 | footer 7 |
---|
4321 | header 7 |
---|
4322 | ijustification 9 |
---|
4323 | include 8 |
---|
4324 | include-references-in-index 9 |
---|
4325 | inline 7 |
---|
4326 | iprnotified 7 |
---|
4327 | linkmailto 7 |
---|
4328 | needLines 8 |
---|
4329 | parse-xml-in-artwork 9 |
---|
4330 | private 7, 51 |
---|
4331 | refparent 7 |
---|
4332 | rfcedstyle 7 |
---|
4333 | sec-no-trailing-dots 9 |
---|
4334 | slides 8 |
---|
4335 | sortrefs 7 |
---|
4336 | strict 8 |
---|
4337 | subcompact 8 |
---|
4338 | support-rfc2731 9 |
---|
4339 | symrefs 7 |
---|
4340 | toc 7 |
---|
4341 | tocdepth 7 |
---|
4342 | tocindent 8 |
---|
4343 | tocompact 8 |
---|
4344 | topblock 7 |
---|
4345 | prose Extension Element 27, 38 |
---|
4346 | |
---|
4347 | Q |
---|
4348 | q Extension Element 27, 38 |
---|
4349 | |
---|
4350 | R |
---|
4351 | rdf:Description Extension Element 38 |
---|
4352 | ref Extension Element 27, 38 |
---|
4353 | refparent PI pseudo-attribute 7 |
---|
4354 | Relation.Replaces DCMI property 18 |
---|
4355 | RELAX NG Compact Schema 38 |
---|
4356 | rfc.abstract anchor 14 |
---|
4357 | rfc.authors anchor 14 |
---|
4358 | rfc.copyright anchor 14 |
---|
4359 | rfc.copyrightnotice anchor 14 |
---|
4360 | rfc.figure.n anchor 14 |
---|
4361 | rfc.figure.u.n anchor 14 |
---|
4362 | rfc.index anchor 14 |
---|
4363 | rfc.ipr anchor 14 |
---|
4364 | |
---|
4365 | |
---|
4366 | |
---|
4367 | Reschke [Page 78] |
---|
4368 | |
---|
4369 | Documentation RFC2629 through XSLT March 2011 |
---|
4370 | |
---|
4371 | |
---|
4372 | rfc.iref.n anchor 14 |
---|
4373 | rfc.note.n anchor 14 |
---|
4374 | rfc.references anchor 14 |
---|
4375 | rfc.references.n anchor 14 |
---|
4376 | rfc.section.n anchor 14 |
---|
4377 | rfc.section.n.p.m anchor 14 |
---|
4378 | rfc.status anchor 14 |
---|
4379 | rfc.toc anchor 14 |
---|
4380 | rfc.xref.name.n anchor 14 |
---|
4381 | rfcedstyle PI pseudo-attribute 7 |
---|
4382 | |
---|
4383 | S |
---|
4384 | Safari 15-16 |
---|
4385 | 3.* 15 |
---|
4386 | Saxon 15 |
---|
4387 | Schema 38 |
---|
4388 | sec-no-trailing-dots PI pseudo-attribute 9 |
---|
4389 | slides PI pseudo-attribute 8 |
---|
4390 | sortrefs PI pseudo-attribute 7 |
---|
4391 | source Extension Element 28, 38 |
---|
4392 | span Extension Element 38 |
---|
4393 | strict PI pseudo-attribute 8 |
---|
4394 | subcompact PI pseudo-attribute 8 |
---|
4395 | sup Extension Element 28, 38 |
---|
4396 | support-rfc2731 PI pseudo-attribute 9 |
---|
4397 | symrefs PI pseudo-attribute 7 |
---|
4398 | |
---|
4399 | T |
---|
4400 | toc PI pseudo-attribute 7 |
---|
4401 | tocdepth PI pseudo-attribute 7 |
---|
4402 | tocindent PI pseudo-attribute 8 |
---|
4403 | tocompact PI pseudo-attribute 8 |
---|
4404 | topblock PI pseudo-attribute 7 |
---|
4405 | |
---|
4406 | X |
---|
4407 | x Extension Element 38 |
---|
4408 | Xalan 15 |
---|
4409 | xml-stylesheet PI 17 |
---|
4410 | xml2rfc-background parameter 7 |
---|
4411 | xml2rfc-comments parameter 7 |
---|
4412 | xml2rfc-editing parameter 7 |
---|
4413 | xml2rfc-ext-allow-markup-in-artwork parameter 9 |
---|
4414 | xml2rfc-ext-authors-section parameter 9 |
---|
4415 | xml2rfc-ext-duplex 9 |
---|
4416 | xml2rfc-ext-include-references-in-index parameter 9 |
---|
4417 | xml2rfc-ext-justification parameter 9 |
---|
4418 | xml2rfc-ext-parse-xml-in-artwork parameter 9 |
---|
4419 | xml2rfc-ext-sec-no-trailing-dots parameter 9 |
---|
4420 | |
---|
4421 | |
---|
4422 | |
---|
4423 | Reschke [Page 79] |
---|
4424 | |
---|
4425 | Documentation RFC2629 through XSLT March 2011 |
---|
4426 | |
---|
4427 | |
---|
4428 | xml2rfc-ext-support-rfc2731 parameter 9 |
---|
4429 | xml2rfc-footer parameter 7 |
---|
4430 | xml2rfc-header parameter 7 |
---|
4431 | xml2rfc-inline parameter 7 |
---|
4432 | xml2rfc-iprnotified parameter 7 |
---|
4433 | xml2rfc-linkmailto parameter 7 |
---|
4434 | xml2rfc-private parameter 7 |
---|
4435 | xml2rfc-refparent parameter 7 |
---|
4436 | xml2rfc-rfcedstyle parameter 7 |
---|
4437 | xml2rfc-sortrefs parameter 7 |
---|
4438 | xml2rfc-symrefs parameter 7 |
---|
4439 | xml2rfc-toc parameter 7 |
---|
4440 | xml2rfc-tocdepth parameter 7 |
---|
4441 | xml2rfc-topblock parameter 7 |
---|
4442 | xsltproc 15 |
---|
4443 | passing parameters 6 |
---|
4444 | |
---|
4445 | |
---|
4446 | |
---|
4447 | |
---|
4448 | |
---|
4449 | |
---|
4450 | |
---|
4451 | |
---|
4452 | |
---|
4453 | |
---|
4454 | |
---|
4455 | |
---|
4456 | |
---|
4457 | |
---|
4458 | |
---|
4459 | |
---|
4460 | |
---|
4461 | |
---|
4462 | |
---|
4463 | |
---|
4464 | |
---|
4465 | |
---|
4466 | |
---|
4467 | |
---|
4468 | |
---|
4469 | |
---|
4470 | |
---|
4471 | |
---|
4472 | |
---|
4473 | |
---|
4474 | |
---|
4475 | |
---|
4476 | |
---|
4477 | |
---|
4478 | |
---|
4479 | Reschke [Page 80] |
---|
4480 | |
---|
4481 | Documentation RFC2629 through XSLT March 2011 |
---|
4482 | |
---|
4483 | |
---|
4484 | Author's Address |
---|
4485 | |
---|
4486 | Julian F. Reschke |
---|
4487 | greenbytes GmbH |
---|
4488 | Hafenweg 16 |
---|
4489 | Muenster, NW 48155 |
---|
4490 | Germany |
---|
4491 | |
---|
4492 | Phone: +49 251 2807760 |
---|
4493 | Email: julian.reschke@greenbytes.de |
---|
4494 | URI: http://greenbytes.de/tech/webdav/ |
---|
4495 | |
---|
4496 | |
---|
4497 | |
---|
4498 | |
---|
4499 | |
---|
4500 | |
---|
4501 | |
---|
4502 | |
---|
4503 | |
---|
4504 | |
---|
4505 | |
---|
4506 | |
---|
4507 | |
---|
4508 | |
---|
4509 | |
---|
4510 | |
---|
4511 | |
---|
4512 | |
---|
4513 | |
---|
4514 | |
---|
4515 | |
---|
4516 | |
---|
4517 | |
---|
4518 | |
---|
4519 | |
---|
4520 | |
---|
4521 | |
---|
4522 | |
---|
4523 | |
---|
4524 | |
---|
4525 | |
---|
4526 | |
---|
4527 | |
---|
4528 | |
---|
4529 | |
---|
4530 | |
---|
4531 | |
---|
4532 | |
---|
4533 | |
---|
4534 | |
---|
4535 | Reschke [Page 81] |
---|
4536 | |
---|