1 | |
---|
2 | |
---|
3 | |
---|
4 | RFC2629 through XSLT J. Reschke |
---|
5 | greenbytes |
---|
6 | December 10, 2007 |
---|
7 | |
---|
8 | |
---|
9 | Transforming RFC2629-formatted XML through XSLT |
---|
10 | |
---|
11 | |
---|
12 | Table of Contents |
---|
13 | |
---|
14 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 |
---|
15 | 2. Supported RFC2629 elements . . . . . . . . . . . . . . . . . . 4 |
---|
16 | 2.1. Extension elements . . . . . . . . . . . . . . . . . . . 4 |
---|
17 | 3. Processing Instructions . . . . . . . . . . . . . . . . . . . 5 |
---|
18 | 3.1. Supported xml2rfc-compatible PIs . . . . . . . . . . . . 6 |
---|
19 | 3.2. Unsupported xml2rfc-compatible PIs . . . . . . . . . . . 7 |
---|
20 | 3.3. Extension PIs . . . . . . . . . . . . . . . . . . . . . . 8 |
---|
21 | 4. Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 |
---|
22 | 5. Supported XSLT engines . . . . . . . . . . . . . . . . . . . . 13 |
---|
23 | 5.1. Standalone Engines . . . . . . . . . . . . . . . . . . . 13 |
---|
24 | 5.2. In-Browser Engines . . . . . . . . . . . . . . . . . . . 13 |
---|
25 | 6. Transforming to HTML . . . . . . . . . . . . . . . . . . . . . 15 |
---|
26 | 6.1. HTML compliance . . . . . . . . . . . . . . . . . . . . . 15 |
---|
27 | 6.2. Standard HTML LINK elements . . . . . . . . . . . . . . . 15 |
---|
28 | 6.3. Standard HTML metadata . . . . . . . . . . . . . . . . . 16 |
---|
29 | 6.4. Dublin Core (RFC2731) metadata . . . . . . . . . . . . . 16 |
---|
30 | 6.5. Experimental hCard support . . . . . . . . . . . . . . . 16 |
---|
31 | 7. Transforming to XHTML . . . . . . . . . . . . . . . . . . . . 17 |
---|
32 | 8. Transforming to CHM (Microsoft Compiled Help) . . . . . . . . 18 |
---|
33 | 9. Transforming to PDF via XSL-FO . . . . . . . . . . . . . . . . 19 |
---|
34 | 9.1. Via XSL-FO . . . . . . . . . . . . . . . . . . . . . . . 19 |
---|
35 | 9.1.1. Extension feature matrix . . . . . . . . . . . . . . . 19 |
---|
36 | 9.1.2. Example: producing output for Apache FOP . . . . . . . 20 |
---|
37 | 9.2. Via X(HTML) . . . . . . . . . . . . . . . . . . . . . . . 20 |
---|
38 | 10. Generic Extensions . . . . . . . . . . . . . . . . . . . . . . 21 |
---|
39 | 10.1. <anchor-alias> element . . . . . . . . . . . . . . . . . 21 |
---|
40 | 10.2. <bcp14> element . . . . . . . . . . . . . . . . . . . . . 21 |
---|
41 | 10.3. <bb> element . . . . . . . . . . . . . . . . . . . . . . 21 |
---|
42 | 10.4. <bc> element . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
43 | 10.5. <blockquote> element . . . . . . . . . . . . . . . . . . 22 |
---|
44 | 10.6. <bt> element . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
45 | 10.7. <dfn> element . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
46 | 10.8. <h> element . . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
47 | 10.9. <link> element . . . . . . . . . . . . . . . . . . . . . 22 |
---|
48 | 10.10. <lt> element . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
49 | 10.11. <q> element . . . . . . . . . . . . . . . . . . . . . . . 22 |
---|
50 | 10.12. <ref> element . . . . . . . . . . . . . . . . . . . . . . 23 |
---|
51 | 10.13. <source> element . . . . . . . . . . . . . . . . . . . . 23 |
---|
52 | |
---|
53 | |
---|
54 | |
---|
55 | Reschke [Page 1] |
---|
56 | |
---|
57 | Documentation RFC2629 through XSLT December 2007 |
---|
58 | |
---|
59 | |
---|
60 | 10.14. Extensions to Xml2rfc <iref> element . . . . . . . . . . 24 |
---|
61 | 10.15. Extensions to Xml2rfc <list> element . . . . . . . . . . 24 |
---|
62 | 10.16. Extensions to Xml2rfc <section> element . . . . . . . . . 24 |
---|
63 | 10.17. Extensions to Xml2rfc <xref> element . . . . . . . . . . 24 |
---|
64 | 11. Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . 26 |
---|
65 | 11.1. Checking References . . . . . . . . . . . . . . . . . . . 26 |
---|
66 | 11.2. Generating Graphs from References . . . . . . . . . . . . 27 |
---|
67 | 11.3. Producing reference entries for books . . . . . . . . . . 27 |
---|
68 | 11.4. Down-converting to RFC2629bis DTD . . . . . . . . . . . . 28 |
---|
69 | 11.5. Extracting artwork . . . . . . . . . . . . . . . . . . . 29 |
---|
70 | 11.6. GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 29 |
---|
71 | 12. Informative References . . . . . . . . . . . . . . . . . . . . 30 |
---|
72 | Appendix A. RELAX NG Compact Schema . . . . . . . . . . . . . . . 32 |
---|
73 | Appendix B. Implementation Notes . . . . . . . . . . . . . . . . 39 |
---|
74 | B.1. Recognized type attributes for <artwork> element . . . . 39 |
---|
75 | Appendix C. License . . . . . . . . . . . . . . . . . . . . . . . 40 |
---|
76 | Appendix D. Change Logs . . . . . . . . . . . . . . . . . . . . . 41 |
---|
77 | D.1. Package . . . . . . . . . . . . . . . . . . . . . . . . . 41 |
---|
78 | D.2. amazon-asin.xslt . . . . . . . . . . . . . . . . . . . . 41 |
---|
79 | D.3. check-references.xslt . . . . . . . . . . . . . . . . . . 41 |
---|
80 | D.4. gen-reference-graph.xslt . . . . . . . . . . . . . . . . 41 |
---|
81 | D.5. rfc2629.xslt . . . . . . . . . . . . . . . . . . . . . . 42 |
---|
82 | D.6. rfc2629toFO.xslt . . . . . . . . . . . . . . . . . . . . 52 |
---|
83 | D.7. xsl11toAn.xslt . . . . . . . . . . . . . . . . . . . . . 53 |
---|
84 | D.8. xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 53 |
---|
85 | D.9. xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 53 |
---|
86 | Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 |
---|
87 | Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 61 |
---|
88 | |
---|
89 | |
---|
90 | |
---|
91 | |
---|
92 | |
---|
93 | |
---|
94 | |
---|
95 | |
---|
96 | |
---|
97 | |
---|
98 | |
---|
99 | |
---|
100 | |
---|
101 | |
---|
102 | |
---|
103 | |
---|
104 | |
---|
105 | |
---|
106 | |
---|
107 | |
---|
108 | |
---|
109 | |
---|
110 | |
---|
111 | Reschke [Page 2] |
---|
112 | |
---|
113 | Documentation RFC2629 through XSLT December 2007 |
---|
114 | |
---|
115 | |
---|
116 | 1. Introduction |
---|
117 | |
---|
118 | This document describes a set of XSLT transformations that can be |
---|
119 | used to transform RFC2629-compliant XML (see [RFC2629]) to various |
---|
120 | output formats, such as HTML and PDF. The main topics are |
---|
121 | |
---|
122 | o compliance to the xml2rfc XML element set (Section 2), |
---|
123 | |
---|
124 | o support for xml2rfc processing instructions (Section 3), |
---|
125 | |
---|
126 | o the names of anchor elements generated in HTML and PDF output |
---|
127 | (Section 4), |
---|
128 | |
---|
129 | o various XSLT engines that can be used (Section 5), |
---|
130 | |
---|
131 | o outputting HTML (Section 6) and XHTML (Section 7), |
---|
132 | |
---|
133 | o outputting CHM (Compiled Microsoft Help, Section 8), |
---|
134 | |
---|
135 | o outputting PDF through XSL-FO (Section 9) and |
---|
136 | |
---|
137 | o various utilities (Section 11). |
---|
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 December 2007 |
---|
170 | |
---|
171 | |
---|
172 | 2. Supported RFC2629 elements |
---|
173 | |
---|
174 | "rfc2629.xslt" supports both all RFC2629 grammar elements and the |
---|
175 | extensions implemented in xml2rfc 1.21. |
---|
176 | |
---|
177 | 2.1. Extension elements |
---|
178 | |
---|
179 | In addition, "rfc2629.xslt" supports a set of extension elements, |
---|
180 | using elements and attributes in the namespace |
---|
181 | "http://greenbytes.de/2002/rfcedit". They are used for |
---|
182 | |
---|
183 | o simple issue tracking and change tracking and |
---|
184 | |
---|
185 | o adding additional metadata to the generated documents (such as |
---|
186 | HTML LINK elements to related documents, see Section 6.2). |
---|
187 | |
---|
188 | Note that these extensions are experimental. Please email the author |
---|
189 | in case you're interested in using these extensions. |
---|
190 | |
---|
191 | |
---|
192 | |
---|
193 | |
---|
194 | |
---|
195 | |
---|
196 | |
---|
197 | |
---|
198 | |
---|
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 December 2007 |
---|
226 | |
---|
227 | |
---|
228 | 3. Processing Instructions |
---|
229 | |
---|
230 | All PIs can be set as XSLT parameter as well, overriding any value |
---|
231 | that is found in the source file to be transformed. |
---|
232 | |
---|
233 | Using processing instructions: |
---|
234 | |
---|
235 | <?rfc toc="yes"?> |
---|
236 | <?rfc-ext support-rfc2731="no"?> |
---|
237 | |
---|
238 | Using XSLT parameters (Saxon): |
---|
239 | |
---|
240 | java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \ |
---|
241 | xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html |
---|
242 | |
---|
243 | Using XSLT parameters (xsltproc): |
---|
244 | |
---|
245 | xsltproc --param xml2rfc-toc '"yes"' \ |
---|
246 | --param xml2rfc-ext-support-rfc2731 '"no"' \ |
---|
247 | rfc2629.xslt source.xml > result.html |
---|
248 | |
---|
249 | (note the required quoting of string parameters) |
---|
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 December 2007 |
---|
282 | |
---|
283 | |
---|
284 | 3.1. Supported xml2rfc-compatible PIs |
---|
285 | |
---|
286 | +-------+----------------+--------------------+---------+-----------+ |
---|
287 | | PI | PI | XSLT parameter | default | comment | |
---|
288 | | targe | pseudo-attribu | name | | | |
---|
289 | | t | te | | | | |
---|
290 | +-------+----------------+--------------------+---------+-----------+ |
---|
291 | | rfc | background | xml2rfc-background | (not | | |
---|
292 | | | | | set) | | |
---|
293 | | | | | | | |
---|
294 | | rfc | compact | xml2rfc-compact | "no" | only | |
---|
295 | | | | | | applies | |
---|
296 | | | | | | to HTML | |
---|
297 | | | | | | output | |
---|
298 | | | | | | method | |
---|
299 | | | | | | when | |
---|
300 | | | | | | printing | |
---|
301 | | | | | | | |
---|
302 | | rfc | comments | xml2rfc-comments | (not | | |
---|
303 | | | | | set) | | |
---|
304 | | | | | | | |
---|
305 | | rfc | editing | xml2rfc-editing | "no" | | |
---|
306 | | | | | | | |
---|
307 | | rfc | footer | xml2rfc-footer | (not | | |
---|
308 | | | | | set) | | |
---|
309 | | | | | | | |
---|
310 | | rfc | header | xml2rfc-header | (not | | |
---|
311 | | | | | set) | | |
---|
312 | | | | | | | |
---|
313 | | rfc | inline | xml2rfc-inline | (not | | |
---|
314 | | | | | set) | | |
---|
315 | | | | | | | |
---|
316 | | rfc | iprnotified | xml2rfc-iprnotifie | "no" | | |
---|
317 | | | | d | | | |
---|
318 | | | | | | | |
---|
319 | | rfc | linkmailto | xml2rfc-linkmailto | "yes" | | |
---|
320 | | | | | | | |
---|
321 | | rfc | private | xml2rfc-private | (not | | |
---|
322 | | | | | set) | | |
---|
323 | | | | | | | |
---|
324 | | rfc | sortrefs | xml2rfc-sortrefs | "no" | | |
---|
325 | | | | | | | |
---|
326 | |
---|
327 | |
---|
328 | |
---|
329 | |
---|
330 | |
---|
331 | |
---|
332 | |
---|
333 | |
---|
334 | |
---|
335 | Reschke [Page 6] |
---|
336 | |
---|
337 | Documentation RFC2629 through XSLT December 2007 |
---|
338 | |
---|
339 | |
---|
340 | | rfc | symrefs | xml2rfc-symrefs | "yes" | The | |
---|
341 | | | | | | default | |
---|
342 | | | | | | has | |
---|
343 | | | | | | changed | |
---|
344 | | | | | | from "no" | |
---|
345 | | | | | | to "yes" | |
---|
346 | | | | | | as of | |
---|
347 | | | | | | June 6, | |
---|
348 | | | | | | 2007 and | |
---|
349 | | | | | | xml2rfc | |
---|
350 | | | | | | 1.33pre4. | |
---|
351 | | | | | | | |
---|
352 | | rfc | toc | xml2rfc-toc | "no" | | |
---|
353 | | | | | | | |
---|
354 | | rfc | tocdepth | xml2rfc-tocdepth | 99 | | |
---|
355 | | | | | | | |
---|
356 | | rfc | topblock | xml2rfc-topblock | "yes" | | |
---|
357 | +-------+----------------+--------------------+---------+-----------+ |
---|
358 | |
---|
359 | 3.2. Unsupported xml2rfc-compatible PIs |
---|
360 | |
---|
361 | +----------+------------------+-------------------------------------+ |
---|
362 | | PI | PI | comment | |
---|
363 | | target | pseudo-attribute | | |
---|
364 | +----------+------------------+-------------------------------------+ |
---|
365 | | rfc | include | incompatible with XML/XSLT | |
---|
366 | | | | processing model | |
---|
367 | | | | | |
---|
368 | | rfc | needLines | | |
---|
369 | | | | | |
---|
370 | | rfc | slides | | |
---|
371 | | | | | |
---|
372 | | rfc | strict | | |
---|
373 | | | | | |
---|
374 | | rfc | subcompact | | |
---|
375 | | | | | |
---|
376 | | rfc | tocindent | (defaults to "yes") | |
---|
377 | | | | | |
---|
378 | | rfc | tocompact | | |
---|
379 | +----------+------------------+-------------------------------------+ |
---|
380 | |
---|
381 | |
---|
382 | |
---|
383 | |
---|
384 | |
---|
385 | |
---|
386 | |
---|
387 | |
---|
388 | |
---|
389 | |
---|
390 | |
---|
391 | Reschke [Page 7] |
---|
392 | |
---|
393 | Documentation RFC2629 through XSLT December 2007 |
---|
394 | |
---|
395 | |
---|
396 | 3.3. Extension PIs |
---|
397 | |
---|
398 | +------+-----------------+-----------------------+------+-----------+ |
---|
399 | | PI | PI | XSLT parameter name | defa | descripti | |
---|
400 | | targ | pseudo-attribut | | ult | on | |
---|
401 | | et | e | | | | |
---|
402 | +------+-----------------+-----------------------+------+-----------+ |
---|
403 | | rfc- | allow-markup-in | xml2rfc-allow-markup- | "no" | Enables | |
---|
404 | | ext | -artwork | in-artwork | | support | |
---|
405 | | | | | | for | |
---|
406 | | | | | | specific | |
---|
407 | | | | | | elements | |
---|
408 | | | | | | inside | |
---|
409 | | | | | | abstract | |
---|
410 | | | | | | elements | |
---|
411 | | | | | | (using | |
---|
412 | | | | | | this | |
---|
413 | | | | | | extension | |
---|
414 | | | | | | makes the | |
---|
415 | | | | | | document | |
---|
416 | | | | | | incompati | |
---|
417 | | | | | | ble to | |
---|
418 | | | | | | the | |
---|
419 | | | | | | RFC2629bi | |
---|
420 | | | | | | s DTD; | |
---|
421 | | | | | | see | |
---|
422 | | | | | | descripti | |
---|
423 | | | | | | on of | |
---|
424 | | | | | | conversio | |
---|
425 | | | | | | n XSLT in | |
---|
426 | | | | | | Section 1 | |
---|
427 | | | | | | 1.4). | |
---|
428 | | | | | | | |
---|
429 | |
---|
430 | |
---|
431 | |
---|
432 | |
---|
433 | |
---|
434 | |
---|
435 | |
---|
436 | |
---|
437 | |
---|
438 | |
---|
439 | |
---|
440 | |
---|
441 | |
---|
442 | |
---|
443 | |
---|
444 | |
---|
445 | |
---|
446 | |
---|
447 | Reschke [Page 8] |
---|
448 | |
---|
449 | Documentation RFC2629 through XSLT December 2007 |
---|
450 | |
---|
451 | |
---|
452 | | rfc- | authors-section | xml2rfc-ext-authors-s | | When | |
---|
453 | | ext | | ection | | "end", | |
---|
454 | | | | | | place the | |
---|
455 | | | | | | authors | |
---|
456 | | | | | | section | |
---|
457 | | | | | | at the | |
---|
458 | | | | | | end (just | |
---|
459 | | | | | | before | |
---|
460 | | | | | | the | |
---|
461 | | | | | | copyright | |
---|
462 | | | | | | statement | |
---|
463 | | | | | | s). This | |
---|
464 | | | | | | seems to | |
---|
465 | | | | | | be the | |
---|
466 | | | | | | preferred | |
---|
467 | | | | | | order in | |
---|
468 | | | | | | the | |
---|
469 | | | | | | newest | |
---|
470 | | | | | | RFCs. | |
---|
471 | | | | | | | |
---|
472 | | rfc- | include-referen | xml2rfc-ext-include-r | | When set | |
---|
473 | | ext | ces-in-index | eferences-in-index | | to "yes", | |
---|
474 | | | | | | index | |
---|
475 | | | | | | entries | |
---|
476 | | | | | | are | |
---|
477 | | | | | | generated | |
---|
478 | | | | | | for all | |
---|
479 | | | | | | reference | |
---|
480 | | | | | | s. | |
---|
481 | | | | | | | |
---|
482 | | rfc- | justification | xml2rfc-ext-justifica | "nev | "never": | |
---|
483 | | ext | | tion | er" | never | |
---|
484 | | | | | | emit | |
---|
485 | | | | | | justified | |
---|
486 | | | | | | text, | |
---|
487 | | | | | | "always": | |
---|
488 | | | | | | always | |
---|
489 | | | | | | emit | |
---|
490 | | | | | | justified | |
---|
491 | | | | | | text, | |
---|
492 | | | | | | "print": | |
---|
493 | | | | | | only emit | |
---|
494 | | | | | | justified | |
---|
495 | | | | | | text for | |
---|
496 | | | | | | print | |
---|
497 | | | | | | media. | |
---|
498 | | | | | | | |
---|
499 | |
---|
500 | |
---|
501 | |
---|
502 | |
---|
503 | Reschke [Page 9] |
---|
504 | |
---|
505 | Documentation RFC2629 through XSLT December 2007 |
---|
506 | |
---|
507 | |
---|
508 | | rfc- | parse-xml-in-ar | xml2rfc-parse-xml-in- | "no" | May be | |
---|
509 | | ext | twork | artwork | | used to | |
---|
510 | | | | | | enable | |
---|
511 | | | | | | parsing | |
---|
512 | | | | | | of XML | |
---|
513 | | | | | | content | |
---|
514 | | | | | | in | |
---|
515 | | | | | | figures | |
---|
516 | | | | | | (MSXML | |
---|
517 | | | | | | only). | |
---|
518 | | | | | | | |
---|
519 | | rfc- | support-rfc2731 | xml2rfc-ext-support-r | "yes | Decides | |
---|
520 | | ext | | fc2731 | " | whether | |
---|
521 | | | | | | the HTML | |
---|
522 | | | | | | transform | |
---|
523 | | | | | | ation | |
---|
524 | | | | | | should | |
---|
525 | | | | | | generate | |
---|
526 | | | | | | META tags | |
---|
527 | | | | | | according | |
---|
528 | | | | | | Section 6 | |
---|
529 | | | | | | .4. | |
---|
530 | | | | | | | |
---|
531 | | rfc- | sec-no-trailing | xml2rfc-ext-sec-no-tr | | When set | |
---|
532 | | ext | -dots | ailing-dots | | to "yes", | |
---|
533 | | | | | | add | |
---|
534 | | | | | | trailing | |
---|
535 | | | | | | dots to | |
---|
536 | | | | | | section | |
---|
537 | | | | | | numbers. | |
---|
538 | | | | | | This | |
---|
539 | | | | | | seems to | |
---|
540 | | | | | | be the | |
---|
541 | | | | | | preferred | |
---|
542 | | | | | | format in | |
---|
543 | | | | | | the | |
---|
544 | | | | | | newest | |
---|
545 | | | | | | RFCs. | |
---|
546 | +------+-----------------+-----------------------+------+-----------+ |
---|
547 | |
---|
548 | |
---|
549 | |
---|
550 | |
---|
551 | |
---|
552 | |
---|
553 | |
---|
554 | |
---|
555 | |
---|
556 | |
---|
557 | |
---|
558 | |
---|
559 | Reschke [Page 10] |
---|
560 | |
---|
561 | Documentation RFC2629 through XSLT December 2007 |
---|
562 | |
---|
563 | |
---|
564 | 4. Anchors |
---|
565 | |
---|
566 | The transformation automatically generates anchors that are supposed |
---|
567 | to be stable and predictable and that can be used to identify |
---|
568 | specific parts of the document. Anchors are generated both in HTML |
---|
569 | and XSL-FO content (but the latter will only be used for PDF output |
---|
570 | when the XSL-FO engine supports producing PDF anchors). |
---|
571 | |
---|
572 | |
---|
573 | |
---|
574 | |
---|
575 | |
---|
576 | |
---|
577 | |
---|
578 | |
---|
579 | |
---|
580 | |
---|
581 | |
---|
582 | |
---|
583 | |
---|
584 | |
---|
585 | |
---|
586 | |
---|
587 | |
---|
588 | |
---|
589 | |
---|
590 | |
---|
591 | |
---|
592 | |
---|
593 | |
---|
594 | |
---|
595 | |
---|
596 | |
---|
597 | |
---|
598 | |
---|
599 | |
---|
600 | |
---|
601 | |
---|
602 | |
---|
603 | |
---|
604 | |
---|
605 | |
---|
606 | |
---|
607 | |
---|
608 | |
---|
609 | |
---|
610 | |
---|
611 | |
---|
612 | |
---|
613 | |
---|
614 | |
---|
615 | Reschke [Page 11] |
---|
616 | |
---|
617 | Documentation RFC2629 through XSLT December 2007 |
---|
618 | |
---|
619 | |
---|
620 | The following anchors get auto-generated: |
---|
621 | |
---|
622 | +-----------------------+---------------------------------------+ |
---|
623 | | Anchor name | Description | |
---|
624 | +-----------------------+---------------------------------------+ |
---|
625 | | rfc.abstract | Abstract | |
---|
626 | | | | |
---|
627 | | rfc.authors | Authors section | |
---|
628 | | | | |
---|
629 | | rfc.copyright | Copyright section | |
---|
630 | | | | |
---|
631 | | rfc.copyrightnotice | Copyright notice | |
---|
632 | | | | |
---|
633 | | rfc.figure._n_ | Figures (titled) | |
---|
634 | | | | |
---|
635 | | rfc.figure.u._n_ | Figures (untitled) | |
---|
636 | | | | |
---|
637 | | rfc.index | Index | |
---|
638 | | | | |
---|
639 | | rfc.ipr | Intellectual Property | |
---|
640 | | | | |
---|
641 | | rfc.iref._n_ | Internal references | |
---|
642 | | | | |
---|
643 | | rfc.note._n_ | Notes (from front section) | |
---|
644 | | | | |
---|
645 | | rfc.references | References | |
---|
646 | | | | |
---|
647 | | rfc.references._n_ | Additional references | |
---|
648 | | | | |
---|
649 | | rfc.section._n_ | Section _n_ | |
---|
650 | | | | |
---|
651 | | rfc.section._n_.p._m_ | Section _n_, paragraph _m_ | |
---|
652 | | | | |
---|
653 | | rfc.status | Status of memo | |
---|
654 | | | | |
---|
655 | | rfc.table._n_ | Tables (titled) | |
---|
656 | | | | |
---|
657 | | rfc.table.u._n_ | Tables (untitled) | |
---|
658 | | | | |
---|
659 | | rfc.toc | Table of contents | |
---|
660 | | | | |
---|
661 | | rfc.xref._name_._n_ | References to reference _n_ to _name_ | |
---|
662 | +-----------------------+---------------------------------------+ |
---|
663 | |
---|
664 | |
---|
665 | |
---|
666 | |
---|
667 | |
---|
668 | |
---|
669 | |
---|
670 | |
---|
671 | Reschke [Page 12] |
---|
672 | |
---|
673 | Documentation RFC2629 through XSLT December 2007 |
---|
674 | |
---|
675 | |
---|
676 | 5. Supported XSLT engines |
---|
677 | |
---|
678 | The transformation requires a non-standard extension function (see |
---|
679 | exsl:node-set [1]) which is however widely available. XSLT |
---|
680 | processors that do not support this extension (or a functional |
---|
681 | equivalent) currently are not supported. |
---|
682 | |
---|
683 | 5.1. Standalone Engines |
---|
684 | |
---|
685 | The following XSLT engines are believed to work well: |
---|
686 | |
---|
687 | o MSXML3 and MSXML4 (<http://msdn.microsoft.com/xml>; these |
---|
688 | processors do not support exsl:node-set(), but have a similar |
---|
689 | proprietary extension) |
---|
690 | |
---|
691 | o Saxon (<http://saxon.sourceforge.net/>) |
---|
692 | |
---|
693 | o Xalan (<http://xml.apache.org/xalan-j/>) |
---|
694 | |
---|
695 | o xsltproc (libxslt) (<http://xmlsoft.org/XSLT/>, make sure that you |
---|
696 | have a current version) |
---|
697 | |
---|
698 | 5.2. In-Browser Engines |
---|
699 | |
---|
700 | The following browsers seem to work fine: |
---|
701 | |
---|
702 | o Internet Explorer 5.5 (Windows version, if MSXML3 is installed) |
---|
703 | |
---|
704 | o Internet Explorer 6 |
---|
705 | |
---|
706 | o Internet Explorer 7 |
---|
707 | |
---|
708 | o Firefox 3.* (currently only test builds available) |
---|
709 | |
---|
710 | o Opera 9.5 (currently only test builds available) |
---|
711 | |
---|
712 | o Safari 3 (starting with version 3.0.4) |
---|
713 | |
---|
714 | The following browsers are known not to work properly: |
---|
715 | |
---|
716 | o Firefox 1.*/2.* (missing extension function - see change request |
---|
717 | at Mozilla BugZilla 193678 [2]) |
---|
718 | |
---|
719 | o Opera 9.21: execution fails, potentially to a somewhat complex |
---|
720 | XPath expression (reported to Opera as bug 245725). |
---|
721 | |
---|
722 | o Safari 2.* supports client-side XSLT as of MacOS X 10.4, but |
---|
723 | misses required extension functions. A problem with stylesheets |
---|
724 | |
---|
725 | |
---|
726 | |
---|
727 | Reschke [Page 13] |
---|
728 | |
---|
729 | Documentation RFC2629 through XSLT December 2007 |
---|
730 | |
---|
731 | |
---|
732 | producing non-ASCII output (such as NBSP characters) has been |
---|
733 | fixed as of OSX 10.4.4. Both problems have been reported through |
---|
734 | Apple's bug tracking system, see <http://drakken.dbc.mtview.ca.us/ |
---|
735 | pipermail/xml2rfc/2005-May/002073.html> and |
---|
736 | <http://bugs.webkit.org/show_bug.cgi?id=4079>. |
---|
737 | |
---|
738 | |
---|
739 | |
---|
740 | |
---|
741 | |
---|
742 | |
---|
743 | |
---|
744 | |
---|
745 | |
---|
746 | |
---|
747 | |
---|
748 | |
---|
749 | |
---|
750 | |
---|
751 | |
---|
752 | |
---|
753 | |
---|
754 | |
---|
755 | |
---|
756 | |
---|
757 | |
---|
758 | |
---|
759 | |
---|
760 | |
---|
761 | |
---|
762 | |
---|
763 | |
---|
764 | |
---|
765 | |
---|
766 | |
---|
767 | |
---|
768 | |
---|
769 | |
---|
770 | |
---|
771 | |
---|
772 | |
---|
773 | |
---|
774 | |
---|
775 | |
---|
776 | |
---|
777 | |
---|
778 | |
---|
779 | |
---|
780 | |
---|
781 | |
---|
782 | |
---|
783 | Reschke [Page 14] |
---|
784 | |
---|
785 | Documentation RFC2629 through XSLT December 2007 |
---|
786 | |
---|
787 | |
---|
788 | 6. Transforming to HTML |
---|
789 | |
---|
790 | Transformation to HTML can be done inside the browser if it supports |
---|
791 | XSLT. To enable this, add the following processing instruction to |
---|
792 | the start of the source file: |
---|
793 | |
---|
794 | <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> |
---|
795 | |
---|
796 | (and ensure that "rfc2629.xslt" is present). |
---|
797 | |
---|
798 | 6.1. HTML compliance |
---|
799 | |
---|
800 | The transformation result is supposed to conform to the HTML 4.01 |
---|
801 | strict DTD [HTML]. This can be checked using the W3C's online |
---|
802 | validator at <http://validator.w3.org>. |
---|
803 | |
---|
804 | 6.2. Standard HTML LINK elements |
---|
805 | |
---|
806 | LINK elements exist since HTML 2.0. They can be used to embed |
---|
807 | content-independant links inside the document. Unfortunately, only |
---|
808 | few user agents support this element. Firefox users may want to |
---|
809 | check the Link Widgets [3] extension. |
---|
810 | |
---|
811 | The following LINK elements are produced: |
---|
812 | |
---|
813 | +-----------+-------------------------------------------------------+ |
---|
814 | | LINK type | description | |
---|
815 | +-----------+-------------------------------------------------------+ |
---|
816 | | alternate | for RFCs, a link to the authorative ASCII version on | |
---|
817 | | | the IETF web site | |
---|
818 | | | | |
---|
819 | | appendic | pointer to all top-level appendics | |
---|
820 | | | | |
---|
821 | | author | pointer to "authors" section | |
---|
822 | | | | |
---|
823 | | chapter | pointer to all top-level sections | |
---|
824 | | | | |
---|
825 | | contents | pointer to table of contents | |
---|
826 | | | | |
---|
827 | | copyright | pointer to copyright statement | |
---|
828 | | | | |
---|
829 | | index | pointer to index | |
---|
830 | +-----------+-------------------------------------------------------+ |
---|
831 | |
---|
832 | The figure below shows how Mozilla Firefox 1.0 displays the Site |
---|
833 | Navigation Bar for rfc2396.xml. |
---|
834 | |
---|
835 | |
---|
836 | |
---|
837 | |
---|
838 | |
---|
839 | Reschke [Page 15] |
---|
840 | |
---|
841 | Documentation RFC2629 through XSLT December 2007 |
---|
842 | |
---|
843 | |
---|
844 | 6.3. Standard HTML metadata |
---|
845 | |
---|
846 | The following standard HTML META elements are produced: |
---|
847 | |
---|
848 | +-----------+-------------------------------------------------+ |
---|
849 | | META name | description | |
---|
850 | +-----------+-------------------------------------------------+ |
---|
851 | | generator | from XSLT engine version and stylesheet version | |
---|
852 | | | | |
---|
853 | | keywords | from keyword elements in front section | |
---|
854 | +-----------+-------------------------------------------------+ |
---|
855 | |
---|
856 | 6.4. Dublin Core (RFC2731) metadata |
---|
857 | |
---|
858 | Unless turned off using the "rfc-ext support-rfc2731" processing |
---|
859 | instruction, the transformation will generate metadata according to |
---|
860 | [RFC2731]. |
---|
861 | |
---|
862 | The following DCMI properties are produced: |
---|
863 | |
---|
864 | +-------------------------+-----------------------------------------+ |
---|
865 | | META name | description | |
---|
866 | +-------------------------+-----------------------------------------+ |
---|
867 | | DC.Creator | from author information in front | |
---|
868 | | | section | |
---|
869 | | | | |
---|
870 | | DC.Date.Issued | from date information in front section | |
---|
871 | | | | |
---|
872 | | DC.Description.Abstract | from abstract | |
---|
873 | | | | |
---|
874 | | DC.Identifier | document URN [RFC2648] from "docName" | |
---|
875 | | | attribute | |
---|
876 | | | | |
---|
877 | | DC.Relation.Replaces | from "obsoletes" attribute | |
---|
878 | +-------------------------+-----------------------------------------+ |
---|
879 | |
---|
880 | 6.5. Experimental hCard support |
---|
881 | |
---|
882 | The generated author information is formatted in hCard [4] format. |
---|
883 | |
---|
884 | |
---|
885 | |
---|
886 | |
---|
887 | |
---|
888 | |
---|
889 | |
---|
890 | |
---|
891 | |
---|
892 | |
---|
893 | |
---|
894 | |
---|
895 | Reschke [Page 16] |
---|
896 | |
---|
897 | Documentation RFC2629 through XSLT December 2007 |
---|
898 | |
---|
899 | |
---|
900 | 7. Transforming to XHTML |
---|
901 | |
---|
902 | Transforming to XHTML requires slightly different XSLT output options |
---|
903 | and is implemented by the derived transformation script |
---|
904 | "rfc2629toXHTML.xslt". |
---|
905 | |
---|
906 | Note: Microsoft Internet Explorer does _not_ support XHTML. |
---|
907 | Therefore it usually makes more sense to generate plain old HTML. |
---|
908 | |
---|
909 | |
---|
910 | |
---|
911 | |
---|
912 | |
---|
913 | |
---|
914 | |
---|
915 | |
---|
916 | |
---|
917 | |
---|
918 | |
---|
919 | |
---|
920 | |
---|
921 | |
---|
922 | |
---|
923 | |
---|
924 | |
---|
925 | |
---|
926 | |
---|
927 | |
---|
928 | |
---|
929 | |
---|
930 | |
---|
931 | |
---|
932 | |
---|
933 | |
---|
934 | |
---|
935 | |
---|
936 | |
---|
937 | |
---|
938 | |
---|
939 | |
---|
940 | |
---|
941 | |
---|
942 | |
---|
943 | |
---|
944 | |
---|
945 | |
---|
946 | |
---|
947 | |
---|
948 | |
---|
949 | |
---|
950 | |
---|
951 | Reschke [Page 17] |
---|
952 | |
---|
953 | Documentation RFC2629 through XSLT December 2007 |
---|
954 | |
---|
955 | |
---|
956 | 8. Transforming to CHM (Microsoft Compiled Help) |
---|
957 | |
---|
958 | To generate a CHM file using Microsoft's HTML Help Compiler (hhc), |
---|
959 | three files are required in addition to the HTML file. |
---|
960 | |
---|
961 | 1. hhc - table of contents file (HTML) |
---|
962 | |
---|
963 | 2. hhk - index file (HTML) |
---|
964 | |
---|
965 | 3. hhp - project file (plain text) |
---|
966 | |
---|
967 | The three files are generated with three specific transformations, |
---|
968 | each requiring the additional XSLT parameter "basename" to specify |
---|
969 | the filename prefix. |
---|
970 | |
---|
971 | Example: |
---|
972 | |
---|
973 | saxon rfc2616.xml rfc2629toHhp.xslt basename=rfc2616 > rfc2616.hhp |
---|
974 | saxon rfc2616.xml rfc2629toHhc.xslt basename=rfc2616 > rfc2616.hhc |
---|
975 | saxon rfc2616.xml rfc2629toHhk.xslt basename=rfc2616 > rfc2616.hhk |
---|
976 | hhc rfc2616.hhp |
---|
977 | |
---|
978 | |
---|
979 | |
---|
980 | |
---|
981 | |
---|
982 | |
---|
983 | |
---|
984 | |
---|
985 | |
---|
986 | |
---|
987 | |
---|
988 | |
---|
989 | |
---|
990 | |
---|
991 | |
---|
992 | |
---|
993 | |
---|
994 | |
---|
995 | |
---|
996 | |
---|
997 | |
---|
998 | |
---|
999 | |
---|
1000 | |
---|
1001 | |
---|
1002 | |
---|
1003 | |
---|
1004 | |
---|
1005 | |
---|
1006 | |
---|
1007 | Reschke [Page 18] |
---|
1008 | |
---|
1009 | Documentation RFC2629 through XSLT December 2007 |
---|
1010 | |
---|
1011 | |
---|
1012 | 9. Transforming to PDF via XSL-FO |
---|
1013 | |
---|
1014 | 9.1. Via XSL-FO |
---|
1015 | |
---|
1016 | Transformation to XSL-FO [XSL-FO] format is available through |
---|
1017 | "rfc2629toFO.xslt" (which includes "rfc2629.xslt", so keep both in |
---|
1018 | the same folder). |
---|
1019 | |
---|
1020 | Compared to HTML user agents, XSL-FO engines unfortunately either |
---|
1021 | come as open source (for instance, Apache FOP) or feature-complete |
---|
1022 | (for instance, AntennaHouse XSL Formatter), but not both at the same |
---|
1023 | time. |
---|
1024 | |
---|
1025 | As Apache FOP needs special workarounds (page breaking, table |
---|
1026 | layout), and some popular extensions aren't standardized yet, the |
---|
1027 | translation produces a generic output (hopefully) conforming to |
---|
1028 | [XSL-FO]. Specific backends ("xsl11toFop.xslt", "xsl11toXep.xslt", |
---|
1029 | "xsl11toAn.xslt") then provide post-processing for the individual |
---|
1030 | processors. |
---|
1031 | |
---|
1032 | Note: the output is currently targeted at Apache FOP 0.20.5 |
---|
1033 | (<http://xmlgraphics.apache.org/fop/0.20.5/>), not the newer |
---|
1034 | versions. |
---|
1035 | |
---|
1036 | 9.1.1. Extension feature matrix |
---|
1037 | |
---|
1038 | +------------+-------------+------------+-------------+-------------+ |
---|
1039 | | | PDF anchors | PDF | PDF | Index | |
---|
1040 | | | | bookmarks | document | cleanup | |
---|
1041 | | | | | information | | |
---|
1042 | +------------+-------------+------------+-------------+-------------+ |
---|
1043 | | XSL 1.1 | no, but can | yes | no, but | yes | |
---|
1044 | | WD [5] | be | | uses XEP | | |
---|
1045 | | | auto-genera | | output | | |
---|
1046 | | | ted from | | extensions | | |
---|
1047 | | | "id" | | | | |
---|
1048 | | | attributes | | | | |
---|
1049 | | | | | | | |
---|
1050 | | Antenna | no | yes [7] | yes [7] | yes [7] | |
---|
1051 | | House XSL | | (from XSL | (from XEP | (just page | |
---|
1052 | | formatter | | 1.1 | document | duplicate | |
---|
1053 | | [6] | | bookmarks) | info) | elimination | |
---|
1054 | | | | | | , from XSL | |
---|
1055 | | | | | | 1.1 page | |
---|
1056 | | | | | | index) | |
---|
1057 | | | | | | | |
---|
1058 | |
---|
1059 | |
---|
1060 | |
---|
1061 | |
---|
1062 | |
---|
1063 | Reschke [Page 19] |
---|
1064 | |
---|
1065 | Documentation RFC2629 through XSLT December 2007 |
---|
1066 | |
---|
1067 | |
---|
1068 | | Apache | yes | yes (from | no | no | |
---|
1069 | | FOP [8] | | XSL 1.1 | | | |
---|
1070 | | | | bookmarks) | | | |
---|
1071 | | | | | | | |
---|
1072 | | RenderX | no | yes [10] | yes [10] | yes [10] | |
---|
1073 | | XEP [9] | | (from XSL | | (from XSL | |
---|
1074 | | | | 1.1 | | 1.1 page | |
---|
1075 | | | | bookmarks) | | index) | |
---|
1076 | +------------+-------------+------------+-------------+-------------+ |
---|
1077 | |
---|
1078 | 9.1.2. Example: producing output for Apache FOP |
---|
1079 | |
---|
1080 | Example: |
---|
1081 | |
---|
1082 | saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo |
---|
1083 | saxon tmp.fo xsl11toFop.xslt > rfc2629.fo |
---|
1084 | |
---|
1085 | 9.2. Via X(HTML) |
---|
1086 | |
---|
1087 | PDF output can also be produced directly from (X)HTML. One simple |
---|
1088 | approach is to rely on the browser's printing function, and to use a |
---|
1089 | printer driver that produces PDF. Depending on the brower's CSS |
---|
1090 | capabilities, the output will behave properly with respect to table |
---|
1091 | breaks etc. |
---|
1092 | |
---|
1093 | An alternative is PrinceXML (see <http://www.princexml.com/>), which |
---|
1094 | can produce PDF directly from (X)HTML input, based on the CSS |
---|
1095 | printing information. |
---|
1096 | |
---|
1097 | For instance, PDF output with text justification turned on can be |
---|
1098 | produced with: |
---|
1099 | |
---|
1100 | saxon input.xml rfc2629toXHTML.xslt xml2rfc-ext-justification=print \ |
---|
1101 | > output.xhtml |
---|
1102 | prince output.xhtml output.pdf |
---|
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 December 2007 |
---|
1122 | |
---|
1123 | |
---|
1124 | 10. Generic Extensions |
---|
1125 | |
---|
1126 | This section documents extensions implemented in "rfc2629.xslt", |
---|
1127 | using the extension namespace "http://purl.org/net/xml2rfc/ext". |
---|
1128 | |
---|
1129 | 10.1. <anchor-alias> element |
---|
1130 | |
---|
1131 | Using its "value" attribute, this element allows the definition of an |
---|
1132 | internal link target alias for the enclosing element. This alias can |
---|
1133 | then be used with the <ref> element for intra-document references. |
---|
1134 | |
---|
1135 | Note that the anchor alias is not subject to the naming constraints |
---|
1136 | that apply to anchor elements (which are XML names). |
---|
1137 | |
---|
1138 | 10.2. <bcp14> element |
---|
1139 | |
---|
1140 | This element marks the content as being one of the normative keywords |
---|
1141 | defined in [RFC2119]. |
---|
1142 | |
---|
1143 | The DOCTYPE definition below allows using these keywords using XML |
---|
1144 | entity expansion: such as in "...server &MUST; accept...". |
---|
1145 | |
---|
1146 | <!DOCTYPE rfc [ |
---|
1147 | <!ENTITY MAY "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1148 | >MAY</bcp14>"> |
---|
1149 | <!ENTITY MUST "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1150 | >MUST</bcp14>"> |
---|
1151 | <!ENTITY MUST-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1152 | >MUST NOT</bcp14>"> |
---|
1153 | <!ENTITY OPTIONAL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1154 | >OPTIONAL</bcp14>"> |
---|
1155 | <!ENTITY RECOMMENDED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1156 | >RECOMMENDED</bcp14>"> |
---|
1157 | <!ENTITY REQUIRED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1158 | >REQUIRED</bcp14>"> |
---|
1159 | <!ENTITY SHALL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1160 | >SHALL</bcp14>"> |
---|
1161 | <!ENTITY SHALL-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1162 | >SHALL NOT</bcp14>"> |
---|
1163 | <!ENTITY SHOULD "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1164 | >SHOULD</bcp14>"> |
---|
1165 | <!ENTITY SHOULD-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext' |
---|
1166 | >SHOULD NOT</bcp14>">]> |
---|
1167 | |
---|
1168 | 10.3. <bb> element |
---|
1169 | |
---|
1170 | Marking up a string as <bb> indicates that it represents the bottom |
---|
1171 | line of a box drawing, replacing the "+" and "-" characters |
---|
1172 | |
---|
1173 | |
---|
1174 | |
---|
1175 | Reschke [Page 21] |
---|
1176 | |
---|
1177 | Documentation RFC2629 through XSLT December 2007 |
---|
1178 | |
---|
1179 | |
---|
1180 | accordingly. |
---|
1181 | |
---|
1182 | 10.4. <bc> element |
---|
1183 | |
---|
1184 | Marking up a string as <bc> indicates that it represents a center |
---|
1185 | line of a box drawing, replacing the "|" character accordingly. |
---|
1186 | |
---|
1187 | 10.5. <blockquote> element |
---|
1188 | |
---|
1189 | This element is like the "blockquote" element in [HTML] (note this is |
---|
1190 | a block-level element!). It should contain one or more <t> child |
---|
1191 | elements. |
---|
1192 | |
---|
1193 | 10.6. <bt> element |
---|
1194 | |
---|
1195 | Marking up a string as <bt> indicates that it represents the top line |
---|
1196 | of a box drawing, replacing the "+" and "-" characters accordingly. |
---|
1197 | |
---|
1198 | 10.7. <dfn> element |
---|
1199 | |
---|
1200 | This element is like the "dfn" element in [HTML]. |
---|
1201 | |
---|
1202 | 10.8. <h> element |
---|
1203 | |
---|
1204 | This element is like the "h" element in [XHTML2]. |
---|
1205 | |
---|
1206 | 10.9. <link> element |
---|
1207 | |
---|
1208 | This element can be added as a top-level child element below <rfc> to |
---|
1209 | indicate additional link information. It's currently used only when |
---|
1210 | generating HTML output, in which case an HTML <link> element with |
---|
1211 | identical attributes gets generated. |
---|
1212 | |
---|
1213 | Example: generating HTML link element |
---|
1214 | |
---|
1215 | <x:link xmlns="http://purl.org/net/xml2rfc/ext" |
---|
1216 | rel="Bookmark" |
---|
1217 | title="IETF WEBDAV Working Group" |
---|
1218 | href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/> |
---|
1219 | |
---|
1220 | 10.10. <lt> element |
---|
1221 | |
---|
1222 | Used for grouping multiple <t> elements into a single list item. |
---|
1223 | |
---|
1224 | 10.11. <q> element |
---|
1225 | |
---|
1226 | This element is like the "q" element in [HTML]. |
---|
1227 | |
---|
1228 | |
---|
1229 | |
---|
1230 | |
---|
1231 | Reschke [Page 22] |
---|
1232 | |
---|
1233 | Documentation RFC2629 through XSLT December 2007 |
---|
1234 | |
---|
1235 | |
---|
1236 | 10.12. <ref> element |
---|
1237 | |
---|
1238 | This element is a simplified variant of the <xref> element, in that |
---|
1239 | no "target" attribute needs to be specified, instead the text |
---|
1240 | contents acts as identifier. That in itself wouldn't be terribly |
---|
1241 | useful, but together with the <anchor-alias>, it allows referring to |
---|
1242 | other parts of the document with minimal additional markup. |
---|
1243 | |
---|
1244 | For instance, given an alias definition such as |
---|
1245 | |
---|
1246 | <section title="Test" anchor="test"> |
---|
1247 | <x:anchor-alias value="alias1"/> |
---|
1248 | <x:anchor-alias value="alias 2"/> |
---|
1249 | ... |
---|
1250 | </section> |
---|
1251 | |
---|
1252 | the following simple references |
---|
1253 | |
---|
1254 | <x:ref>test</x:ref> |
---|
1255 | <x:ref>alias1</x:ref> |
---|
1256 | <x:ref>alias 2</x:ref> |
---|
1257 | |
---|
1258 | are equivalent to...: |
---|
1259 | |
---|
1260 | <xref target="test">test</xref> |
---|
1261 | <xref target="test">alias1</xref> |
---|
1262 | <xref target="test">alias 2</xref> |
---|
1263 | |
---|
1264 | 10.13. <source> element |
---|
1265 | |
---|
1266 | Can be used to enhance a <reference> with information about the |
---|
1267 | location for the XML source. This can be used by the <xref> |
---|
1268 | processing code to automatically extract the target section number. |
---|
1269 | |
---|
1270 | For example: |
---|
1271 | |
---|
1272 | ... |
---|
1273 | <xref target="RFC2616" x:fmt="of" x:rel="#PUT" /> |
---|
1274 | ... |
---|
1275 | |
---|
1276 | <reference target="RFC2616"/> |
---|
1277 | ... |
---|
1278 | <x:source href="rfc2616.xml"/> |
---|
1279 | ... |
---|
1280 | |
---|
1281 | |
---|
1282 | |
---|
1283 | |
---|
1284 | |
---|
1285 | |
---|
1286 | |
---|
1287 | Reschke [Page 23] |
---|
1288 | |
---|
1289 | Documentation RFC2629 through XSLT December 2007 |
---|
1290 | |
---|
1291 | |
---|
1292 | 10.14. Extensions to Xml2rfc <iref> element |
---|
1293 | |
---|
1294 | The extension attribute below is allowed on the standard <iref> |
---|
1295 | element: |
---|
1296 | |
---|
1297 | o x:for-anchor specifies that the <iref> will also be automatically |
---|
1298 | inserted whenever the specified anchor is cross-referenced -- this |
---|
1299 | may save entering lots of <iref> instances. As a special case, a |
---|
1300 | value of "" (empty string) refers to the anchor attribute of the |
---|
1301 | closest ancestor. |
---|
1302 | |
---|
1303 | 10.15. Extensions to Xml2rfc <list> element |
---|
1304 | |
---|
1305 | The extension attribute below is allowed on the standard <list> |
---|
1306 | element: |
---|
1307 | |
---|
1308 | o x:indent specifies the amount of indentation for list items in |
---|
1309 | hanging lists. This can be useful when the output format, such as |
---|
1310 | XSL-FO, does not support automatical formatting. The value takes |
---|
1311 | an XSL-FO width, such as "5em". The default is _length of longest |
---|
1312 | label in characters_ times _0.8em_. |
---|
1313 | |
---|
1314 | Also, the <list> element can take <x:lt> child elements instead of |
---|
1315 | <t>, allowing to insert multiple paragraphs into a single list item. |
---|
1316 | |
---|
1317 | 10.16. Extensions to Xml2rfc <section> element |
---|
1318 | |
---|
1319 | The extension attribute below is allowed on the standard <list> |
---|
1320 | element: |
---|
1321 | |
---|
1322 | o x:fixed-section-number can be used to specify a fixed section |
---|
1323 | number. This can be useful when formatting historic documents |
---|
1324 | that used a different numbering style. |
---|
1325 | |
---|
1326 | 10.17. Extensions to Xml2rfc <xref> element |
---|
1327 | |
---|
1328 | Three extension attributes are allowed on the standard <xref> |
---|
1329 | element: |
---|
1330 | |
---|
1331 | 1. x:sec can be specified to point to a specific section of the |
---|
1332 | referenced document, |
---|
1333 | |
---|
1334 | 2. x:rel may specify a relative reference to use when linking into |
---|
1335 | the referenced document (if linking by section number is not |
---|
1336 | available), |
---|
1337 | |
---|
1338 | 3. x:fmt defines the text format to be used. |
---|
1339 | |
---|
1340 | |
---|
1341 | |
---|
1342 | |
---|
1343 | Reschke [Page 24] |
---|
1344 | |
---|
1345 | Documentation RFC2629 through XSLT December 2007 |
---|
1346 | |
---|
1347 | |
---|
1348 | The following formats are defined for the x:fmt attribute: |
---|
1349 | |
---|
1350 | , (Comma) [_reference_], Section _sec_ |
---|
1351 | |
---|
1352 | () [_reference_] (Section _sec_) |
---|
1353 | |
---|
1354 | anchor Like the default format, but without brackets. |
---|
1355 | |
---|
1356 | of Section _sec_ of [_reference_] |
---|
1357 | |
---|
1358 | number _sec_ |
---|
1359 | |
---|
1360 | none No output (can be used to have xrefs to references without |
---|
1361 | having them rendered as such) |
---|
1362 | |
---|
1363 | sec Section _sec_ |
---|
1364 | |
---|
1365 | These extensions are currently only support of <xref> elements |
---|
1366 | without child nodes. |
---|
1367 | |
---|
1368 | If the processor knows how to reference the target section, it will |
---|
1369 | generate a link directly to the target section, such as in [RFC2119], |
---|
1370 | Section 5. |
---|
1371 | |
---|
1372 | |
---|
1373 | |
---|
1374 | |
---|
1375 | |
---|
1376 | |
---|
1377 | |
---|
1378 | |
---|
1379 | |
---|
1380 | |
---|
1381 | |
---|
1382 | |
---|
1383 | |
---|
1384 | |
---|
1385 | |
---|
1386 | |
---|
1387 | |
---|
1388 | |
---|
1389 | |
---|
1390 | |
---|
1391 | |
---|
1392 | |
---|
1393 | |
---|
1394 | |
---|
1395 | |
---|
1396 | |
---|
1397 | |
---|
1398 | |
---|
1399 | Reschke [Page 25] |
---|
1400 | |
---|
1401 | Documentation RFC2629 through XSLT December 2007 |
---|
1402 | |
---|
1403 | |
---|
1404 | 11. Utilities |
---|
1405 | |
---|
1406 | 11.1. Checking References |
---|
1407 | |
---|
1408 | "check-references.xslt" can be used to check all references to RFC- |
---|
1409 | and ID-series IETF publications and to W3C publications (note this |
---|
1410 | script requires local copies of |
---|
1411 | <ftp://ftp.isi.edu/in-notes/rfc-index.xml> and |
---|
1412 | <http://www.w3.org/2002/01/tr-automation/tr.rdf> and will use the XML |
---|
1413 | status information provided at <http://tools.ietf.org/>). |
---|
1414 | |
---|
1415 | If the document is supposed to be published on the IETF standards |
---|
1416 | track, the desired level can be specified using the parameter |
---|
1417 | "intended-level" as 'PROPOSED', 'DRAFT' or 'STANDARD'. |
---|
1418 | |
---|
1419 | For instance, as of 2006-08-06, the script produces for |
---|
1420 | <http://greenbytes.de/tech/webdav/rfc2518.xml>: |
---|
1421 | |
---|
1422 | > saxon rfc2518.xml check-references.xslt |
---|
1423 | |
---|
1424 | Normative References: |
---|
1425 | ISO-11578: not checked |
---|
1426 | ISO-639: not checked |
---|
1427 | ISO-8601: not checked |
---|
1428 | REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006 |
---|
1429 | REC-xml-names-19990114: [REC] obsoleted by PER-xml-names-20060614 |
---|
1430 | RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282 |
---|
1431 | RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616 |
---|
1432 | RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617 |
---|
1433 | RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok |
---|
1434 | RFC2141: [PROPOSED STANDARD] ok |
---|
1435 | RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok |
---|
1436 | RFC2396: [DRAFT STANDARD] obsoleted by RFC3986 |
---|
1437 | RFC2279: [DRAFT STANDARD] obsoleted by RFC3629 |
---|
1438 | |
---|
1439 | Informational References: |
---|
1440 | REC-PICS-labels-961031: [REC] ok |
---|
1441 | RFC1807: [INFORMATIONAL] ok |
---|
1442 | RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok |
---|
1443 | RFC2291: [INFORMATIONAL] ok |
---|
1444 | RFC2376: [INFORMATIONAL] obsoleted by RFC3023 |
---|
1445 | RFC2413: [INFORMATIONAL] ok |
---|
1446 | USMARC: not checked |
---|
1447 | WF: not checked |
---|
1448 | |
---|
1449 | Recognized formats in the <seriesInfo> element are: |
---|
1450 | |
---|
1451 | |
---|
1452 | |
---|
1453 | |
---|
1454 | |
---|
1455 | Reschke [Page 26] |
---|
1456 | |
---|
1457 | Documentation RFC2629 through XSLT December 2007 |
---|
1458 | |
---|
1459 | |
---|
1460 | o for RFCs, the name attribute must be "RFC", and the value |
---|
1461 | attribute must be the number of the RFC, |
---|
1462 | |
---|
1463 | o for Internet Drafs, the name attribute must be "ID" or "Internet- |
---|
1464 | Draft", and the value attribute must be the file name of the draft |
---|
1465 | (including the two-digit running number, but excluding a file |
---|
1466 | extension), |
---|
1467 | |
---|
1468 | o for W3C documents, the name attribute must be "W3C", must start |
---|
1469 | with "W3C ", or must start with "World Wide Web Consortium ", and |
---|
1470 | the value attribute must be the "shorthand" name of the |
---|
1471 | specification, such as "REC-xml-19980210". |
---|
1472 | |
---|
1473 | 11.2. Generating Graphs from References |
---|
1474 | |
---|
1475 | "gen-reference-graph.xslt" generates a graph of RFC dependencies, |
---|
1476 | using the same base data as in "check-references.xslt" (see |
---|
1477 | Section 11.1). Its output is a "dot" file, to be processed by |
---|
1478 | GraphViz (see <http://www.graphviz.org/>). |
---|
1479 | |
---|
1480 | The picture below shows the RFC dependencies in RFC2629. |
---|
1481 | |
---|
1482 | |
---|
1483 | 11.3. Producing reference entries for books |
---|
1484 | |
---|
1485 | "amazon-asin.xslt" uses the Amazon web services to generate a |
---|
1486 | <reference> element for a given ASIN (ISBN). |
---|
1487 | |
---|
1488 | |
---|
1489 | |
---|
1490 | |
---|
1491 | |
---|
1492 | |
---|
1493 | |
---|
1494 | |
---|
1495 | |
---|
1496 | |
---|
1497 | |
---|
1498 | |
---|
1499 | |
---|
1500 | |
---|
1501 | |
---|
1502 | |
---|
1503 | |
---|
1504 | |
---|
1505 | |
---|
1506 | |
---|
1507 | |
---|
1508 | |
---|
1509 | |
---|
1510 | |
---|
1511 | Reschke [Page 27] |
---|
1512 | |
---|
1513 | Documentation RFC2629 through XSLT December 2007 |
---|
1514 | |
---|
1515 | |
---|
1516 | For instance: |
---|
1517 | |
---|
1518 | <?xml version="1.0" encoding="utf-8"?> |
---|
1519 | <references> |
---|
1520 | <reference target="urn:isbn:0134516591"> |
---|
1521 | <front> |
---|
1522 | <title>Simple Book, The: An Introduction to Internet Management, |
---|
1523 | Revised Second Edition</title> |
---|
1524 | <author surname="Rose" |
---|
1525 | fullname="Marshall T. Rose" initials="M. T. "> |
---|
1526 | <organization/> |
---|
1527 | </author> |
---|
1528 | <author surname="Marshall" |
---|
1529 | fullname="Rose T. Marshall" initials="R. T."> |
---|
1530 | <organization/> |
---|
1531 | </author> |
---|
1532 | <date year="1996" month="March"/> |
---|
1533 | </front> |
---|
1534 | <seriesInfo name="Prentice Hall" value=""/> |
---|
1535 | </reference> |
---|
1536 | </references> |
---|
1537 | |
---|
1538 | Note that the resulting XML usually requires checking, in this case |
---|
1539 | Amazon's database is playing tricks with Marshall's name... |
---|
1540 | |
---|
1541 | 11.4. Down-converting to RFC2629bis DTD |
---|
1542 | |
---|
1543 | "clean-for-DTD.xslt" can be used to down-convert some extensions to a |
---|
1544 | format that is supported by the base xml2rfc distribution. Note that |
---|
1545 | these extensions are experimental (feedback appreciated). |
---|
1546 | |
---|
1547 | The following mappings are done: |
---|
1548 | |
---|
1549 | o <iref> elements inside <artwork> elements are moved in front of |
---|
1550 | the enclosing <figure> element. |
---|
1551 | |
---|
1552 | o <xref> elements inside <artwork> are expanded just like in regular |
---|
1553 | text (that is, the markup is stripped, but the element is replaced |
---|
1554 | by the applicable replacement text). |
---|
1555 | |
---|
1556 | o <x:anchor-alias> elements get stripped. |
---|
1557 | |
---|
1558 | o <x:bcp14> elements get stripped. |
---|
1559 | |
---|
1560 | o <x:bb>, <x:bc> and <x:bt> elements get stripped. |
---|
1561 | |
---|
1562 | o <x:blockquote> elements get converted to indented text (through a |
---|
1563 | <list> element). |
---|
1564 | |
---|
1565 | |
---|
1566 | |
---|
1567 | Reschke [Page 28] |
---|
1568 | |
---|
1569 | Documentation RFC2629 through XSLT December 2007 |
---|
1570 | |
---|
1571 | |
---|
1572 | o <x:dfn> elements get stripped. |
---|
1573 | |
---|
1574 | o <x:h> elements get stripped. |
---|
1575 | |
---|
1576 | o <x:link> elements get stripped. |
---|
1577 | |
---|
1578 | o <x:q> elements get stripped, with apostrophes added around the |
---|
1579 | text. |
---|
1580 | |
---|
1581 | o <x:ref> elements get replaced by <xref> elements, targetting |
---|
1582 | either the anchor or another anchor with matching <x:anchor-alias> |
---|
1583 | child element. |
---|
1584 | |
---|
1585 | 11.5. Extracting artwork |
---|
1586 | |
---|
1587 | With "extract-artwork.xslt", artwork elements named through the |
---|
1588 | "name" attribute can be extracted. This can be used to automatically |
---|
1589 | check their syntax (for instance, when ABNFs appear within a figure |
---|
1590 | element). |
---|
1591 | |
---|
1592 | For instance: |
---|
1593 | saxon rfc3986.xml extract-artwork.xslt name=uri.abnf |
---|
1594 | |
---|
1595 | In addition, artwork of a specific type can be extracted, such as |
---|
1596 | with: |
---|
1597 | saxon rfc3986.xml extract-artwork.xslt type=abnf |
---|
1598 | |
---|
1599 | 11.6. GRRDL |
---|
1600 | |
---|
1601 | "rfc2629grddl.xslt" extracts RDF information. This is experimental |
---|
1602 | work-in-progress. See <http://www.w3.org/TR/grddl/> for more |
---|
1603 | information. |
---|
1604 | |
---|
1605 | |
---|
1606 | |
---|
1607 | |
---|
1608 | |
---|
1609 | |
---|
1610 | |
---|
1611 | |
---|
1612 | |
---|
1613 | |
---|
1614 | |
---|
1615 | |
---|
1616 | |
---|
1617 | |
---|
1618 | |
---|
1619 | |
---|
1620 | |
---|
1621 | |
---|
1622 | |
---|
1623 | Reschke [Page 29] |
---|
1624 | |
---|
1625 | Documentation RFC2629 through XSLT December 2007 |
---|
1626 | |
---|
1627 | |
---|
1628 | 12. Informative References |
---|
1629 | |
---|
1630 | [HTML] Raggett, D., Hors, A., and I. Jacobs, "HTML 4.01 |
---|
1631 | Specification", W3C REC-html401-19991224, December 1999, |
---|
1632 | <http://www.w3.org/TR/html401/>. |
---|
1633 | |
---|
1634 | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate |
---|
1635 | Requirement Levels", BCP 14, RFC 2119, March 1997. |
---|
1636 | |
---|
1637 | [RFC2616] Fielding, R., Gettys, J., Mogul, J., Nielsen, H., |
---|
1638 | Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext |
---|
1639 | Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999. |
---|
1640 | |
---|
1641 | [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, |
---|
1642 | June 1999. |
---|
1643 | |
---|
1644 | [RFC2648] Moats, R., "A URN Namespace for IETF Documents", RFC 2648, |
---|
1645 | August 1999. |
---|
1646 | |
---|
1647 | [RFC2731] Kunze, J., "Encoding Dublin Core Metadata in HTML", |
---|
1648 | RFC 2731, December 1999. |
---|
1649 | |
---|
1650 | [RFC4234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax |
---|
1651 | Specifications: ABNF", RFC 4234, October 2005. |
---|
1652 | |
---|
1653 | [RNC] Clark, J., "RELAX NG Compact Syntax", OASIS , Nov 2002, <h |
---|
1654 | ttp://www.oasis-open.org/committees/relax-ng/ |
---|
1655 | compact-20021121.html>. |
---|
1656 | |
---|
1657 | [XHTML2] Axelsson, J., Birbeck, M., Dubinko, M., Epperson, B., |
---|
1658 | Ishikawa, M., McCarron, S., Navarro, A., and S. Pemberton, |
---|
1659 | "XHTML[TM] 2.0", W3C WD-xhtml2-20060726, July 2006, |
---|
1660 | <http://www.w3.org/TR/xhtml2>. |
---|
1661 | |
---|
1662 | [XSL-FO] Berglund, A., "Extensible Stylesheet Language (XSL) |
---|
1663 | Version 1.1", W3C REC-xsl11-20061205, Dec 2006, |
---|
1664 | <http://www.w3.org/TR/2006/REC-xsl11-20061205/>. |
---|
1665 | |
---|
1666 | [1] <http://www.exslt.org/exsl/functions/node-set/ |
---|
1667 | exsl.node-set.html> |
---|
1668 | |
---|
1669 | [2] <http://bugzilla.mozilla.org/show_bug.cgi?id=193678> |
---|
1670 | |
---|
1671 | [3] <https://addons.mozilla.org/firefox/2933/> |
---|
1672 | |
---|
1673 | [4] <http://microformats.org/wiki/hcard> |
---|
1674 | |
---|
1675 | [5] <http://www.w3.org/TR/2003/WD-xsl11-20031217/> |
---|
1676 | |
---|
1677 | |
---|
1678 | |
---|
1679 | Reschke [Page 30] |
---|
1680 | |
---|
1681 | Documentation RFC2629 through XSLT December 2007 |
---|
1682 | |
---|
1683 | |
---|
1684 | [6] <http://www.antennahouse.com/> |
---|
1685 | |
---|
1686 | [7] <http://www.antennahouse.com/XSL20/axf-extension.htm> |
---|
1687 | |
---|
1688 | [8] <http://xml.apache.org/fop/> |
---|
1689 | |
---|
1690 | [9] <http://xep.xattic.com/> |
---|
1691 | |
---|
1692 | [10] <http://xep.xattic.com/xep/spec.html> |
---|
1693 | |
---|
1694 | [11] <http://www.thaiopensource.com/relaxng/jing.html> |
---|
1695 | |
---|
1696 | [12] <http://dpcarlisle.blogspot.com/2007/05/ |
---|
1697 | exslt-node-set-function.html> |
---|
1698 | |
---|
1699 | |
---|
1700 | |
---|
1701 | |
---|
1702 | |
---|
1703 | |
---|
1704 | |
---|
1705 | |
---|
1706 | |
---|
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 December 2007 |
---|
1738 | |
---|
1739 | |
---|
1740 | Appendix A. RELAX NG Compact Schema |
---|
1741 | |
---|
1742 | The RelaxNG schema ([RNC]) below can be used to validate input |
---|
1743 | documents (for instance, with Jing [11]). |
---|
1744 | |
---|
1745 | _Note that this is work in progress, and doesn't yet cover all |
---|
1746 | extensions completely._ |
---|
1747 | |
---|
1748 | # WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR. |
---|
1749 | |
---|
1750 | # Define our extension namespace |
---|
1751 | namespace x = "http://purl.org/net/xml2rfc/ext" |
---|
1752 | |
---|
1753 | # Define GRDDL namespace |
---|
1754 | namespace grddl = "http://www.w3.org/2003/g/data-view#" |
---|
1755 | |
---|
1756 | # Include rfc2629bis RNC grammar |
---|
1757 | include "rfc2629.rnc" { |
---|
1758 | |
---|
1759 | # Redefine <artwork> to allow markup |
---|
1760 | artwork = |
---|
1761 | element artwork { |
---|
1762 | attlist.artwork, |
---|
1763 | (TEXT |
---|
1764 | | eref |
---|
1765 | | iref |
---|
1766 | | spanx |
---|
1767 | | xref |
---|
1768 | | x_bb |
---|
1769 | | x_bc |
---|
1770 | | x_bt |
---|
1771 | | x_ref)* |
---|
1772 | } |
---|
1773 | |
---|
1774 | # Redefine <c> to allow our extension elements |
---|
1775 | c = |
---|
1776 | element c { |
---|
1777 | attlist.c, |
---|
1778 | (TEXT |
---|
1779 | | xref |
---|
1780 | | eref |
---|
1781 | | iref |
---|
1782 | | cref |
---|
1783 | | spanx |
---|
1784 | | x_ref)* |
---|
1785 | } |
---|
1786 | |
---|
1787 | # Redefine <list> element to allow <x:lt> child elements |
---|
1788 | |
---|
1789 | |
---|
1790 | |
---|
1791 | Reschke [Page 32] |
---|
1792 | |
---|
1793 | Documentation RFC2629 through XSLT December 2007 |
---|
1794 | |
---|
1795 | |
---|
1796 | \list = |
---|
1797 | element list { |
---|
1798 | attlist.list, |
---|
1799 | (t+ | x_lt+) |
---|
1800 | } |
---|
1801 | |
---|
1802 | # Redefine <preamble> to allow our extension elements |
---|
1803 | preamble = |
---|
1804 | element preamble { |
---|
1805 | attlist.preamble, |
---|
1806 | (TEXT |
---|
1807 | | xref |
---|
1808 | | eref |
---|
1809 | | iref |
---|
1810 | | cref |
---|
1811 | | spanx |
---|
1812 | | x_anchor-alias)* |
---|
1813 | } |
---|
1814 | |
---|
1815 | # Redefine <postamble> to allow our extension elements |
---|
1816 | postamble = |
---|
1817 | element postamble { |
---|
1818 | attlist.postamble, |
---|
1819 | (TEXT |
---|
1820 | | xref |
---|
1821 | | eref |
---|
1822 | | iref |
---|
1823 | | cref |
---|
1824 | | spanx |
---|
1825 | | x_bcp14)* |
---|
1826 | } |
---|
1827 | |
---|
1828 | # Redefine <reference> to allow our extension elements |
---|
1829 | reference = |
---|
1830 | element reference { |
---|
1831 | attlist.reference, |
---|
1832 | front, |
---|
1833 | seriesInfo*, |
---|
1834 | format*, |
---|
1835 | annotation*, |
---|
1836 | x_source? |
---|
1837 | } |
---|
1838 | |
---|
1839 | # Redefine <rfc> to allow our extension elements |
---|
1840 | rfc = |
---|
1841 | element rfc { |
---|
1842 | attlist.rfc, |
---|
1843 | x_link*, |
---|
1844 | |
---|
1845 | |
---|
1846 | |
---|
1847 | Reschke [Page 33] |
---|
1848 | |
---|
1849 | Documentation RFC2629 through XSLT December 2007 |
---|
1850 | |
---|
1851 | |
---|
1852 | x_assign-section-number*, |
---|
1853 | front, |
---|
1854 | middle, |
---|
1855 | back? |
---|
1856 | } |
---|
1857 | |
---|
1858 | # Redefine <section> to allow our extension elements |
---|
1859 | section = |
---|
1860 | element section { |
---|
1861 | attlist.section, |
---|
1862 | (t |
---|
1863 | | figure |
---|
1864 | | texttable |
---|
1865 | | iref |
---|
1866 | | section |
---|
1867 | | x_anchor-alias |
---|
1868 | | x_blockquote)* |
---|
1869 | } |
---|
1870 | |
---|
1871 | # Redefine <spanx> to allow some markup |
---|
1872 | spanx = |
---|
1873 | element spanx { |
---|
1874 | attlist.spanx, |
---|
1875 | (TEXT |
---|
1876 | | iref |
---|
1877 | | xref |
---|
1878 | | x_ref)* |
---|
1879 | } |
---|
1880 | |
---|
1881 | # Redefine <t> to allow our extension elements |
---|
1882 | t = |
---|
1883 | element t { |
---|
1884 | attlist.t, |
---|
1885 | (TEXT |
---|
1886 | | \list |
---|
1887 | | figure |
---|
1888 | | xref |
---|
1889 | | eref |
---|
1890 | | iref |
---|
1891 | | cref |
---|
1892 | | spanx |
---|
1893 | | vspace |
---|
1894 | | x_anchor-alias |
---|
1895 | | x_bcp14 |
---|
1896 | | x_dfn |
---|
1897 | | x_h |
---|
1898 | | x_q |
---|
1899 | | x_ref)* |
---|
1900 | |
---|
1901 | |
---|
1902 | |
---|
1903 | Reschke [Page 34] |
---|
1904 | |
---|
1905 | Documentation RFC2629 through XSLT December 2007 |
---|
1906 | |
---|
1907 | |
---|
1908 | } |
---|
1909 | } |
---|
1910 | |
---|
1911 | # Extend attribute set for <iref> (see Section 10.14) |
---|
1912 | attlist.iref &= |
---|
1913 | attribute x:for-anchor { ATEXT }? |
---|
1914 | |
---|
1915 | # Extend attribute set for <list> (see Section 10.15) |
---|
1916 | attlist.list &= |
---|
1917 | attribute x:indent { ATEXT }? |
---|
1918 | |
---|
1919 | # Extend attribute set for <preamble> |
---|
1920 | attlist.preamble &= |
---|
1921 | attribute anchor { xsd:ID }? |
---|
1922 | |
---|
1923 | # Extend attribute set for <rfc> |
---|
1924 | attlist.rfc &= |
---|
1925 | attribute grddl:transformation { ATEXT }? |
---|
1926 | |
---|
1927 | # Extend attribute set for <section> (see Section 10.16) |
---|
1928 | attlist.section &= |
---|
1929 | attribute x:fixed-section-number { ATEXT }? |
---|
1930 | |
---|
1931 | # Allow anchor attribute on <spanx> |
---|
1932 | attlist.spanx &= |
---|
1933 | attribute anchor { xsd:ID }? |
---|
1934 | |
---|
1935 | # Extend attribute set for <xref> (see Section 10.17) |
---|
1936 | attlist.xref &= |
---|
1937 | attribute x:fmt { "()" | "," | "anchor" | "of" | "number" | "sec" | |
---|
1938 | "none" }?, |
---|
1939 | attribute x:rel { ATEXT }?, |
---|
1940 | attribute x:sec { ATEXT }? |
---|
1941 | |
---|
1942 | # Aliasing of anchors (see Section 10.1) |
---|
1943 | x_anchor-alias = |
---|
1944 | element x:anchor-alias { |
---|
1945 | attribute value { TEXT }, |
---|
1946 | empty |
---|
1947 | } |
---|
1948 | |
---|
1949 | # Setting section numbers for internally generated sections |
---|
1950 | # (experimental) |
---|
1951 | x_assign-section-number = |
---|
1952 | element x:assign-section-number { |
---|
1953 | attribute builtin-target { "authors" }, |
---|
1954 | attribute number { TEXT }, |
---|
1955 | empty |
---|
1956 | |
---|
1957 | |
---|
1958 | |
---|
1959 | Reschke [Page 35] |
---|
1960 | |
---|
1961 | Documentation RFC2629 through XSLT December 2007 |
---|
1962 | |
---|
1963 | |
---|
1964 | } |
---|
1965 | |
---|
1966 | # Bottom line of box drawing (see Section 10.3) |
---|
1967 | x_bb = |
---|
1968 | element x:bb { |
---|
1969 | (TEXT |
---|
1970 | | iref |
---|
1971 | | xref |
---|
1972 | | x_bb |
---|
1973 | | x_bc |
---|
1974 | | x_bt |
---|
1975 | | x_ref)* |
---|
1976 | } |
---|
1977 | |
---|
1978 | # Center line of box drawing (see Section 10.4) |
---|
1979 | x_bc = |
---|
1980 | element x:bc { |
---|
1981 | (TEXT |
---|
1982 | | iref |
---|
1983 | | xref |
---|
1984 | | x_bb |
---|
1985 | | x_bc |
---|
1986 | | x_bt |
---|
1987 | | x_ref)* |
---|
1988 | } |
---|
1989 | |
---|
1990 | # BCP14/RFC2119 keywords (see Section 10.2) |
---|
1991 | x_bcp14 = |
---|
1992 | element x:bcp14 { |
---|
1993 | "MAY" |
---|
1994 | | "MUST" |
---|
1995 | | "MUST NOT" |
---|
1996 | | "NOT RECOMMENDED" |
---|
1997 | | "OPTIONAL" |
---|
1998 | | "RECOMMENDED" |
---|
1999 | | "REQUIRED" |
---|
2000 | | "SHALL" |
---|
2001 | | "SHALL NOT" |
---|
2002 | | "SHOULD" |
---|
2003 | | "SHOULD NOT" |
---|
2004 | } |
---|
2005 | |
---|
2006 | # Blockquote (see Section 10.5) |
---|
2007 | x_blockquote = |
---|
2008 | element x:blockquote { |
---|
2009 | attribute cite { URI }?, |
---|
2010 | t+ |
---|
2011 | } |
---|
2012 | |
---|
2013 | |
---|
2014 | |
---|
2015 | Reschke [Page 36] |
---|
2016 | |
---|
2017 | Documentation RFC2629 through XSLT December 2007 |
---|
2018 | |
---|
2019 | |
---|
2020 | # Top line of box drawing (see Section 10.6) |
---|
2021 | x_bt = |
---|
2022 | element x:bt { |
---|
2023 | (TEXT |
---|
2024 | | iref |
---|
2025 | | xref |
---|
2026 | | x_bb |
---|
2027 | | x_bc |
---|
2028 | | x_bt |
---|
2029 | | x_ref)* |
---|
2030 | } |
---|
2031 | |
---|
2032 | # Definition (see Section 10.7) |
---|
2033 | x_dfn = |
---|
2034 | element x:dfn { |
---|
2035 | TEXT |
---|
2036 | } |
---|
2037 | |
---|
2038 | # Heading (see Section 10.8) |
---|
2039 | x_h = |
---|
2040 | element x:h { |
---|
2041 | TEXT |
---|
2042 | } |
---|
2043 | |
---|
2044 | # Link (see Section 10.9) |
---|
2045 | x_link = |
---|
2046 | element x:link { |
---|
2047 | attribute href { URI }, |
---|
2048 | attribute title { TEXT }?, |
---|
2049 | attribute rel { TEXT }, |
---|
2050 | empty |
---|
2051 | } |
---|
2052 | |
---|
2053 | # Extended list item (see Section 10.10) |
---|
2054 | x_lt = |
---|
2055 | element x:lt { |
---|
2056 | attribute anchor { xsd:ID }?, |
---|
2057 | attribute hangText { TEXT }?, |
---|
2058 | t+ |
---|
2059 | } |
---|
2060 | |
---|
2061 | # Inline quote (see Section 10.11) |
---|
2062 | x_q = |
---|
2063 | element x:q { |
---|
2064 | TEXT |
---|
2065 | } |
---|
2066 | |
---|
2067 | # Anchor reference (see Section 10.12) |
---|
2068 | |
---|
2069 | |
---|
2070 | |
---|
2071 | Reschke [Page 37] |
---|
2072 | |
---|
2073 | Documentation RFC2629 through XSLT December 2007 |
---|
2074 | |
---|
2075 | |
---|
2076 | x_ref = |
---|
2077 | element x:ref { |
---|
2078 | TEXT |
---|
2079 | } |
---|
2080 | |
---|
2081 | # source information (see Section 10.13) |
---|
2082 | x_source = |
---|
2083 | element x:source { |
---|
2084 | attribute href { URI }, |
---|
2085 | empty |
---|
2086 | } |
---|
2087 | |
---|
2088 | |
---|
2089 | |
---|
2090 | |
---|
2091 | |
---|
2092 | |
---|
2093 | |
---|
2094 | |
---|
2095 | |
---|
2096 | |
---|
2097 | |
---|
2098 | |
---|
2099 | |
---|
2100 | |
---|
2101 | |
---|
2102 | |
---|
2103 | |
---|
2104 | |
---|
2105 | |
---|
2106 | |
---|
2107 | |
---|
2108 | |
---|
2109 | |
---|
2110 | |
---|
2111 | |
---|
2112 | |
---|
2113 | |
---|
2114 | |
---|
2115 | |
---|
2116 | |
---|
2117 | |
---|
2118 | |
---|
2119 | |
---|
2120 | |
---|
2121 | |
---|
2122 | |
---|
2123 | |
---|
2124 | |
---|
2125 | |
---|
2126 | |
---|
2127 | Reschke [Page 38] |
---|
2128 | |
---|
2129 | Documentation RFC2629 through XSLT December 2007 |
---|
2130 | |
---|
2131 | |
---|
2132 | Appendix B. Implementation Notes |
---|
2133 | |
---|
2134 | B.1. Recognized type attributes for <artwork> element |
---|
2135 | |
---|
2136 | Specific values in the <artwork> element's "type" attribute are |
---|
2137 | recognized and cause a different visual style to be used: |
---|
2138 | |
---|
2139 | +-------------------------------------+-----------------------------+ |
---|
2140 | | Media Type | Comment | |
---|
2141 | +-------------------------------------+-----------------------------+ |
---|
2142 | | abnf | ABNF as per [RFC4234] | |
---|
2143 | | | | |
---|
2144 | | abnf2616 | ABNF as per [RFC2616], | |
---|
2145 | | | Section 2.1 | |
---|
2146 | | | | |
---|
2147 | | application/relax-ng-compact-syntax | Relax NG Compact Syntax as | |
---|
2148 | | | per [RNC] | |
---|
2149 | | | | |
---|
2150 | | application/xml-dtd | XML DTD | |
---|
2151 | | | | |
---|
2152 | | message/http; msgtype="request" | HTTP message, as per | |
---|
2153 | | | [RFC2616], Section 19.1 | |
---|
2154 | | | | |
---|
2155 | | message/http; msgtype="response" | HTTP message, as per | |
---|
2156 | | | [RFC2616], Section 19.1 | |
---|
2157 | +-------------------------------------+-----------------------------+ |
---|
2158 | |
---|
2159 | |
---|
2160 | |
---|
2161 | |
---|
2162 | |
---|
2163 | |
---|
2164 | |
---|
2165 | |
---|
2166 | |
---|
2167 | |
---|
2168 | |
---|
2169 | |
---|
2170 | |
---|
2171 | |
---|
2172 | |
---|
2173 | |
---|
2174 | |
---|
2175 | |
---|
2176 | |
---|
2177 | |
---|
2178 | |
---|
2179 | |
---|
2180 | |
---|
2181 | |
---|
2182 | |
---|
2183 | Reschke [Page 39] |
---|
2184 | |
---|
2185 | Documentation RFC2629 through XSLT December 2007 |
---|
2186 | |
---|
2187 | |
---|
2188 | Appendix C. License |
---|
2189 | |
---|
2190 | Copyright (c) 2006-2007, Julian Reschke |
---|
2191 | (julian.reschke@greenbytes.de) |
---|
2192 | |
---|
2193 | All rights reserved. |
---|
2194 | |
---|
2195 | Redistribution and use in source and binary forms, with or without |
---|
2196 | modification, are permitted provided that the following conditions |
---|
2197 | are met: |
---|
2198 | |
---|
2199 | o Redistributions of source code must retain the above copyright |
---|
2200 | notice, this list of conditions and the following disclaimer. |
---|
2201 | |
---|
2202 | o Redistributions in binary form must reproduce the above copyright |
---|
2203 | notice, this list of conditions and the following disclaimer in |
---|
2204 | the documentation and/or other materials provided with the |
---|
2205 | distribution. |
---|
2206 | |
---|
2207 | o Neither the name of Julian Reschke nor the names of its |
---|
2208 | contributors may be used to endorse or promote products derived |
---|
2209 | from this software without specific prior written permission. |
---|
2210 | |
---|
2211 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
---|
2212 | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
---|
2213 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
---|
2214 | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
---|
2215 | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
---|
2216 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
---|
2217 | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
---|
2218 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
---|
2219 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
---|
2220 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
---|
2221 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
---|
2222 | |
---|
2223 | |
---|
2224 | |
---|
2225 | |
---|
2226 | |
---|
2227 | |
---|
2228 | |
---|
2229 | |
---|
2230 | |
---|
2231 | |
---|
2232 | |
---|
2233 | |
---|
2234 | |
---|
2235 | |
---|
2236 | |
---|
2237 | |
---|
2238 | |
---|
2239 | Reschke [Page 40] |
---|
2240 | |
---|
2241 | Documentation RFC2629 through XSLT December 2007 |
---|
2242 | |
---|
2243 | |
---|
2244 | Appendix D. Change Logs |
---|
2245 | |
---|
2246 | D.1. Package |
---|
2247 | |
---|
2248 | 2006-01-01 Switch to BSD License. |
---|
2249 | |
---|
2250 | 2007-01-12 Update to xml2rfc v1.33pre2. |
---|
2251 | |
---|
2252 | 2007-03-31 Update to xml2rfc v1.33pre3. |
---|
2253 | |
---|
2254 | 2007-05-01 Add XSLT test cases. |
---|
2255 | |
---|
2256 | D.2. amazon-asin.xslt |
---|
2257 | |
---|
2258 | 2003-11-16 Initial release. |
---|
2259 | |
---|
2260 | 2005-04-02 Fix two DTD issues. |
---|
2261 | |
---|
2262 | D.3. check-references.xslt |
---|
2263 | |
---|
2264 | 2003-11-16 Initial release. |
---|
2265 | |
---|
2266 | 2003-11-16 Initial release. |
---|
2267 | |
---|
2268 | 2004-05-11 Add document status; print references type. |
---|
2269 | |
---|
2270 | 2005-01-01 Add experimental check for ID status. |
---|
2271 | |
---|
2272 | 2005-04-01 Add fixes from Bill Fenner. |
---|
2273 | |
---|
2274 | 2005-12-03 Add checks against local copy of |
---|
2275 | <http://www.w3.org/2002/01/tr-automation/tr.rdf>. |
---|
2276 | |
---|
2277 | 2006-07-22 Add checks for standards levels. |
---|
2278 | |
---|
2279 | 2006-08-06 "check-ietf-references.xslt" replaced by "check- |
---|
2280 | references.xslt". |
---|
2281 | |
---|
2282 | 2007-01-04 Use information online at <http://tools.ietf.org/> to |
---|
2283 | retrieve Internet-Draft status information. |
---|
2284 | |
---|
2285 | 2007-06-16 Fix bug looking up ref type when inside change markup. |
---|
2286 | |
---|
2287 | D.4. gen-reference-graph.xslt |
---|
2288 | |
---|
2289 | |
---|
2290 | |
---|
2291 | |
---|
2292 | |
---|
2293 | |
---|
2294 | |
---|
2295 | Reschke [Page 41] |
---|
2296 | |
---|
2297 | Documentation RFC2629 through XSLT December 2007 |
---|
2298 | |
---|
2299 | |
---|
2300 | 2006-09-03 New. |
---|
2301 | |
---|
2302 | 2007-06-07 Use Carlisle method [12] to define exslt:node-set in |
---|
2303 | msxsml (which means that the stylesheet can now be used with MSXML |
---|
2304 | as well). |
---|
2305 | |
---|
2306 | 2007-10-15 Use W3C data from tr.rdf as well (experimental). |
---|
2307 | |
---|
2308 | D.5. rfc2629.xslt |
---|
2309 | |
---|
2310 | 2001-03-28 Code rearranged, generate numbered section anchors for |
---|
2311 | paragraphs (t) as well. Fixes in index handling. |
---|
2312 | |
---|
2313 | 2001-04-12 Moved HTML output into XHTML namespace. |
---|
2314 | |
---|
2315 | 2001-10-02 Fixed default location for RFCs and numbering of section |
---|
2316 | references. Support ?rfc editing processing instruction. |
---|
2317 | |
---|
2318 | 2001-10-07 Made telephone number links active. |
---|
2319 | |
---|
2320 | 2001-10-08 Support for vspace element. |
---|
2321 | |
---|
2322 | 2001-10-09 Experimental support for rfc-issue PI. |
---|
2323 | |
---|
2324 | 2001-11-11 Support rfc private PI. Removed bogus code reporting the |
---|
2325 | WG in the header. |
---|
2326 | |
---|
2327 | 2001-11-11 Support rfc private PI. Removed bogus code reporting the |
---|
2328 | WG in the header. |
---|
2329 | |
---|
2330 | 2001-12-17 Support title attribute on references element |
---|
2331 | |
---|
2332 | 2002-01-05 Support for list/@style="@format" |
---|
2333 | |
---|
2334 | 2002-01-09 Display "closed" RFC issues as deleted |
---|
2335 | |
---|
2336 | 2002-01-14 Experimentally and optionally parse XML encountered in |
---|
2337 | artwork elements (requires MSXSL). |
---|
2338 | |
---|
2339 | 2002-01-27 Some cleanup. Moved RFC issues from PIs into namespaced |
---|
2340 | elements. |
---|
2341 | |
---|
2342 | 2002-01-29 Added support for sortrefs PI. Added support for figure |
---|
2343 | names. |
---|
2344 | |
---|
2345 | |
---|
2346 | |
---|
2347 | |
---|
2348 | |
---|
2349 | |
---|
2350 | |
---|
2351 | Reschke [Page 42] |
---|
2352 | |
---|
2353 | Documentation RFC2629 through XSLT December 2007 |
---|
2354 | |
---|
2355 | |
---|
2356 | 2002-02-07 Highlight parts of artwork which are too wide (72 |
---|
2357 | characters). |
---|
2358 | |
---|
2359 | 2002-02-12 Code rearrangement for static texts. Fixes for section |
---|
2360 | numbering. TOC generation rewritten. |
---|
2361 | |
---|
2362 | 2002-02-15 Support for irefs in sections; support iref @primary=true |
---|
2363 | |
---|
2364 | 2002-03-03 Moved anchor prefix into a constant. Added sanity checks |
---|
2365 | on user anchor names. |
---|
2366 | |
---|
2367 | 2002-03-23 Bugfix in detection of matching org names when creating |
---|
2368 | the header. Fixed sorting in subitems. |
---|
2369 | |
---|
2370 | 2002-04-02 Fix TOC link HTML generation when no TOC is generated |
---|
2371 | (created broken HTML table code). |
---|
2372 | |
---|
2373 | 2002-04-03 Made rendering of references more tolerant re: missing |
---|
2374 | parts. |
---|
2375 | |
---|
2376 | 2002-04-08 Fixed reference numbering when references are split into |
---|
2377 | separate sections. |
---|
2378 | |
---|
2379 | 2002-04-16 Fix default namespace (shouldn't be set for HTML output |
---|
2380 | method). |
---|
2381 | |
---|
2382 | 2002-04-19 Lowercase internal CSS selectors for Mozilla compliance. |
---|
2383 | Do not put TOC into ul element. |
---|
2384 | |
---|
2385 | 2002-04-21 Make numbered list inside numbered lists use alphanumeric |
---|
2386 | numbering. |
---|
2387 | |
---|
2388 | 2002-05-05 Updated issue/editing support. |
---|
2389 | |
---|
2390 | 2002-05-15 Bugfix for section numbering after introduction of ed: |
---|
2391 | replace |
---|
2392 | |
---|
2393 | 2002-06-21 When producing private documents, do not include document |
---|
2394 | status, copyright etc. |
---|
2395 | |
---|
2396 | 2002-07-08 Fix xrefs to Appendices. |
---|
2397 | |
---|
2398 | 2002-07-19 Make artwork lightyellow for easier reading. (fielding) |
---|
2399 | |
---|
2400 | 2002-10-09 Translate references title to anchor name to avoid non- |
---|
2401 | uri characters. (fielding) |
---|
2402 | |
---|
2403 | |
---|
2404 | |
---|
2405 | |
---|
2406 | |
---|
2407 | Reschke [Page 43] |
---|
2408 | |
---|
2409 | Documentation RFC2629 through XSLT December 2007 |
---|
2410 | |
---|
2411 | |
---|
2412 | 2002-10-13 Support for tocdepth PI. |
---|
2413 | |
---|
2414 | 2002-11-03 Added temporariry workaround for Mozilla/Transformiix |
---|
2415 | result tree fragment problem. (search for |
---|
2416 | 'http://bugzilla.mozilla.org/show_bug.cgi?id=143668') |
---|
2417 | |
---|
2418 | 2002-12-25 xref code: attempt to uppercase "section" and "appendix" |
---|
2419 | when at the start of a sentence. |
---|
2420 | |
---|
2421 | 2003-02-02 fixed code for vspace blankLines="0", enhanced display |
---|
2422 | for list with "format" style, got rid of HTML blockquote elements, |
---|
2423 | added support for "hangIndent" |
---|
2424 | |
---|
2425 | 2003-04-10 experimental support for appendix and spanx elements |
---|
2426 | |
---|
2427 | 2003-04-19 fixed counting of list numbers in "format %" styles (one |
---|
2428 | counter per unique format string). Added more spanx styles. |
---|
2429 | |
---|
2430 | 2003-05-02 experimental texttable support |
---|
2431 | |
---|
2432 | 2003-05-02 Make mailto links optional (default = none) (jre: default |
---|
2433 | and PI name changed) (fielding) |
---|
2434 | |
---|
2435 | 2003-05-04 experimental support for HTML link elements; fix default |
---|
2436 | for table header alignment default |
---|
2437 | |
---|
2438 | 2003-05-06 support for "background" PI. |
---|
2439 | |
---|
2440 | 2003-05-11 change %c format to lowercase alphabetic. add support for |
---|
2441 | keyword elements (generate META tag). fix various HTML conformance |
---|
2442 | problems. added experimental support for role attribute. do not |
---|
2443 | number paragraphs in unnumbered sections. update boilerplate |
---|
2444 | texts. support for "iprnotified" PI. bugfix list numbering. strip |
---|
2445 | whitespace when building tel: URIs. |
---|
2446 | |
---|
2447 | 2003-05-12 more conformance fixes (layout moved into CSS, move lists |
---|
2448 | and figures out of para content, do not use tables for list |
---|
2449 | formatting) |
---|
2450 | |
---|
2451 | 2003-05-13 add DC.Creator meta tag, refactoring |
---|
2452 | |
---|
2453 | 2003-05-16 put nbsps between "section" and section number (xref). |
---|
2454 | |
---|
2455 | 2003-05-18 author summary: add missing comma. |
---|
2456 | |
---|
2457 | |
---|
2458 | |
---|
2459 | |
---|
2460 | |
---|
2461 | |
---|
2462 | |
---|
2463 | Reschke [Page 44] |
---|
2464 | |
---|
2465 | Documentation RFC2629 through XSLT December 2007 |
---|
2466 | |
---|
2467 | |
---|
2468 | 2003-06-06 fix index generation bug (transposed characters in key |
---|
2469 | generation). Enhance sentence start detection (xref starting a |
---|
2470 | section was using lowercase "section"). |
---|
2471 | |
---|
2472 | 2003-06-22 exp. support for xref/@format. Add missing support for |
---|
2473 | eref w/o content. exp. support for annotations in reference |
---|
2474 | elements. Code cleanup reference table formatting. |
---|
2475 | |
---|
2476 | 2003-07-09 Another fix for DC.Creator meta tag creation based on |
---|
2477 | RFC2731 |
---|
2478 | |
---|
2479 | 2003-07-24 Fix namespace name for DC.Creator. |
---|
2480 | |
---|
2481 | 2003-08-06 Cleanup node-set support (only use exslt (saxon, xalan, |
---|
2482 | libxslt) extension functions; remove Transformix workarounds that |
---|
2483 | stopped to work in Moz 1.4) |
---|
2484 | |
---|
2485 | 2003-08-09 Generate HTML lang tag. |
---|
2486 | |
---|
2487 | 2003-08-10 Map spanx/verb to HTML "samp" element. Fix author name |
---|
2488 | display in references (reverse surname/initials for last author), |
---|
2489 | add "Ed.". Fix internal bookmark generation. |
---|
2490 | |
---|
2491 | 2003-08-17 Add DCMI dates, identifiers and abstract. Add PI to |
---|
2492 | suppress DCMI generation. Do not add TOC entry to Copyright |
---|
2493 | Statement when there is none. Align RFC2629 PI names and |
---|
2494 | parameter names. Change style for inline URIs generated by eref. |
---|
2495 | Add header and footer support. Enhance CSS paging properties. |
---|
2496 | Support topblock PI. Added hooks for proper XHTML generation |
---|
2497 | through separate XSLT. Enhance warning and error messages. Add |
---|
2498 | support for artwork image display. Table formatting fixes |
---|
2499 | (borders, thead continuation). |
---|
2500 | |
---|
2501 | 2003-08-18 Add workaround for MSXML4 node-set and Mozilla node-set |
---|
2502 | issues (fallback just displays are warning). |
---|
2503 | |
---|
2504 | 2003-10-06 Add workaround for broken pre/ins handling in Mozilla |
---|
2505 | (see <http://bugzilla.mozilla.org/show_bug.cgi?id=204401>). Make |
---|
2506 | use of cite attribute on ed:replace. CSS cleanup. |
---|
2507 | |
---|
2508 | 2003-10-08 Fix minor issue detecting the same org for the header |
---|
2509 | (caused by IE's non-standard whitespace handling). Fix default |
---|
2510 | handling for /rfc/@category. |
---|
2511 | |
---|
2512 | 2003-11-09 Inherit ed:entered-by from ancestor elements. Change CSS |
---|
2513 | color for inserted text to green. Generate issues-list anchor. |
---|
2514 | Do not complain about missing targets when the xref element is |
---|
2515 | below ed:del. Remove code that attempted to distinguish section/ |
---|
2516 | |
---|
2517 | |
---|
2518 | |
---|
2519 | Reschke [Page 45] |
---|
2520 | |
---|
2521 | Documentation RFC2629 through XSLT December 2007 |
---|
2522 | |
---|
2523 | |
---|
2524 | Section when producing links - always use uppercase. Fix date |
---|
2525 | rendering for issue resolutions. |
---|
2526 | |
---|
2527 | 2003-11-29 Fix color values for table backgrounds for issue |
---|
2528 | rendering. Change rendering of issue links to use inline-styles. |
---|
2529 | Add colored issue markers to issues. |
---|
2530 | |
---|
2531 | 2003-12-13 Fix inheritance of ed:entered-by attribute. Display note |
---|
2532 | elements inside change tracking as well. |
---|
2533 | |
---|
2534 | 2004-01-18 When PI compact = 'yes', make most CSS print page breaks |
---|
2535 | conditional. |
---|
2536 | |
---|
2537 | 2004-02-20 Support for RFC3667 IPR changes (xml2rfc 1.22); see <http |
---|
2538 | ://lists.xml.resource.org/pipermail/xml2rfc/2004-February/ |
---|
2539 | 001088.html>. |
---|
2540 | |
---|
2541 | 2004-03-11 Add "(if approved)" to "updates" and "obsoletes" unless |
---|
2542 | the document has an RFC number. |
---|
2543 | |
---|
2544 | 2004-04-01 Fix RFC3667 output, see <http://lists.xml.resource.org/ |
---|
2545 | pipermail/xml2rfc/2004-April/001208.html>. |
---|
2546 | |
---|
2547 | 2004-04-04 Add support for section/top attribute. Move references |
---|
2548 | into plain section container. |
---|
2549 | |
---|
2550 | 2004-04-06 Do not emit identical para anchors for deleted content. |
---|
2551 | |
---|
2552 | 2004-04-14 Fix references TOC generation when there are no |
---|
2553 | references. |
---|
2554 | |
---|
2555 | 2004-04-24 Fix RFC3667 output, see |
---|
2556 | <http://xml.resource.org/pipermail/xml2rfc/2004-April/ |
---|
2557 | 001246.html>. |
---|
2558 | |
---|
2559 | 2004-05-09 Add custom support for generating compound index |
---|
2560 | documents. Add anchors for each Index letter. Add experimental |
---|
2561 | cref support. Fix conditional page breaks before References |
---|
2562 | section. |
---|
2563 | |
---|
2564 | 2004-05-16 Refactor external index generation. |
---|
2565 | |
---|
2566 | 2004-05-20 Rewrite anchor generation for comments. |
---|
2567 | |
---|
2568 | 2004-05-22 Enhance issues rendering (add links to changes). |
---|
2569 | |
---|
2570 | |
---|
2571 | |
---|
2572 | |
---|
2573 | |
---|
2574 | |
---|
2575 | Reschke [Page 46] |
---|
2576 | |
---|
2577 | Documentation RFC2629 through XSLT December 2007 |
---|
2578 | |
---|
2579 | |
---|
2580 | 2004-05-30 Allow single quote as delimiter in processing |
---|
2581 | instructions as well. Move block-level issue pointers to floats. |
---|
2582 | Disable issue pointers for print media. Add "purple numbers". |
---|
2583 | Add hrefs to section headings. Add non-printing index key letter |
---|
2584 | list to start of index. |
---|
2585 | |
---|
2586 | 2004-06-01 Use ¶ instead of # for PNs. |
---|
2587 | |
---|
2588 | 2004-07-18 Add support for list style=letters (thanks Roy F.). Make |
---|
2589 | PNs optional; add new PI. |
---|
2590 | |
---|
2591 | 2004-09-05 Fix index links into unnumbered sections. Bring IPR |
---|
2592 | boilerplate in-line with xml2rfc 1.25. Add experimental CSS3 |
---|
2593 | paged media support. Various HTML fixes. |
---|
2594 | |
---|
2595 | 2004-09-21 Enhance checking of artwork width. |
---|
2596 | |
---|
2597 | 2004-09-26 Add check for unused references. Uppercase letters in |
---|
2598 | list style letters when nested into another list. |
---|
2599 | |
---|
2600 | 2004-10-10 Fix internal change track pointers. |
---|
2601 | |
---|
2602 | 2004-11-01 Allow change tracking on references (as a whole). |
---|
2603 | Rewrite artwork handling so that it allows change tracking inside |
---|
2604 | artwork. Also allow a subset of text markup inside artwork, such |
---|
2605 | as xrefs (note this requires post-processing the source to make it |
---|
2606 | compliant to RFC2629bis). |
---|
2607 | |
---|
2608 | 2004-11-03 Enhanced placement of iref anchors. |
---|
2609 | |
---|
2610 | 2004-11-06 Index: display irefs that appeared (with primary=true) |
---|
2611 | inside artwork elements in a monospaced font. |
---|
2612 | |
---|
2613 | 2004-11-14 Add special code so that changes in section titles can be |
---|
2614 | change-tracked. |
---|
2615 | |
---|
2616 | 2005-01-14 Bugfixes for HtmlToXhtml converter. |
---|
2617 | |
---|
2618 | 2005-01-22 Enhance generation of HTML h* elements (for Mozilla |
---|
2619 | Outliner). |
---|
2620 | |
---|
2621 | 2005-01-31 Put vertical space around top-level TOC entries in TOC. |
---|
2622 | Switch to pt-based CSS. Re-arrange top section. Make hr elements |
---|
2623 | reflect new-page settings in TXT output (compact-PI). Fix page |
---|
2624 | number in footer (CSS print) and add some more experimental |
---|
2625 | support for paged media (tested with Prince 4.1 alpha). Rewrite |
---|
2626 | TOC and Index generation to generate HTML lists. Cleanup id |
---|
2627 | generation for paragraphs. Reduce whitespace in output. Fix |
---|
2628 | |
---|
2629 | |
---|
2630 | |
---|
2631 | Reschke [Page 47] |
---|
2632 | |
---|
2633 | Documentation RFC2629 through XSLT December 2007 |
---|
2634 | |
---|
2635 | |
---|
2636 | vspace implementation. Use right/left dqoutes and copyright sign |
---|
2637 | where appropriate. |
---|
2638 | |
---|
2639 | 2005-02-04 Add <link> element to references section. Fix newly |
---|
2640 | introduced bug in references processing. |
---|
2641 | |
---|
2642 | 2005-02-05 Integrate various fixes/enhancements by Roy Fielding: |
---|
2643 | spelling of "Authors' Addresses", comma setting in references, |
---|
2644 | position of "Authors" section, optionally place authors addresses |
---|
2645 | at end (PI), trailing dots in section numbers, switch to verdana |
---|
2646 | default font in CSS. Add experimental support for centered |
---|
2647 | artwork. |
---|
2648 | |
---|
2649 | 2005-02-09 Fixes in spacing and links of references section titles. |
---|
2650 | Enhance sorting in references when change tracking is in place. |
---|
2651 | Re-add figure centering support. Add missing 2nd part of |
---|
2652 | "Author's Adresses" fix. |
---|
2653 | |
---|
2654 | 2005-02-25 Align section number format with xml2rfc1.29. |
---|
2655 | |
---|
2656 | 2005-03-28 Get rid of table elements in Author's section. Add |
---|
2657 | experimental hCard (<http://developers.technorati.com/wiki/hCard>) |
---|
2658 | support. |
---|
2659 | |
---|
2660 | 2005-04-03 Add RFC3978-style IPR statement support. |
---|
2661 | (fenner@research.att.com) |
---|
2662 | |
---|
2663 | 2005-04-11 Cleanup author display. hCard related fixes. |
---|
2664 | |
---|
2665 | 2005-05-07 Minor fixes to allow change tracking in doc title. Add |
---|
2666 | experimental support for table border styles. CSS cleanup. |
---|
2667 | |
---|
2668 | 2005-06-18 Implement missing support for references to texttables. |
---|
2669 | |
---|
2670 | 2005-09-25 Use (-moz-)column-count when printing the index. |
---|
2671 | |
---|
2672 | 2005-10-04 Report missing element templates with xsl:message. |
---|
2673 | |
---|
2674 | 2005-10-15 Process t/@anchor. |
---|
2675 | |
---|
2676 | 2005-10-23 More workarounds for Mozilla's broken del/ins handling |
---|
2677 | (this time for figures). |
---|
2678 | |
---|
2679 | 2005-10-27 lowercase hCard class names |
---|
2680 | |
---|
2681 | |
---|
2682 | |
---|
2683 | |
---|
2684 | |
---|
2685 | |
---|
2686 | |
---|
2687 | Reschke [Page 48] |
---|
2688 | |
---|
2689 | Documentation RFC2629 through XSLT December 2007 |
---|
2690 | |
---|
2691 | |
---|
2692 | 2005-11-22 Enhance diagnostics for XML-in-artwork extension |
---|
2693 | |
---|
2694 | 2005-11-26 Fix formatting of section numbers for sections inserted |
---|
2695 | into <back>. |
---|
2696 | |
---|
2697 | 2005-12-12 Fix some validity problems when change tracking occured |
---|
2698 | inside lists. |
---|
2699 | |
---|
2700 | 2005-12-18 Add change tracking inside the index. |
---|
2701 | |
---|
2702 | 2006-02-04 Add prev/next links to highlighted changes (change |
---|
2703 | tracking extension). |
---|
2704 | |
---|
2705 | 2006-02-10 Catch errors instantiating MSXML component. |
---|
2706 | |
---|
2707 | 2006-02-11 References: add "work in progress" for Internet Drafts. |
---|
2708 | |
---|
2709 | 2006-02-27 Fix front matter (lowercase Internet-Draft, say "Intended |
---|
2710 | status" for non-RFC documents). Start work on experimental |
---|
2711 | extension for simplified internal links. |
---|
2712 | |
---|
2713 | 2006-03-19 Tweaks to IESG Copyright stuff; support submissionType |
---|
2714 | attribute. Fix duplicate reference anchors in HTML output. |
---|
2715 | Reduce HTML Tidy warnings. Fix reference to normative ASCII |
---|
2716 | version (now requires trailing ".txt"). Tweaks to hCard |
---|
2717 | generation. Started to move non-issue-tracking extensions into |
---|
2718 | namespace "http://purl.org/net/xml2rfc/ext". |
---|
2719 | |
---|
2720 | 2006-03-27 Moved "simple reference" extension into namespace |
---|
2721 | "http://purl.org/net/xml2rfc/ext" and add documentation. HTML |
---|
2722 | conformance enhancements. |
---|
2723 | |
---|
2724 | 2006-04-02 Cleanup special code for automated XHTML XSLT generation. |
---|
2725 | |
---|
2726 | 2006-04-21 Generate <CITE> elements where appropiate. Introduce |
---|
2727 | x:blockquote, x:dfn, x:h and x:q elements. |
---|
2728 | |
---|
2729 | 2006-05-06 Introduce x:bcp14 element. |
---|
2730 | |
---|
2731 | 2006-05-14 Fix content model for x:blockquote. |
---|
2732 | |
---|
2733 | 2006-06-18 Add box drawing support (x:bt, x:bc, x:bb). |
---|
2734 | |
---|
2735 | 2006-06-20 HTML validity fixes (legal chars in anchors in index). |
---|
2736 | |
---|
2737 | |
---|
2738 | |
---|
2739 | |
---|
2740 | |
---|
2741 | |
---|
2742 | |
---|
2743 | Reschke [Page 49] |
---|
2744 | |
---|
2745 | Documentation RFC2629 through XSLT December 2007 |
---|
2746 | |
---|
2747 | |
---|
2748 | 2006-06-24 Reduce leading empty lines in artwork. Move <dt> style |
---|
2749 | info into CSS. |
---|
2750 | |
---|
2751 | 2006-07-14 Fix rendering of multiple street address entries (missing |
---|
2752 | line break). |
---|
2753 | |
---|
2754 | 2006-07-24 Add extension for deep linking into RFCs, do not generate |
---|
2755 | empty list items in TOC output, avoid empty <dt> elements for list |
---|
2756 | items without hangText attribute. |
---|
2757 | |
---|
2758 | 2006-08-01 Allow @anchor on more elements; start work on Relax NG |
---|
2759 | grammar for extensions. Reduce generated style elements (use CSS |
---|
2760 | classes instead). Consistently use "id" instead of "name". |
---|
2761 | Change default target for RFC links to |
---|
2762 | "http://tools.ietf.org/html/rfcNNNN". |
---|
2763 | |
---|
2764 | 2006-08-06 Include appendices defined in <appendix> elements in TOC |
---|
2765 | (please consider them deprecated anyhow!). Generate links to |
---|
2766 | "http://tools.ietf.org/html/draft-*" for Internet Drafts. Replace |
---|
2767 | x:frag by x:rel, allowing any kind of relative reference instead |
---|
2768 | of just fragments. |
---|
2769 | |
---|
2770 | 2006-08-30 Reduce textual differences between HTML output and what |
---|
2771 | xml2rfc produces in TXT output mode (section refs/reference |
---|
2772 | targets). Add small workaround for Opera 9.0.1's problem with |
---|
2773 | node-set(). |
---|
2774 | |
---|
2775 | 2006-10-29 Fix problem generating internal links to change markup |
---|
2776 | within references section. Enhancements when generating numbered |
---|
2777 | references for deleted references. Allow inclusion of references |
---|
2778 | into the index (through include-references-in-index extension). |
---|
2779 | Fix a bug that caused the newer version of the IETF boilerplate to |
---|
2780 | be produced rather than the pre-RFC3667 one. Update to RFC4287 |
---|
2781 | boilerplate. |
---|
2782 | |
---|
2783 | 2006-11-11 Add extension attribute x:for-anchor to <iref> handling. |
---|
2784 | |
---|
2785 | 2006-11-26 Experimental (and limited) support for <x:lt>. |
---|
2786 | |
---|
2787 | 2006-12-04 Fix bugs in processing documents that have both the ipr |
---|
2788 | and the number attribute set on the rfc root element. Add support |
---|
2789 | for x:fmt='none' on xrefs. Add different pre style based on |
---|
2790 | artwork type attributes (experimental). |
---|
2791 | |
---|
2792 | 2006-12-13 Add x:fmt='anchor' for xref elements. |
---|
2793 | |
---|
2794 | |
---|
2795 | |
---|
2796 | |
---|
2797 | |
---|
2798 | |
---|
2799 | Reschke [Page 50] |
---|
2800 | |
---|
2801 | Documentation RFC2629 through XSLT December 2007 |
---|
2802 | |
---|
2803 | |
---|
2804 | 2007-01-07 Fix root template for compatibility for the exslt:node- |
---|
2805 | set implementation in Firefox3. |
---|
2806 | |
---|
2807 | 2007-01-29 Avoid empty table entry in front matter when organization |
---|
2808 | is not specified for an author. |
---|
2809 | |
---|
2810 | 2007-02-10 Allow change tracking in table rows. |
---|
2811 | |
---|
2812 | 2007-03-09 Add hcard profile URI (<http://www.w3.org/2006/03/hcard>) |
---|
2813 | to head element. Add warning for misplaced <t> elements (after |
---|
2814 | section). |
---|
2815 | |
---|
2816 | 2007-03-21 Fix internal linking from reference entries in index for |
---|
2817 | some xref types. Minor CSS tweaks contributed by MTR. Allow |
---|
2818 | turning on text justification through a PI. Improve iref anchor |
---|
2819 | generation to generate less instable anchors. |
---|
2820 | |
---|
2821 | 2007-03-28 Fixes for numbering of ed:inserted references sections. |
---|
2822 | |
---|
2823 | 2007-05-04 Do not generate anchors for edits in deleted sections. |
---|
2824 | Enhance HTML conformance. |
---|
2825 | |
---|
2826 | 2007-05-19 Enhance diagnostics when using Saxon (needs Saxon's "-l" |
---|
2827 | command line parameter to keep line number information). Add |
---|
2828 | warning when symref PI is missing (default will change in the |
---|
2829 | future). Add support for overriding computed section numbers |
---|
2830 | (when formatting historic documents). |
---|
2831 | |
---|
2832 | 2007-06-07 Change default for symrefs PI to "yes" (see change in |
---|
2833 | xml2rfc 1.33pre4). Warn about docName attributes that appear to |
---|
2834 | contain a file extension. |
---|
2835 | |
---|
2836 | 2007-06-26 Workaround author/@initials values without trailing dot, |
---|
2837 | as in xml2rfc.tcl. |
---|
2838 | |
---|
2839 | 2007-07-14 Enhance index generation for references that use @x:sec |
---|
2840 | attribute. |
---|
2841 | |
---|
2842 | 2007-09-09 Fix: sortrefs is a nop when symrefs=no. |
---|
2843 | |
---|
2844 | 2007-10-17 Work in progress: add support for referencing sections in |
---|
2845 | sibling documents by anchor name. |
---|
2846 | |
---|
2847 | 2007-10-17 Work in progress (continued): support for referencing |
---|
2848 | sections in sibling documents by anchor name. |
---|
2849 | |
---|
2850 | |
---|
2851 | |
---|
2852 | |
---|
2853 | |
---|
2854 | |
---|
2855 | Reschke [Page 51] |
---|
2856 | |
---|
2857 | Documentation RFC2629 through XSLT December 2007 |
---|
2858 | |
---|
2859 | |
---|
2860 | D.6. rfc2629toFO.xslt |
---|
2861 | |
---|
2862 | 2003-11-16 Initial release. |
---|
2863 | |
---|
2864 | 2003-11-29 Enhance handling of unknown list styles. |
---|
2865 | |
---|
2866 | 2004-04-04 Update reference section handling. |
---|
2867 | |
---|
2868 | 2004-04-17 Use XSL-WD-1.1-style fo:bookmark and index handling and |
---|
2869 | add postprocessors for existing implementations. Unify PDF info |
---|
2870 | generation by using XEP (postprocessors) will convert. |
---|
2871 | |
---|
2872 | 2004-04-20 Add experimental cref support. |
---|
2873 | |
---|
2874 | 2004-06-14 Set correct index-item defaults. |
---|
2875 | |
---|
2876 | 2004-07-18 Add list style=letters. |
---|
2877 | |
---|
2878 | 2004-09-03 Make URLs in text break where they are allowed to break |
---|
2879 | by inserting zero-width spaces. |
---|
2880 | |
---|
2881 | 2004-09-26 Fix letter-style inside nested lists. |
---|
2882 | |
---|
2883 | 2004-10-31 Update handling of artwork. |
---|
2884 | |
---|
2885 | 2004-11-13 Fix handling of references inside ed:* markup. Fix |
---|
2886 | whitespace handling in artwork. |
---|
2887 | |
---|
2888 | 2004-11-27 Irefs in artwork generate monospaced entries in index. |
---|
2889 | |
---|
2890 | 2005-01-31 Fix TOC generation that was broken after changes in main |
---|
2891 | XSLT. |
---|
2892 | |
---|
2893 | 2005-02-05 Bring in sync with cosmetic changes in rfc2629.xslt. |
---|
2894 | |
---|
2895 | 2005-05-07 Minor fix for change tracking in document title. Support |
---|
2896 | for table styles. |
---|
2897 | |
---|
2898 | 2005-06-18 Fix references to tables. |
---|
2899 | |
---|
2900 | 2005-10-15 Process t/@anchor. |
---|
2901 | |
---|
2902 | 2006-02-11 References: add "work in progress" for Internet Drafts. |
---|
2903 | |
---|
2904 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
2905 | |
---|
2906 | |
---|
2907 | |
---|
2908 | |
---|
2909 | |
---|
2910 | |
---|
2911 | Reschke [Page 52] |
---|
2912 | |
---|
2913 | Documentation RFC2629 through XSLT December 2007 |
---|
2914 | |
---|
2915 | |
---|
2916 | 2007-03-21 Support optional text justification. |
---|
2917 | |
---|
2918 | 2007-05-19 Various improvements in spacing; also allow overriding |
---|
2919 | the automatic list indentation via list/x:indent. |
---|
2920 | |
---|
2921 | D.7. xsl11toAn.xslt |
---|
2922 | |
---|
2923 | 2004-05-17 Initial release. |
---|
2924 | |
---|
2925 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
2926 | |
---|
2927 | D.8. xsl11toFop.xslt |
---|
2928 | |
---|
2929 | 2004-05-17 Initial release. |
---|
2930 | |
---|
2931 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
2932 | |
---|
2933 | D.9. xsl11toXep.xslt |
---|
2934 | |
---|
2935 | 2004-05-17 Initial release. |
---|
2936 | |
---|
2937 | 2004-09-04 Fix xep:index-item attributes. |
---|
2938 | |
---|
2939 | 2006-06-02 Use XSL 1.1 WD Feb 2006. |
---|
2940 | |
---|
2941 | |
---|
2942 | |
---|
2943 | |
---|
2944 | |
---|
2945 | |
---|
2946 | |
---|
2947 | |
---|
2948 | |
---|
2949 | |
---|
2950 | |
---|
2951 | |
---|
2952 | |
---|
2953 | |
---|
2954 | |
---|
2955 | |
---|
2956 | |
---|
2957 | |
---|
2958 | |
---|
2959 | |
---|
2960 | |
---|
2961 | |
---|
2962 | |
---|
2963 | |
---|
2964 | |
---|
2965 | |
---|
2966 | |
---|
2967 | Reschke [Page 53] |
---|
2968 | |
---|
2969 | Documentation RFC2629 through XSLT December 2007 |
---|
2970 | |
---|
2971 | |
---|
2972 | Index |
---|
2973 | |
---|
2974 | A |
---|
2975 | allow-markup-in-artwork PI pseudo-attribute 8 |
---|
2976 | alternate HTML LINK element 15 |
---|
2977 | anchor-alias Extension Element 21, 32 |
---|
2978 | Anchors |
---|
2979 | rfc.abstract 12 |
---|
2980 | rfc.authors 12 |
---|
2981 | rfc.copyright 12 |
---|
2982 | rfc.copyrightnotice 12 |
---|
2983 | rfc.figure.n 12 |
---|
2984 | rfc.figure.u.n 12 |
---|
2985 | rfc.index 12 |
---|
2986 | rfc.ipr 12 |
---|
2987 | rfc.iref.n 12 |
---|
2988 | rfc.note.n 12 |
---|
2989 | rfc.references 12 |
---|
2990 | rfc.section.n 12 |
---|
2991 | rfc.section.n.p.m 12 |
---|
2992 | rfc.status 12 |
---|
2993 | rfc.toc 12 |
---|
2994 | rfc.xref.name.n 12 |
---|
2995 | AntennaHouse XSL Formatter 19 |
---|
2996 | Apache FOP 19 |
---|
2997 | appendix HTML LINK element 15 |
---|
2998 | assign-section-number Extension Element 32 |
---|
2999 | author HTML LINK element 15 |
---|
3000 | authors-section PI pseudo-attribute 8 |
---|
3001 | |
---|
3002 | B |
---|
3003 | background PI pseudo-attribute 6 |
---|
3004 | bb Extension Element 21, 32 |
---|
3005 | bc Extension Element 22, 32 |
---|
3006 | bcp14 Extension Element 21, 32 |
---|
3007 | blockquote Extension Element 22, 32 |
---|
3008 | bt Extension Element 22, 32 |
---|
3009 | |
---|
3010 | C |
---|
3011 | chapter HTML LINK element 15 |
---|
3012 | CHM format 18 |
---|
3013 | comments PI pseudo-attribute 6 |
---|
3014 | compact PI pseudo-attribute 6 |
---|
3015 | contents HTML LINK element 15 |
---|
3016 | copyright HTML LINK element 15 |
---|
3017 | Creator DCMI property 16 |
---|
3018 | |
---|
3019 | D |
---|
3020 | |
---|
3021 | |
---|
3022 | |
---|
3023 | Reschke [Page 54] |
---|
3024 | |
---|
3025 | Documentation RFC2629 through XSLT December 2007 |
---|
3026 | |
---|
3027 | |
---|
3028 | Date.Issued DCMI property 16 |
---|
3029 | DCMI properties |
---|
3030 | Creator 16 |
---|
3031 | Date.Issued 16 |
---|
3032 | Description.Abstract 16 |
---|
3033 | Identifier 16 |
---|
3034 | Relation.Replaces 16 |
---|
3035 | Description.Abstract DCMI property 16 |
---|
3036 | dfn Extension Element 22, 32 |
---|
3037 | |
---|
3038 | E |
---|
3039 | editing PI pseudo-attribute 6 |
---|
3040 | Extension Elements |
---|
3041 | anchor-alias 21, 32 |
---|
3042 | assign-section-number 32 |
---|
3043 | bb 21, 32 |
---|
3044 | bc 22, 32 |
---|
3045 | bcp14 21, 32 |
---|
3046 | blockquote 22, 32 |
---|
3047 | bt 22, 32 |
---|
3048 | dfn 22, 32 |
---|
3049 | h 22, 32 |
---|
3050 | link 22, 32 |
---|
3051 | lt 22, 32 |
---|
3052 | q 22, 32 |
---|
3053 | ref 23, 32 |
---|
3054 | source 23, 32 |
---|
3055 | |
---|
3056 | F |
---|
3057 | Firefox |
---|
3058 | 1.*/2.* 13 |
---|
3059 | 3.* 13 |
---|
3060 | footer PI pseudo-attribute 6 |
---|
3061 | |
---|
3062 | G |
---|
3063 | generator HTML META element 16 |
---|
3064 | Grammar 32 |
---|
3065 | |
---|
3066 | H |
---|
3067 | h Extension Element 22, 32 |
---|
3068 | header PI pseudo-attribute 6 |
---|
3069 | HTML compliance 15 |
---|
3070 | HTML LINK elements |
---|
3071 | alternate 15 |
---|
3072 | appendix 15 |
---|
3073 | author 15 |
---|
3074 | chapter 15 |
---|
3075 | contents 15 |
---|
3076 | |
---|
3077 | |
---|
3078 | |
---|
3079 | Reschke [Page 55] |
---|
3080 | |
---|
3081 | Documentation RFC2629 through XSLT December 2007 |
---|
3082 | |
---|
3083 | |
---|
3084 | copyright 15 |
---|
3085 | index 15 |
---|
3086 | HTML META elements |
---|
3087 | generator 16 |
---|
3088 | keywords 16 |
---|
3089 | |
---|
3090 | I |
---|
3091 | Identifier DCMI property 16 |
---|
3092 | include PI pseudo-attribute 7 |
---|
3093 | include-references-in-index PI pseudo-attribute 8 |
---|
3094 | index HTML LINK element 15 |
---|
3095 | inline PI pseudo-attribute 6 |
---|
3096 | Internet Explorer 5.5 13 |
---|
3097 | Internet Explorer 6 13 |
---|
3098 | Internet Explorer 7 13 |
---|
3099 | iprnotified PI pseudo-attribute 6 |
---|
3100 | |
---|
3101 | J |
---|
3102 | justification PI pseudo-attribute 8 |
---|
3103 | |
---|
3104 | K |
---|
3105 | keywords HTML META element 16 |
---|
3106 | |
---|
3107 | L |
---|
3108 | link Extension Element 22, 32 |
---|
3109 | linkmailto PI pseudo-attribute 6 |
---|
3110 | lt Extension Element 22, 32 |
---|
3111 | |
---|
3112 | M |
---|
3113 | Microsoft Help 18 |
---|
3114 | Mozilla 13 |
---|
3115 | MSXML3 13 |
---|
3116 | MSXML4 13 |
---|
3117 | |
---|
3118 | N |
---|
3119 | needLines PI pseudo-attribute 7 |
---|
3120 | |
---|
3121 | O |
---|
3122 | Opera 13 |
---|
3123 | 9.5 13 |
---|
3124 | |
---|
3125 | P |
---|
3126 | Parameters |
---|
3127 | xml2rfc-background 6 |
---|
3128 | xml2rfc-comments 6 |
---|
3129 | xml2rfc-compact 6 |
---|
3130 | xml2rfc-editing 6 |
---|
3131 | xml2rfc-ext-allow-markup-in-artwork 8 |
---|
3132 | |
---|
3133 | |
---|
3134 | |
---|
3135 | Reschke [Page 56] |
---|
3136 | |
---|
3137 | Documentation RFC2629 through XSLT December 2007 |
---|
3138 | |
---|
3139 | |
---|
3140 | xml2rfc-ext-authors-section 8 |
---|
3141 | xml2rfc-ext-include-references-in-index 8 |
---|
3142 | xml2rfc-ext-justification 8 |
---|
3143 | xml2rfc-ext-parse-xml-in-artwork 8 |
---|
3144 | xml2rfc-ext-sec-no-trailing-dots 8 |
---|
3145 | xml2rfc-ext-support-rfc2731 8 |
---|
3146 | xml2rfc-footer 6 |
---|
3147 | xml2rfc-header 6 |
---|
3148 | xml2rfc-inline 6 |
---|
3149 | xml2rfc-iprnotified 6 |
---|
3150 | xml2rfc-linkmailto 6 |
---|
3151 | xml2rfc-private 6 |
---|
3152 | xml2rfc-sortrefs 6 |
---|
3153 | xml2rfc-symrefs 6 |
---|
3154 | xml2rfc-toc 6 |
---|
3155 | xml2rfc-tocdepth 6 |
---|
3156 | xml2rfc-topblock 6 |
---|
3157 | parse-xml-in-artwork PI pseudo-attribute 8 |
---|
3158 | private PI pseudo-attribute 6 |
---|
3159 | Processing Instruction pseudo attributes |
---|
3160 | allow-markup-in-artwork 8 |
---|
3161 | authors-section 8 |
---|
3162 | background 6 |
---|
3163 | comments 6 |
---|
3164 | compact 6 |
---|
3165 | editing 6 |
---|
3166 | footer 6 |
---|
3167 | header 6 |
---|
3168 | ijustification 8 |
---|
3169 | include 7 |
---|
3170 | include-references-in-index 8 |
---|
3171 | inline 6 |
---|
3172 | iprnotified 6 |
---|
3173 | linkmailto 6 |
---|
3174 | needLines 7 |
---|
3175 | parse-xml-in-artwork 8 |
---|
3176 | private 6 |
---|
3177 | sec-no-trailing-dots 8 |
---|
3178 | slides 7 |
---|
3179 | sortrefs 6 |
---|
3180 | strict 7 |
---|
3181 | subcompact 7 |
---|
3182 | support-rfc2731 8 |
---|
3183 | symrefs 6 |
---|
3184 | toc 6 |
---|
3185 | tocdepth 6 |
---|
3186 | tocindent 7 |
---|
3187 | tocompact 7 |
---|
3188 | |
---|
3189 | |
---|
3190 | |
---|
3191 | Reschke [Page 57] |
---|
3192 | |
---|
3193 | Documentation RFC2629 through XSLT December 2007 |
---|
3194 | |
---|
3195 | |
---|
3196 | topblock 6 |
---|
3197 | |
---|
3198 | Q |
---|
3199 | q Extension Element 22, 32 |
---|
3200 | |
---|
3201 | R |
---|
3202 | ref Extension Element 23, 32 |
---|
3203 | Relation.Replaces DCMI property 16 |
---|
3204 | RELAX NG Compact Schema 32 |
---|
3205 | rfc.abstract anchor 12 |
---|
3206 | rfc.authors anchor 12 |
---|
3207 | rfc.copyright anchor 12 |
---|
3208 | rfc.copyrightnotice anchor 12 |
---|
3209 | rfc.figure.n anchor 12 |
---|
3210 | rfc.figure.u.n anchor 12 |
---|
3211 | rfc.index anchor 12 |
---|
3212 | rfc.ipr anchor 12 |
---|
3213 | rfc.iref.n anchor 12 |
---|
3214 | rfc.note.n anchor 12 |
---|
3215 | rfc.references anchor 12 |
---|
3216 | rfc.references.n anchor 12 |
---|
3217 | rfc.section.n anchor 12 |
---|
3218 | rfc.section.n.p.m anchor 12 |
---|
3219 | rfc.status anchor 12 |
---|
3220 | rfc.toc anchor 12 |
---|
3221 | rfc.xref.name.n anchor 12 |
---|
3222 | |
---|
3223 | S |
---|
3224 | Safari 13 |
---|
3225 | 3.* 13 |
---|
3226 | Saxon 13 |
---|
3227 | Schema 32 |
---|
3228 | sec-no-trailing-dots PI pseudo-attribute 8 |
---|
3229 | slides PI pseudo-attribute 7 |
---|
3230 | sortrefs PI pseudo-attribute 6 |
---|
3231 | source Extension Element 23, 32 |
---|
3232 | strict PI pseudo-attribute 7 |
---|
3233 | subcompact PI pseudo-attribute 7 |
---|
3234 | support-rfc2731 PI pseudo-attribute 8 |
---|
3235 | symrefs PI pseudo-attribute 6 |
---|
3236 | |
---|
3237 | T |
---|
3238 | toc PI pseudo-attribute 6 |
---|
3239 | tocdepth PI pseudo-attribute 6 |
---|
3240 | tocindent PI pseudo-attribute 7 |
---|
3241 | tocompact PI pseudo-attribute 7 |
---|
3242 | topblock PI pseudo-attribute 6 |
---|
3243 | |
---|
3244 | |
---|
3245 | |
---|
3246 | |
---|
3247 | Reschke [Page 58] |
---|
3248 | |
---|
3249 | Documentation RFC2629 through XSLT December 2007 |
---|
3250 | |
---|
3251 | |
---|
3252 | X |
---|
3253 | Xalan 13 |
---|
3254 | xml-stylesheet PI 15 |
---|
3255 | xml2rfc-background parameter 6 |
---|
3256 | xml2rfc-comments parameter 6 |
---|
3257 | xml2rfc-editing parameter 6 |
---|
3258 | xml2rfc-ext-allow-markup-in-artwork parameter 8 |
---|
3259 | xml2rfc-ext-authors-section parameter 8 |
---|
3260 | xml2rfc-ext-include-references-in-index parameter 8 |
---|
3261 | xml2rfc-ext-justification parameter 8 |
---|
3262 | xml2rfc-ext-parse-xml-in-artwork parameter 8 |
---|
3263 | xml2rfc-ext-sec-no-trailing-dots parameter 8 |
---|
3264 | xml2rfc-ext-support-rfc2731 parameter 8 |
---|
3265 | xml2rfc-footer parameter 6 |
---|
3266 | xml2rfc-header parameter 6 |
---|
3267 | xml2rfc-inline parameter 6 |
---|
3268 | xml2rfc-iprnotified parameter 6 |
---|
3269 | xml2rfc-linkmailto parameter 6 |
---|
3270 | xml2rfc-private parameter 6 |
---|
3271 | xml2rfc-sortrefs parameter 6 |
---|
3272 | xml2rfc-symrefs parameter 6 |
---|
3273 | xml2rfc-toc parameter 6 |
---|
3274 | xml2rfc-tocdepth parameter 6 |
---|
3275 | xml2rfc-topblock parameter 6 |
---|
3276 | xsltproc 13 |
---|
3277 | passing parameters 5 |
---|
3278 | |
---|
3279 | |
---|
3280 | |
---|
3281 | |
---|
3282 | |
---|
3283 | |
---|
3284 | |
---|
3285 | |
---|
3286 | |
---|
3287 | |
---|
3288 | |
---|
3289 | |
---|
3290 | |
---|
3291 | |
---|
3292 | |
---|
3293 | |
---|
3294 | |
---|
3295 | |
---|
3296 | |
---|
3297 | |
---|
3298 | |
---|
3299 | |
---|
3300 | |
---|
3301 | |
---|
3302 | |
---|
3303 | Reschke [Page 59] |
---|
3304 | |
---|
3305 | Documentation RFC2629 through XSLT December 2007 |
---|
3306 | |
---|
3307 | |
---|
3308 | Author's Address |
---|
3309 | |
---|
3310 | Julian F. Reschke |
---|
3311 | greenbytes GmbH |
---|
3312 | Hafenweg 16 |
---|
3313 | Muenster, NW 48155 |
---|
3314 | Germany |
---|
3315 | |
---|
3316 | Phone: +49 251 2807760 |
---|
3317 | Email: julian.reschke@greenbytes.de |
---|
3318 | URI: http://greenbytes.de/tech/webdav/ |
---|
3319 | |
---|
3320 | |
---|
3321 | |
---|
3322 | |
---|
3323 | |
---|
3324 | |
---|
3325 | |
---|
3326 | |
---|
3327 | |
---|
3328 | |
---|
3329 | |
---|
3330 | |
---|
3331 | |
---|
3332 | |
---|
3333 | |
---|
3334 | |
---|
3335 | |
---|
3336 | |
---|
3337 | |
---|
3338 | |
---|
3339 | |
---|
3340 | |
---|
3341 | |
---|
3342 | |
---|
3343 | |
---|
3344 | |
---|
3345 | |
---|
3346 | |
---|
3347 | |
---|
3348 | |
---|
3349 | |
---|
3350 | |
---|
3351 | |
---|
3352 | |
---|
3353 | |
---|
3354 | |
---|
3355 | |
---|
3356 | |
---|
3357 | |
---|
3358 | |
---|
3359 | Reschke [Page 60] |
---|
3360 | |
---|