source: rfc2629xslt/rfc2629xslt.txt @ 272

Last change on this file since 272 was 272, checked in by julian.reschke@…, 13 years ago

Update to latest version of rfc2629.xslt, and take advantage of it.

  • Property svn:eol-style set to native
File size: 99.5 KB
Line 
1
2
3
4RFC2629 through XSLT                                          J. Reschke
5                                                              greenbytes
6                                                            July 6, 2008
7
8
9            Transforming RFC2629-formatted XML through XSLT
10
11
12Table 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.  <abnf-char-sequence> element  . . . . . . . . . . . . . . 21
40     10.2.  <anchor-alias> element  . . . . . . . . . . . . . . . . . 21
41     10.3.  <bcp14> element . . . . . . . . . . . . . . . . . . . . . 21
42     10.4.  <bb> element  . . . . . . . . . . . . . . . . . . . . . . 22
43     10.5.  <bc> element  . . . . . . . . . . . . . . . . . . . . . . 22
44     10.6.  <blockquote> element  . . . . . . . . . . . . . . . . . . 22
45     10.7.  <bt> element  . . . . . . . . . . . . . . . . . . . . . . 22
46     10.8.  <dfn> element . . . . . . . . . . . . . . . . . . . . . . 23
47     10.9.  <h> element . . . . . . . . . . . . . . . . . . . . . . . 23
48     10.10. <length-of> element . . . . . . . . . . . . . . . . . . . 23
49     10.11. <link> element  . . . . . . . . . . . . . . . . . . . . . 23
50     10.12. <lt> element  . . . . . . . . . . . . . . . . . . . . . . 23
51     10.13. <q> element . . . . . . . . . . . . . . . . . . . . . . . 24
52
53
54
55Reschke                                                         [Page 1]
56
57Documentation             RFC2629 through XSLT                 July 2008
58
59
60     10.14. <ref> element . . . . . . . . . . . . . . . . . . . . . . 24
61     10.15. <source> element  . . . . . . . . . . . . . . . . . . . . 24
62     10.16. <sup> element . . . . . . . . . . . . . . . . . . . . . . 25
63     10.17. Extensions to Xml2rfc <iref> element  . . . . . . . . . . 25
64     10.18. Extensions to Xml2rfc <list> element  . . . . . . . . . . 25
65     10.19. Extensions to Xml2rfc <section> element . . . . . . . . . 25
66     10.20. Extensions to Xml2rfc <xref> element  . . . . . . . . . . 25
67   11. Utilities  . . . . . . . . . . . . . . . . . . . . . . . . . . 27
68     11.1.  Checking References . . . . . . . . . . . . . . . . . . . 27
69     11.2.  Generating Graphs from References . . . . . . . . . . . . 28
70     11.3.  Producing reference entries for books . . . . . . . . . . 28
71     11.4.  Down-converting to RFC2629bis DTD . . . . . . . . . . . . 29
72     11.5.  Extracting artwork  . . . . . . . . . . . . . . . . . . . 30
73     11.6.  GRRDL . . . . . . . . . . . . . . . . . . . . . . . . . . 30
74   12. Informative References . . . . . . . . . . . . . . . . . . . . 31
75   Appendix A.  RELAX NG Compact Schema . . . . . . . . . . . . . . . 33
76   Appendix B.  Implementation Notes  . . . . . . . . . . . . . . . . 41
77     B.1.   Recognized type attributes for <artwork> element  . . . . 41
78   Appendix C.  License . . . . . . . . . . . . . . . . . . . . . . . 42
79   Appendix D.  Change Logs . . . . . . . . . . . . . . . . . . . . . 43
80     D.1.   Package . . . . . . . . . . . . . . . . . . . . . . . . . 43
81     D.2.   amazon-asin.xslt  . . . . . . . . . . . . . . . . . . . . 43
82     D.3.   check-references.xslt . . . . . . . . . . . . . . . . . . 43
83     D.4.   gen-reference-graph.xslt  . . . . . . . . . . . . . . . . 44
84     D.5.   rfc2629.xslt  . . . . . . . . . . . . . . . . . . . . . . 44
85     D.6.   rfc2629toFO.xslt  . . . . . . . . . . . . . . . . . . . . 54
86     D.7.   xsl11toAn.xslt  . . . . . . . . . . . . . . . . . . . . . 55
87     D.8.   xsl11toFop.xslt . . . . . . . . . . . . . . . . . . . . . 55
88     D.9.   xsl11toFop-0.93.xslt  . . . . . . . . . . . . . . . . . . 56
89     D.10.  xsl11toXep.xslt . . . . . . . . . . . . . . . . . . . . . 56
90   Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
91   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 64
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111Reschke                                                         [Page 2]
112
113Documentation             RFC2629 through XSLT                 July 2008
114
115
1161.  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
167Reschke                                                         [Page 3]
168
169Documentation             RFC2629 through XSLT                 July 2008
170
171
1722.  Supported RFC2629 elements
173
174   "rfc2629.xslt" supports both all RFC2629 grammar elements and the
175   extensions implemented in xml2rfc 1.21.
176
1772.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
223Reschke                                                         [Page 4]
224
225Documentation             RFC2629 through XSLT                 July 2008
226
227
2283.  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
279Reschke                                                         [Page 5]
280
281Documentation             RFC2629 through XSLT                 July 2008
282
283
2843.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
335Reschke                                                         [Page 6]
336
337Documentation             RFC2629 through XSLT                 July 2008
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
3593.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
391Reschke                                                         [Page 7]
392
393Documentation             RFC2629 through XSLT                 July 2008
394
395
3963.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
447Reschke                                                         [Page 8]
448
449Documentation             RFC2629 through XSLT                 July 2008
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
503Reschke                                                         [Page 9]
504
505Documentation             RFC2629 through XSLT                 July 2008
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
559Reschke                                                        [Page 10]
560
561Documentation             RFC2629 through XSLT                 July 2008
562
563
5644.  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
615Reschke                                                        [Page 11]
616
617Documentation             RFC2629 through XSLT                 July 2008
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
671Reschke                                                        [Page 12]
672
673Documentation             RFC2629 through XSLT                 July 2008
674
675
6765.  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
6835.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
6985.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.* (release candidate available)
709
710   o  Safari 3 (starting with version 3.0.4)
711
712   The following browsers are known not to work properly:
713
714   o  Firefox 1.*/2.* (missing extension function - see change request
715      at Mozilla BugZilla 193678 [2])
716
717   o  Opera 9.21: execution fails, potentially to a somewhat complex
718      XPath expression (reported to Opera as bug 245725).  Opera 9.5:
719      transformation appears to work, but CSS isn't getting applied
720      (repored to Opera as bug 337388 on 2008-06-12).
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
727Reschke                                                        [Page 13]
728
729Documentation             RFC2629 through XSLT                 July 2008
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
783Reschke                                                        [Page 14]
784
785Documentation             RFC2629 through XSLT                 July 2008
786
787
7886.  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
7986.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
8046.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
839Reschke                                                        [Page 15]
840
841Documentation             RFC2629 through XSLT                 July 2008
842
843
8446.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
8566.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
8806.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
895Reschke                                                        [Page 16]
896
897Documentation             RFC2629 through XSLT                 July 2008
898
899
9007.  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
951Reschke                                                        [Page 17]
952
953Documentation             RFC2629 through XSLT                 July 2008
954
955
9568.  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
1007Reschke                                                        [Page 18]
1008
1009Documentation             RFC2629 through XSLT                 July 2008
1010
1011
10129.  Transforming to PDF via XSL-FO
1013
10149.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
10369.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
1063Reschke                                                        [Page 19]
1064
1065Documentation             RFC2629 through XSLT                 July 2008
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
10789.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
10859.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
1119Reschke                                                        [Page 20]
1120
1121Documentation             RFC2629 through XSLT                 July 2008
1122
1123
112410.  Generic Extensions
1125
1126   This section documents extensions implemented in "rfc2629.xslt",
1127   using the extension namespace "http://purl.org/net/xml2rfc/ext".
1128
112910.1.  <abnf-char-sequence> element
1130
1131   Converts the contained quoted string into a hex-encoded character
1132   sequence, for use in case-sensitive ABNF productions.
1133
1134   For instance, "<x:abnf-char-sequence>"HTTP"</x:abnf-char-sequence>"
1135   gets converted to "%x48.54.54.50".
1136
113710.2.  <anchor-alias> element
1138
1139   Using its "value" attribute, this element allows the definition of an
1140   internal link target alias for the enclosing element.  This alias can
1141   then be used with the <ref> element for intra-document references.
1142
1143   Note that the anchor alias is not subject to the naming constraints
1144   that apply to anchor elements (which are XML names).
1145
114610.3.  <bcp14> element
1147
1148   This element marks the content as being one of the normative keywords
1149   defined in [RFC2119].
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175Reschke                                                        [Page 21]
1176
1177Documentation             RFC2629 through XSLT                 July 2008
1178
1179
1180   The DOCTYPE definition below allows using these keywords using XML
1181   entity expansion: such as in "...server &MUST; accept...".
1182
1183   <!DOCTYPE rfc [
1184    <!ENTITY MAY "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1185      >MAY</bcp14>">
1186    <!ENTITY MUST "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1187      >MUST</bcp14>">
1188    <!ENTITY MUST-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1189      >MUST NOT</bcp14>">
1190    <!ENTITY OPTIONAL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1191      >OPTIONAL</bcp14>">
1192    <!ENTITY RECOMMENDED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1193      >RECOMMENDED</bcp14>">
1194    <!ENTITY REQUIRED "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1195      >REQUIRED</bcp14>">
1196    <!ENTITY SHALL "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1197      >SHALL</bcp14>">
1198    <!ENTITY SHALL-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1199      >SHALL NOT</bcp14>">
1200    <!ENTITY SHOULD "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1201      >SHOULD</bcp14>">
1202    <!ENTITY SHOULD-NOT "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'
1203      >SHOULD NOT</bcp14>">]>
1204
120510.4.  <bb> element
1206
1207   Marking up a string as <bb> indicates that it represents the bottom
1208   line of a box drawing, replacing the "+" and "-" characters
1209   accordingly.
1210
121110.5.  <bc> element
1212
1213   Marking up a string as <bc> indicates that it represents a center
1214   line of a box drawing, replacing the "|" character accordingly.
1215
121610.6.  <blockquote> element
1217
1218   This element is like the "blockquote" element in [HTML] (note this is
1219   a block-level element!).  It should contain one or more <t> child
1220   elements.
1221
122210.7.  <bt> element
1223
1224   Marking up a string as <bt> indicates that it represents the top line
1225   of a box drawing, replacing the "+" and "-" characters accordingly.
1226
1227
1228
1229
1230
1231Reschke                                                        [Page 22]
1232
1233Documentation             RFC2629 through XSLT                 July 2008
1234
1235
123610.8.  <dfn> element
1237
1238   This element is like the "dfn" element in [HTML].
1239
124010.9.  <h> element
1241
1242   This element is like the "h" element in [XHTML2].
1243
124410.10.  <length-of> element
1245
1246   This element can be used to insert the length of another formatted
1247   section (in decimal).
1248
1249   Example: computing the Content-Length header value
1250
1251   <artwork>
1252   ...
1253   Content-Length: <x:length-of target="req"/>
1254
1255   <x:span anchor="req">123456789
1256   <x:span><artwork/>
1257
1258   The lenght computation counts line ends as two characters (CRLF).
1259
1260   Note that indentation characters in artwork _will_ be counted.  The
1261   "indented" attribute allows to specify the amount of indentation to
1262   be substracted from the computed length.
1263
126410.11.  <link> element
1265
1266   This element can be added as a top-level child element below <rfc> to
1267   indicate additional link information.  It's currently used only when
1268   generating HTML output, in which case an HTML <link> element with
1269   identical attributes gets generated.
1270
1271   Example: generating HTML link element
1272
1273           <x:link xmlns="http://purl.org/net/xml2rfc/ext"
1274               rel="Bookmark"
1275               title="IETF WEBDAV Working Group"
1276               href="http://ftp.ics.uci.edu/pub/ietf/webdav/"/>
1277
127810.12.  <lt> element
1279
1280   Used for grouping multiple <t> elements into a single list item.
1281
1282
1283
1284
1285
1286
1287Reschke                                                        [Page 23]
1288
1289Documentation             RFC2629 through XSLT                 July 2008
1290
1291
129210.13.  <q> element
1293
1294   This element is like the "q" element in [HTML].
1295
129610.14.  <ref> element
1297
1298   This element is a simplified variant of the <xref> element, in that
1299   no "target" attribute needs to be specified, instead the text
1300   contents acts as identifier.  That in itself wouldn't be terribly
1301   useful, but together with the <anchor-alias>, it allows referring to
1302   other parts of the document with minimal additional markup.
1303
1304   For instance, given an alias definition such as
1305
1306         <section title="Test" anchor="test">
1307           <x:anchor-alias value="alias1"/>
1308           <x:anchor-alias value="alias 2"/>
1309           ...
1310         </section>
1311
1312   the following simple references
1313
1314         <x:ref>test</x:ref>
1315         <x:ref>alias1</x:ref>
1316         <x:ref>alias 2</x:ref>
1317
1318   are equivalent to...:
1319
1320         <xref target="test">test</xref>
1321         <xref target="test">alias1</xref>
1322         <xref target="test">alias 2</xref>
1323
132410.15.  <source> element
1325
1326   Can be used to enhance a <reference> with information about the
1327   location for the XML source.  This can be used by the <xref>
1328   processing code to automatically extract the target section number.
1329
1330   For example:
1331
1332         ...
1333         <xref target="RFC2616" x:fmt="of" x:rel="#PUT" />
1334         ...
1335
1336         <reference target="RFC2616"/>
1337           ...
1338           <x:source href="rfc2616.xml"/>
1339           ...
1340
1341
1342
1343Reschke                                                        [Page 24]
1344
1345Documentation             RFC2629 through XSLT                 July 2008
1346
1347
134810.16.  <sup> element
1349
1350   This element is like the "sup" element in [HTML].
1351
1352   Note: the down conversion to RFC2629 format replaces "x^y" by "x^y".
1353
135410.17.  Extensions to Xml2rfc <iref> element
1355
1356   The extension attribute below is allowed on the standard <iref>
1357   element:
1358
1359   o  x:for-anchor specifies that the <iref> will also be automatically
1360      inserted whenever the specified anchor is cross-referenced -- this
1361      may save entering lots of <iref> instances.  As a special case, a
1362      value of "" (empty string) refers to the anchor attribute of the
1363      closest ancestor.
1364
136510.18.  Extensions to Xml2rfc <list> element
1366
1367   The extension attribute below is allowed on the standard <list>
1368   element:
1369
1370   o  x:indent specifies the amount of indentation for list items in
1371      hanging lists.  This can be useful when the output format, such as
1372      XSL-FO, does not support automatical formatting.  The value takes
1373      an XSL-FO width, such as "5em".  The default is _length of longest
1374      label in characters_ times _0.8em_.
1375
1376   Also, the <list> element can take <x:lt> child elements instead of
1377   <t>, allowing to insert multiple paragraphs into a single list item.
1378
137910.19.  Extensions to Xml2rfc <section> element
1380
1381   The extension attribute below is allowed on the standard <list>
1382   element:
1383
1384   o  x:fixed-section-number can be used to specify a fixed section
1385      number.  This can be useful when formatting historic documents
1386      that used a different numbering style.
1387
138810.20.  Extensions to Xml2rfc <xref> element
1389
1390   Three extension attributes are allowed on the standard <xref>
1391   element:
1392
1393   1.  x:sec can be specified to point to a specific section of the
1394       referenced document,
1395
1396
1397
1398
1399Reschke                                                        [Page 25]
1400
1401Documentation             RFC2629 through XSLT                 July 2008
1402
1403
1404   2.  x:rel may specify a relative reference to use when linking into
1405       the referenced document (if linking by section number is not
1406       available),
1407
1408   3.  x:fmt defines the text format to be used.
1409
1410   The following formats are defined for the x:fmt attribute:
1411
1412   , (Comma)  [_reference_], Section _sec_
1413
1414   () [_reference_] (Section _sec_)
1415
1416   anchor  Like the default format, but without brackets.
1417
1418   of Section _sec_ of [_reference_]
1419
1420   number  _sec_
1421
1422   none  No output (can be used to have xrefs to references without
1423      having them rendered as such)
1424
1425   sec  Section _sec_
1426
1427   These extensions are currently only supported for <xref> elements
1428   without child nodes.
1429
1430   If the processor knows how to reference the target section, it will
1431   generate a link directly to the target section, such as in [RFC2119],
1432   Section 5.
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455Reschke                                                        [Page 26]
1456
1457Documentation             RFC2629 through XSLT                 July 2008
1458
1459
146011.  Utilities
1461
146211.1.  Checking References
1463
1464   "check-references.xslt" can be used to check all references to RFC-
1465   and ID-series IETF publications and to W3C publications (note this
1466   script requires local copies of
1467   <ftp://ftp.isi.edu/in-notes/rfc-index.xml> and
1468   <http://www.w3.org/2002/01/tr-automation/tr.rdf> and will use the XML
1469   status information provided at <http://tools.ietf.org/>).
1470
1471   If the document is supposed to be published on the IETF standards
1472   track, the desired level can be specified using the parameter
1473   "intended-level" as 'PROPOSED', 'DRAFT' or 'STANDARD'.
1474
1475   For instance, as of 2006-08-06, the script produces for
1476   <http://greenbytes.de/tech/webdav/rfc2518.xml>:
1477
1478   > saxon rfc2518.xml check-references.xslt
1479
1480   Normative References:
1481   ISO-11578: not checked
1482   ISO-639: not checked
1483   ISO-8601: not checked
1484   REC-xml-19980210: [FirstEdition] obsoleted by REC-xml-20001006
1485   REC-xml-names-19990114: [REC] obsoleted by PER-xml-names-20060614
1486   RFC1766: [PROPOSED STANDARD] obsoleted by RFC3066 RFC3282
1487   RFC2068: [PROPOSED STANDARD] obsoleted by RFC2616
1488   RFC2069: [PROPOSED STANDARD] obsoleted by RFC2617
1489   RFC2119: [BEST CURRENT PRACTICE] (-> BCP0014) ok
1490   RFC2141: [PROPOSED STANDARD] ok
1491   RFC2277: [BEST CURRENT PRACTICE] (-> BCP0018) ok
1492   RFC2396: [DRAFT STANDARD] obsoleted by RFC3986
1493   RFC2279: [DRAFT STANDARD] obsoleted by RFC3629
1494
1495   Informational References:
1496   REC-PICS-labels-961031: [REC] ok
1497   RFC1807: [INFORMATIONAL] ok
1498   RFC2026: [BEST CURRENT PRACTICE] (-> BCP0009) ok
1499   RFC2291: [INFORMATIONAL] ok
1500   RFC2376: [INFORMATIONAL] obsoleted by RFC3023
1501   RFC2413: [INFORMATIONAL] ok
1502   USMARC: not checked
1503   WF: not checked
1504
1505   Recognized formats in the <seriesInfo> element are:
1506
1507
1508
1509
1510
1511Reschke                                                        [Page 27]
1512
1513Documentation             RFC2629 through XSLT                 July 2008
1514
1515
1516   o  for RFCs, the name attribute must be "RFC", and the value
1517      attribute must be the number of the RFC,
1518
1519   o  for Internet Drafs, the name attribute must be "ID" or "Internet-
1520      Draft", and the value attribute must be the file name of the draft
1521      (including the two-digit running number, but excluding a file
1522      extension),
1523
1524   o  for W3C documents, the name attribute must be "W3C", must start
1525      with "W3C ", or must start with "World Wide Web Consortium ", and
1526      the value attribute must be the "shorthand" name of the
1527      specification, such as "REC-xml-19980210".
1528
152911.2.  Generating Graphs from References
1530
1531   "gen-reference-graph.xslt" generates a graph of RFC dependencies,
1532   using the same base data as in "check-references.xslt" (see
1533   Section 11.1).  Its output is a "dot" file, to be processed by
1534   GraphViz (see <http://www.graphviz.org/>).
1535
1536   The picture below shows the RFC dependencies in RFC2629.
1537
1538
153911.3.  Producing reference entries for books
1540
1541   "amazon-asin.xslt" uses the Amazon web services to generate a
1542   <reference> element for a given ASIN (ISBN).
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567Reschke                                                        [Page 28]
1568
1569Documentation             RFC2629 through XSLT                 July 2008
1570
1571
1572   For instance:
1573
1574   <?xml version="1.0" encoding="utf-8"?>
1575   <references>
1576    <reference target="urn:isbn:0134516591">
1577      <front>
1578        <title>Simple Book, The: An Introduction to Internet Management,
1579                  Revised Second Edition</title>
1580        <author surname="Rose"
1581                   fullname="Marshall T. Rose" initials="M. T. ">
1582          <organization/>
1583        </author>
1584        <author surname="Marshall"
1585                   fullname="Rose T. Marshall" initials="R. T.">
1586          <organization/>
1587        </author>
1588        <date year="1996" month="March"/>
1589      </front>
1590      <seriesInfo name="Prentice Hall" value=""/>
1591    </reference>
1592   </references>
1593
1594   Note that the resulting XML usually requires checking, in this case
1595   Amazon's database is playing tricks with Marshall's name...
1596
159711.4.  Down-converting to RFC2629bis DTD
1598
1599   "clean-for-DTD.xslt" can be used to down-convert some extensions to a
1600   format that is supported by the base xml2rfc distribution.  Note that
1601   these extensions are experimental (feedback appreciated).
1602
1603   The following mappings are done:
1604
1605   o  <iref> elements inside <artwork> elements are moved in front of
1606      the enclosing <figure> element.
1607
1608   o  <xref> elements inside <artwork> are expanded just like in regular
1609      text (that is, the markup is stripped, but the element is replaced
1610      by the applicable replacement text).
1611
1612   o  <x:anchor-alias> elements get stripped.
1613
1614   o  <x:bcp14> elements get stripped.
1615
1616   o  <x:bb>, <x:bc> and <x:bt> elements get stripped.
1617
1618   o  <x:blockquote> elements get converted to indented text (through a
1619      <list> element).
1620
1621
1622
1623Reschke                                                        [Page 29]
1624
1625Documentation             RFC2629 through XSLT                 July 2008
1626
1627
1628   o  <x:dfn> elements get stripped.
1629
1630   o  <x:h> elements get stripped.
1631
1632   o  <x:link> elements get stripped.
1633
1634   o  <x:q> elements get stripped, with apostrophes added around the
1635      text.
1636
1637   o  <x:ref> elements get replaced by <xref> elements, targetting
1638      either the anchor or another anchor with matching <x:anchor-alias>
1639      child element.
1640
164111.5.  Extracting artwork
1642
1643   With "extract-artwork.xslt", artwork elements named through the
1644   "name" attribute can be extracted.  This can be used to automatically
1645   check their syntax (for instance, when ABNFs appear within a figure
1646   element).
1647
1648   For instance:
1649   saxon rfc3986.xml extract-artwork.xslt name=uri.abnf
1650
1651   In addition, artwork of a specific type can be extracted, such as
1652   with:
1653   saxon rfc3986.xml extract-artwork.xslt type=abnf
1654
165511.6.  GRRDL
1656
1657   "rfc2629grddl.xslt" extracts RDF information.  This is experimental
1658   work-in-progress.  See <http://www.w3.org/TR/grddl/> for more
1659   information.
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679Reschke                                                        [Page 30]
1680
1681Documentation             RFC2629 through XSLT                 July 2008
1682
1683
168412.  Informative References
1685
1686   [HTML]     Raggett, D., Hors, A., and I. Jacobs, "HTML 4.01
1687              Specification", W3C REC-html401-19991224, December 1999,
1688              <http://www.w3.org/TR/html401/>.
1689
1690   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
1691              Requirement Levels", BCP 14, RFC 2119, March 1997.
1692
1693   [RFC2616]  Fielding, R., Gettys, J., Mogul, J., Nielsen, H.,
1694              Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
1695              Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.
1696
1697   [RFC2629]  Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629,
1698              June 1999.
1699
1700   [RFC2648]  Moats, R., "A URN Namespace for IETF Documents", RFC 2648,
1701              August 1999.
1702
1703   [RFC2731]  Kunze, J., "Encoding Dublin Core Metadata in HTML",
1704              RFC 2731, December 1999.
1705
1706   [RFC5234]  Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
1707              Specifications: ABNF", STD 68, RFC 5234, January 2008.
1708
1709   [RNC]      Clark, J., "RELAX NG Compact Syntax", OASIS , Nov 2002, <h
1710              ttp://www.oasis-open.org/committees/relax-ng/
1711              compact-20021121.html>.
1712
1713   [XHTML2]   Axelsson, J., Birbeck, M., Dubinko, M., Epperson, B.,
1714              Ishikawa, M., McCarron, S., Navarro, A., and S. Pemberton,
1715              "XHTML[TM] 2.0", W3C WD-xhtml2-20060726, July 2006,
1716              <http://www.w3.org/TR/xhtml2>.
1717
1718   [XSL-FO]   Berglund, A., "Extensible Stylesheet Language (XSL)
1719              Version 1.1", W3C REC-xsl11-20061205, Dec 2006,
1720              <http://www.w3.org/TR/2006/REC-xsl11-20061205/>.
1721
1722   [1]   <http://www.exslt.org/exsl/functions/node-set/
1723         exsl.node-set.html>
1724
1725   [2]   <http://bugzilla.mozilla.org/show_bug.cgi?id=193678>
1726
1727   [3]   <https://addons.mozilla.org/firefox/2933/>
1728
1729   [4]   <http://microformats.org/wiki/hcard>
1730
1731   [5]   <http://www.w3.org/TR/2003/WD-xsl11-20031217/>
1732
1733
1734
1735Reschke                                                        [Page 31]
1736
1737Documentation             RFC2629 through XSLT                 July 2008
1738
1739
1740   [6]   <http://www.antennahouse.com/>
1741
1742   [7]   <http://www.antennahouse.com/XSL20/axf-extension.htm>
1743
1744   [8]   <http://xml.apache.org/fop/>
1745
1746   [9]   <http://xep.xattic.com/>
1747
1748   [10]  <http://xep.xattic.com/xep/spec.html>
1749
1750   [11]  <http://www.thaiopensource.com/relaxng/jing.html>
1751
1752   [12]  <http://dpcarlisle.blogspot.com/2007/05/
1753         exslt-node-set-function.html>
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791Reschke                                                        [Page 32]
1792
1793Documentation             RFC2629 through XSLT                 July 2008
1794
1795
1796Appendix A.  RELAX NG Compact Schema
1797
1798   The RelaxNG schema ([RNC]) below can be used to validate input
1799   documents (for instance, with Jing [11]).
1800
1801   _Note that this is work in progress, and doesn't yet cover all
1802   extensions completely._
1803
1804  # WORK IN PROGRESS! PLEASE REPORT PROBLEMS TO THE AUTHOR.
1805
1806  # Define our extension namespace
1807  namespace x = "http://purl.org/net/xml2rfc/ext"
1808
1809  # Define GRDDL namespace
1810  namespace grddl = "http://www.w3.org/2003/g/data-view#"
1811
1812  # Include rfc2629bis RNC grammar
1813  include "rfc2629.rnc" {
1814
1815    # Redefine <artwork> to allow markup
1816    artwork =
1817      element artwork {
1818        attlist.artwork,
1819        (TEXT
1820          | eref
1821          | iref
1822          | spanx
1823          | xref
1824          | x_abnf-char-sequence
1825          | x_bb
1826          | x_bc
1827          | x_bt
1828          | x_length-of
1829          | x_ref
1830          | x_span
1831          | x_x)*
1832      }
1833
1834    # Redefine <c> to allow our extension elements
1835    c =
1836      element c {
1837        attlist.c,
1838        (TEXT
1839          | xref
1840          | eref
1841          | iref
1842          | cref
1843          | spanx
1844
1845
1846
1847Reschke                                                        [Page 33]
1848
1849Documentation             RFC2629 through XSLT                 July 2008
1850
1851
1852          | x_ref)*
1853      }
1854
1855    # Redefine <cref> to allow more child elements
1856    cref =
1857      element cref {
1858        attlist.cref,
1859        (TEXT
1860          | eref)*
1861      }
1862
1863    # Redefine <list> element to allow <x:lt> child elements
1864    \list =
1865      element list {
1866        attlist.list,
1867        (t+ | x_lt+)
1868      }
1869
1870    # Redefine <preamble> to allow our extension elements
1871    preamble =
1872      element preamble {
1873        attlist.preamble,
1874        (TEXT
1875          | xref
1876          | eref
1877          | iref
1878          | cref
1879          | spanx
1880          | x_anchor-alias)*
1881      }
1882
1883    # Redefine <postamble> to allow our extension elements
1884    postamble =
1885      element postamble {
1886        attlist.postamble,
1887        (TEXT
1888          | xref
1889          | eref
1890          | iref
1891          | cref
1892          | spanx
1893          | x_bcp14)*
1894      }
1895
1896    # Redefine <reference> to allow our extension elements
1897    reference =
1898      element reference {
1899        attlist.reference,
1900
1901
1902
1903Reschke                                                        [Page 34]
1904
1905Documentation             RFC2629 through XSLT                 July 2008
1906
1907
1908        front,
1909        seriesInfo*,
1910        format*,
1911        annotation*,
1912        x_source?
1913      }
1914
1915    # Redefine <rfc> to allow our extension elements
1916    rfc =
1917      element rfc {
1918        attlist.rfc,
1919        x_link*,
1920        x_assign-section-number*,
1921        front,
1922        middle,
1923        back?
1924      }
1925
1926    # Redefine <section> to allow our extension elements
1927    section =
1928      element section {
1929        attlist.section,
1930        (t
1931         | figure
1932         | texttable
1933         | iref
1934         | section
1935         | x_anchor-alias
1936         | x_blockquote)*
1937      }
1938
1939    # Redefine <spanx> to allow some markup
1940    spanx =
1941      element spanx {
1942        attlist.spanx,
1943        (TEXT
1944          | iref
1945          | xref
1946          | x_ref)*
1947      }
1948
1949    # Redefine <t> to allow our extension elements
1950    t =
1951      element t {
1952        attlist.t,
1953        (TEXT
1954         | \list
1955         | figure
1956
1957
1958
1959Reschke                                                        [Page 35]
1960
1961Documentation             RFC2629 through XSLT                 July 2008
1962
1963
1964         | xref
1965         | eref
1966         | iref
1967         | cref
1968         | spanx
1969         | vspace
1970         | x_abnf-char-sequence
1971         | x_anchor-alias
1972         | x_bcp14
1973         | x_dfn
1974         | x_h
1975         | x_q
1976         | x_ref
1977         | x_sup)*
1978      }
1979  }
1980
1981  # Extend attribute set for <iref> (see Section 10.17)
1982  attlist.iref &=
1983    attribute x:for-anchor { ATEXT }?
1984
1985  # Extend attribute set for <list> (see Section 10.18)
1986  attlist.list &=
1987    attribute x:indent { ATEXT }?
1988
1989  # Extend attribute set for <preamble>
1990  attlist.preamble &=
1991    attribute anchor { xsd:ID }?
1992
1993  # Extend attribute set for <rfc>
1994  attlist.rfc &=
1995    attribute grddl:transformation { ATEXT }?
1996
1997  # Extend attribute set for <section> (see Section 10.19)
1998  attlist.section &=
1999    attribute x:fixed-section-number { ATEXT }?
2000
2001  # Allow anchor attribute on <spanx>
2002  attlist.spanx &=
2003    attribute anchor { xsd:ID }?
2004
2005  # Extend attribute set for <xref> (see Section 10.20)
2006  attlist.xref &=
2007    attribute x:fmt  { "()" | "," | "anchor" | "of" | "number" | "sec" |
2008                       "none" }?,
2009    attribute x:rel  { ATEXT }?,
2010    attribute x:sec  { ATEXT }?
2011
2012
2013
2014
2015Reschke                                                        [Page 36]
2016
2017Documentation             RFC2629 through XSLT                 July 2008
2018
2019
2020  # Conversion to ABNF char sequence (see Section 10.1)
2021  x_abnf-char-sequence =
2022    element x:abnf-char-sequence {
2023      TEXT
2024    }
2025
2026  # Aliasing of anchors (see Section 10.2)
2027  x_anchor-alias =
2028    element x:anchor-alias {
2029      attribute value { TEXT },
2030      empty
2031    }
2032
2033  # Setting section numbers for internally generated sections
2034  # (experimental)
2035  x_assign-section-number =
2036    element x:assign-section-number {
2037      attribute builtin-target { "authors" },
2038      attribute number { TEXT },
2039      empty
2040    }
2041
2042  # Bottom line of box drawing (see Section 10.4)
2043  x_bb =
2044    element x:bb {
2045      (TEXT
2046        | iref
2047        | xref
2048        | x_bb
2049        | x_bc
2050        | x_bt
2051        | x_ref)*
2052    }
2053
2054  # Center line of box drawing (see Section 10.5)
2055  x_bc =
2056    element x:bc {
2057      (TEXT
2058        | iref
2059        | xref
2060        | x_bb
2061        | x_bc
2062        | x_bt
2063        | x_ref)*
2064    }
2065
2066  # BCP14/RFC2119 keywords (see Section 10.3)
2067  x_bcp14 =
2068
2069
2070
2071Reschke                                                        [Page 37]
2072
2073Documentation             RFC2629 through XSLT                 July 2008
2074
2075
2076    element x:bcp14 {
2077      "MAY"
2078      | "MUST"
2079      | "MUST NOT"
2080      | "NOT RECOMMENDED"
2081      | "OPTIONAL"
2082      | "RECOMMENDED"
2083      | "REQUIRED"
2084      | "SHALL"
2085      | "SHALL NOT"
2086      | "SHOULD"
2087      | "SHOULD NOT"
2088    }
2089
2090  # Blockquote (see Section 10.6)
2091  x_blockquote =
2092    element x:blockquote {
2093      attribute cite { URI }?,
2094      t+
2095    }
2096
2097  # Top line of box drawing (see Section 10.7)
2098  x_bt =
2099    element x:bt {
2100      (TEXT
2101        | iref
2102        | xref
2103        | x_bb
2104        | x_bc
2105        | x_bt
2106        | x_ref)*
2107    }
2108
2109  # Definition (see Section 10.8)
2110  x_dfn =
2111    element x:dfn {
2112      (TEXT
2113        | iref)*
2114    }
2115
2116  # Heading (see Section 10.9)
2117  x_h =
2118    element x:h {
2119      TEXT
2120    }
2121
2122  # Length Measurement (see Section 10.10)
2123  x_length-of =
2124
2125
2126
2127Reschke                                                        [Page 38]
2128
2129Documentation             RFC2629 through XSLT                 July 2008
2130
2131
2132    element x:length-of {
2133      attribute indented { NUMBER }?,
2134      attribute target { xsd:IDREF },
2135      empty
2136    }
2137
2138  # Link (see Section 10.11)
2139  x_link =
2140    element x:link {
2141      attribute href { URI },
2142      attribute title { TEXT }?,
2143      attribute rel { TEXT },
2144      empty
2145    }
2146
2147  # Extended list item (see Section 10.12)
2148  x_lt =
2149    element x:lt {
2150      attribute anchor { xsd:ID }?,
2151      attribute hangText { TEXT }?,
2152      t+
2153    }
2154
2155  # Inline quote (see Section 10.13)
2156  x_q =
2157    element x:q {
2158      TEXT
2159    }
2160
2161  # Anchor reference (see Section 10.14)
2162  x_ref =
2163    element x:ref {
2164      TEXT
2165    }
2166
2167  # source information (see Section 10.15)
2168  x_source =
2169    element x:source {
2170      attribute basename { ATEXT }?,
2171      attribute href { URI },
2172      empty
2173    }
2174
2175  # superscript (see Section 10.16)
2176  x_sup =
2177    element x:sup {
2178      TEXT
2179    }
2180
2181
2182
2183Reschke                                                        [Page 39]
2184
2185Documentation             RFC2629 through XSLT                 July 2008
2186
2187
2188  # Inline Span
2189  x_span =
2190    element x:span {
2191      attribute anchor { xsd:ID }?,
2192      TEXT
2193    }
2194
2195  # Nop (for alignment in source)
2196  x_x =
2197    element x:x {
2198      empty
2199    }
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239Reschke                                                        [Page 40]
2240
2241Documentation             RFC2629 through XSLT                 July 2008
2242
2243
2244Appendix B.  Implementation Notes
2245
2246B.1.  Recognized type attributes for <artwork> element
2247
2248   Specific values in the <artwork> element's "type" attribute are
2249   recognized and cause a different visual style to be used:
2250
2251   +-------------------------------------+-----------------------------+
2252   | Media Type                          | Comment                     |
2253   +-------------------------------------+-----------------------------+
2254   | abnf                                | ABNF as per [RFC5234]       |
2255   |                                     |                             |
2256   | abnf2616                            | ABNF as per [RFC2616],      |
2257   |                                     | Section 2.1                 |
2258   |                                     |                             |
2259   | application/relax-ng-compact-syntax | Relax NG Compact Syntax as  |
2260   |                                     | per [RNC]                   |
2261   |                                     |                             |
2262   | application/xml-dtd                 | XML DTD                     |
2263   |                                     |                             |
2264   | message/http; msgtype="request"     | HTTP message, as per        |
2265   |                                     | [RFC2616], Section 19.1     |
2266   |                                     |                             |
2267   | message/http; msgtype="response"    | HTTP message, as per        |
2268   |                                     | [RFC2616], Section 19.1     |
2269   +-------------------------------------+-----------------------------+
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295Reschke                                                        [Page 41]
2296
2297Documentation             RFC2629 through XSLT                 July 2008
2298
2299
2300Appendix C.  License
2301
2302   Copyright (c) 2006-2008, Julian Reschke
2303   (julian.reschke@greenbytes.de)
2304
2305   All rights reserved.
2306
2307   Redistribution and use in source and binary forms, with or without
2308   modification, are permitted provided that the following conditions
2309   are met:
2310
2311   o  Redistributions of source code must retain the above copyright
2312      notice, this list of conditions and the following disclaimer.
2313
2314   o  Redistributions in binary form must reproduce the above copyright
2315      notice, this list of conditions and the following disclaimer in
2316      the documentation and/or other materials provided with the
2317      distribution.
2318
2319   o  Neither the name of Julian Reschke nor the names of its
2320      contributors may be used to endorse or promote products derived
2321      from this software without specific prior written permission.
2322
2323   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
2324   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
2325   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
2326   A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
2327   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2328   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
2329   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2330   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2331   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2332   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
2333   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351Reschke                                                        [Page 42]
2352
2353Documentation             RFC2629 through XSLT                 July 2008
2354
2355
2356Appendix D.  Change Logs
2357
2358D.1.  Package
2359
2360   2006-01-01  Switch to BSD License.
2361
2362   2007-01-12  Update to xml2rfc v1.33pre2.
2363
2364   2007-03-31  Update to xml2rfc v1.33pre3.
2365
2366   2007-05-01  Add XSLT test cases.
2367
2368D.2.  amazon-asin.xslt
2369
2370   2003-11-16  Initial release.
2371
2372   2005-04-02  Fix two DTD issues.
2373
2374D.3.  check-references.xslt
2375
2376   2003-11-16  Initial release.
2377
2378   2003-11-16  Initial release.
2379
2380   2004-05-11  Add document status; print references type.
2381
2382   2005-01-01  Add experimental check for ID status.
2383
2384   2005-04-01  Add fixes from Bill Fenner.
2385
2386   2005-12-03  Add checks against local copy of
2387      <http://www.w3.org/2002/01/tr-automation/tr.rdf>.
2388
2389   2006-07-22  Add checks for standards levels.
2390
2391   2006-08-06  "check-ietf-references.xslt" replaced by "check-
2392      references.xslt".
2393
2394   2007-01-04  Use information online at <http://tools.ietf.org/> to
2395      retrieve Internet-Draft status information.
2396
2397   2007-06-16  Fix bug looking up ref type when inside change markup.
2398
2399   2008-06-14  Enhance output when draft was updated, and then published
2400      as RFC.
2401
2402
2403
2404
2405
2406
2407Reschke                                                        [Page 43]
2408
2409Documentation             RFC2629 through XSLT                 July 2008
2410
2411
2412D.4.  gen-reference-graph.xslt
2413
2414   2006-09-03  New.
2415
2416   2007-06-07  Use Carlisle method [12] to define exslt:node-set in
2417      msxsml (which means that the stylesheet can now be used with MSXML
2418      as well).
2419
2420   2007-10-15  Use W3C data from tr.rdf as well (experimental).
2421
2422D.5.  rfc2629.xslt
2423
2424   2001-03-28  Code rearranged, generate numbered section anchors for
2425      paragraphs (t) as well.  Fixes in index handling.
2426
2427   2001-04-12  Moved HTML output into XHTML namespace.
2428
2429   2001-10-02  Fixed default location for RFCs and numbering of section
2430      references.  Support ?rfc editing processing instruction.
2431
2432   2001-10-07  Made telephone number links active.
2433
2434   2001-10-08  Support for vspace element.
2435
2436   2001-10-09  Experimental support for rfc-issue PI.
2437
2438   2001-11-11  Support rfc private PI.  Removed bogus code reporting the
2439      WG in the header.
2440
2441   2001-11-11  Support rfc private PI.  Removed bogus code reporting the
2442      WG in the header.
2443
2444   2001-12-17  Support title attribute on references element
2445
2446   2002-01-05  Support for list/@style="@format"
2447
2448   2002-01-09  Display "closed" RFC issues as deleted
2449
2450   2002-01-14  Experimentally and optionally parse XML encountered in
2451      artwork elements (requires MSXSL).
2452
2453   2002-01-27  Some cleanup.  Moved RFC issues from PIs into namespaced
2454      elements.
2455
2456   2002-01-29  Added support for sortrefs PI.  Added support for figure
2457      names.
2458
2459
2460
2461
2462
2463Reschke                                                        [Page 44]
2464
2465Documentation             RFC2629 through XSLT                 July 2008
2466
2467
2468   2002-02-07  Highlight parts of artwork which are too wide (72
2469      characters).
2470
2471   2002-02-12  Code rearrangement for static texts.  Fixes for section
2472      numbering.  TOC generation rewritten.
2473
2474   2002-02-15  Support for irefs in sections; support iref @primary=true
2475
2476   2002-03-03  Moved anchor prefix into a constant.  Added sanity checks
2477      on user anchor names.
2478
2479   2002-03-23  Bugfix in detection of matching org names when creating
2480      the header.  Fixed sorting in subitems.
2481
2482   2002-04-02  Fix TOC link HTML generation when no TOC is generated
2483      (created broken HTML table code).
2484
2485   2002-04-03  Made rendering of references more tolerant re: missing
2486      parts.
2487
2488   2002-04-08  Fixed reference numbering when references are split into
2489      separate sections.
2490
2491   2002-04-16  Fix default namespace (shouldn't be set for HTML output
2492      method).
2493
2494   2002-04-19  Lowercase internal CSS selectors for Mozilla compliance.
2495      Do not put TOC into ul element.
2496
2497   2002-04-21  Make numbered list inside numbered lists use alphanumeric
2498      numbering.
2499
2500   2002-05-05  Updated issue/editing support.
2501
2502   2002-05-15  Bugfix for section numbering after introduction of ed:
2503      replace
2504
2505   2002-06-21  When producing private documents, do not include document
2506      status, copyright etc.
2507
2508   2002-07-08  Fix xrefs to Appendices.
2509
2510   2002-07-19  Make artwork lightyellow for easier reading. (fielding)
2511
2512   2002-10-09  Translate references title to anchor name to avoid non-
2513      uri characters. (fielding)
2514
2515
2516
2517
2518
2519Reschke                                                        [Page 45]
2520
2521Documentation             RFC2629 through XSLT                 July 2008
2522
2523
2524   2002-10-13  Support for tocdepth PI.
2525
2526   2002-11-03  Added temporariry workaround for Mozilla/Transformiix
2527      result tree fragment problem. (search for
2528      'http://bugzilla.mozilla.org/show_bug.cgi?id=143668')
2529
2530   2002-12-25  xref code: attempt to uppercase "section" and "appendix"
2531      when at the start of a sentence.
2532
2533   2003-02-02  fixed code for vspace blankLines="0", enhanced display
2534      for list with "format" style, got rid of HTML blockquote elements,
2535      added support for "hangIndent"
2536
2537   2003-04-10  experimental support for appendix and spanx elements
2538
2539   2003-04-19  fixed counting of list numbers in "format %" styles (one
2540      counter per unique format string).  Added more spanx styles.
2541
2542   2003-05-02  experimental texttable support
2543
2544   2003-05-02  Make mailto links optional (default = none) (jre: default
2545      and PI name changed) (fielding)
2546
2547   2003-05-04  experimental support for HTML link elements; fix default
2548      for table header alignment default
2549
2550   2003-05-06  support for "background" PI.
2551
2552   2003-05-11  change %c format to lowercase alphabetic. add support for
2553      keyword elements (generate META tag). fix various HTML conformance
2554      problems. added experimental support for role attribute. do not
2555      number paragraphs in unnumbered sections. update boilerplate
2556      texts. support for "iprnotified" PI. bugfix list numbering. strip
2557      whitespace when building tel: URIs.
2558
2559   2003-05-12  more conformance fixes (layout moved into CSS, move lists
2560      and figures out of para content, do not use tables for list
2561      formatting)
2562
2563   2003-05-13  add DC.Creator meta tag, refactoring
2564
2565   2003-05-16  put nbsps between "section" and section number (xref).
2566
2567   2003-05-18  author summary: add missing comma.
2568
2569
2570
2571
2572
2573
2574
2575Reschke                                                        [Page 46]
2576
2577Documentation             RFC2629 through XSLT                 July 2008
2578
2579
2580   2003-06-06  fix index generation bug (transposed characters in key
2581      generation).  Enhance sentence start detection (xref starting a
2582      section was using lowercase "section").
2583
2584   2003-06-22  exp. support for xref/@format.  Add missing support for
2585      eref w/o content. exp. support for annotations in reference
2586      elements.  Code cleanup reference table formatting.
2587
2588   2003-07-09  Another fix for DC.Creator meta tag creation based on
2589      RFC2731
2590
2591   2003-07-24  Fix namespace name for DC.Creator.
2592
2593   2003-08-06  Cleanup node-set support (only use exslt (saxon, xalan,
2594      libxslt) extension functions; remove Transformix workarounds that
2595      stopped to work in Moz 1.4)
2596
2597   2003-08-09  Generate HTML lang tag.
2598
2599   2003-08-10  Map spanx/verb to HTML "samp" element.  Fix author name
2600      display in references (reverse surname/initials for last author),
2601      add "Ed.".  Fix internal bookmark generation.
2602
2603   2003-08-17  Add DCMI dates, identifiers and abstract.  Add PI to
2604      suppress DCMI generation.  Do not add TOC entry to Copyright
2605      Statement when there is none.  Align RFC2629 PI names and
2606      parameter names.  Change style for inline URIs generated by eref.
2607      Add header and footer support.  Enhance CSS paging properties.
2608      Support topblock PI.  Added hooks for proper XHTML generation
2609      through separate XSLT.  Enhance warning and error messages.  Add
2610      support for artwork image display.  Table formatting fixes
2611      (borders, thead continuation).
2612
2613   2003-08-18  Add workaround for MSXML4 node-set and Mozilla node-set
2614      issues (fallback just displays are warning).
2615
2616   2003-10-06  Add workaround for broken pre/ins handling in Mozilla
2617      (see <http://bugzilla.mozilla.org/show_bug.cgi?id=204401>).  Make
2618      use of cite attribute on ed:replace.  CSS cleanup.
2619
2620   2003-10-08  Fix minor issue detecting the same org for the header
2621      (caused by IE's non-standard whitespace handling).  Fix default
2622      handling for /rfc/@category.
2623
2624   2003-11-09  Inherit ed:entered-by from ancestor elements.  Change CSS
2625      color for inserted text to green.  Generate issues-list anchor.
2626      Do not complain about missing targets when the xref element is
2627      below ed:del.  Remove code that attempted to distinguish section/
2628
2629
2630
2631Reschke                                                        [Page 47]
2632
2633Documentation             RFC2629 through XSLT                 July 2008
2634
2635
2636      Section when producing links - always use uppercase.  Fix date
2637      rendering for issue resolutions.
2638
2639   2003-11-29  Fix color values for table backgrounds for issue
2640      rendering.  Change rendering of issue links to use inline-styles.
2641      Add colored issue markers to issues.
2642
2643   2003-12-13  Fix inheritance of ed:entered-by attribute.  Display note
2644      elements inside change tracking as well.
2645
2646   2004-01-18  When PI compact = 'yes', make most CSS print page breaks
2647      conditional.
2648
2649   2004-02-20  Support for RFC3667 IPR changes (xml2rfc 1.22); see <http
2650      ://lists.xml.resource.org/pipermail/xml2rfc/2004-February/
2651      001088.html>.
2652
2653   2004-03-11  Add "(if approved)" to "updates" and "obsoletes" unless
2654      the document has an RFC number.
2655
2656   2004-04-01  Fix RFC3667 output, see <http://lists.xml.resource.org/
2657      pipermail/xml2rfc/2004-April/001208.html>.
2658
2659   2004-04-04  Add support for section/top attribute.  Move references
2660      into plain section container.
2661
2662   2004-04-06  Do not emit identical para anchors for deleted content.
2663
2664   2004-04-14  Fix references TOC generation when there are no
2665      references.
2666
2667   2004-04-24  Fix RFC3667 output, see
2668      <http://xml.resource.org/pipermail/xml2rfc/2004-April/
2669      001246.html>.
2670
2671   2004-05-09  Add custom support for generating compound index
2672      documents.  Add anchors for each Index letter.  Add experimental
2673      cref support.  Fix conditional page breaks before References
2674      section.
2675
2676   2004-05-16  Refactor external index generation.
2677
2678   2004-05-20  Rewrite anchor generation for comments.
2679
2680   2004-05-22  Enhance issues rendering (add links to changes).
2681
2682
2683
2684
2685
2686
2687Reschke                                                        [Page 48]
2688
2689Documentation             RFC2629 through XSLT                 July 2008
2690
2691
2692   2004-05-30  Allow single quote as delimiter in processing
2693      instructions as well.  Move block-level issue pointers to floats.
2694      Disable issue pointers for print media.  Add "purple numbers".
2695      Add hrefs to section headings.  Add non-printing index key letter
2696      list to start of index.
2697
2698   2004-06-01  Use &#xb6; instead of # for PNs.
2699
2700   2004-07-18  Add support for list style=letters (thanks Roy F.).  Make
2701      PNs optional; add new PI.
2702
2703   2004-09-05  Fix index links into unnumbered sections.  Bring IPR
2704      boilerplate in-line with xml2rfc 1.25.  Add experimental CSS3
2705      paged media support.  Various HTML fixes.
2706
2707   2004-09-21  Enhance checking of artwork width.
2708
2709   2004-09-26  Add check for unused references.  Uppercase letters in
2710      list style letters when nested into another list.
2711
2712   2004-10-10  Fix internal change track pointers.
2713
2714   2004-11-01  Allow change tracking on references (as a whole).
2715      Rewrite artwork handling so that it allows change tracking inside
2716      artwork.  Also allow a subset of text markup inside artwork, such
2717      as xrefs (note this requires post-processing the source to make it
2718      compliant to RFC2629bis).
2719
2720   2004-11-03  Enhanced placement of iref anchors.
2721
2722   2004-11-06  Index: display irefs that appeared (with primary=true)
2723      inside artwork elements in a monospaced font.
2724
2725   2004-11-14  Add special code so that changes in section titles can be
2726      change-tracked.
2727
2728   2005-01-14  Bugfixes for HtmlToXhtml converter.
2729
2730   2005-01-22  Enhance generation of HTML h* elements (for Mozilla
2731      Outliner).
2732
2733   2005-01-31  Put vertical space around top-level TOC entries in TOC.
2734      Switch to pt-based CSS.  Re-arrange top section.  Make hr elements
2735      reflect new-page settings in TXT output (compact-PI).  Fix page
2736      number in footer (CSS print) and add some more experimental
2737      support for paged media (tested with Prince 4.1 alpha).  Rewrite
2738      TOC and Index generation to generate HTML lists.  Cleanup id
2739      generation for paragraphs.  Reduce whitespace in output.  Fix
2740
2741
2742
2743Reschke                                                        [Page 49]
2744
2745Documentation             RFC2629 through XSLT                 July 2008
2746
2747
2748      vspace implementation.  Use right/left dqoutes and copyright sign
2749      where appropriate.
2750
2751   2005-02-04  Add <link> element to references section.  Fix newly
2752      introduced bug in references processing.
2753
2754   2005-02-05  Integrate various fixes/enhancements by Roy Fielding:
2755      spelling of "Authors' Addresses", comma setting in references,
2756      position of "Authors" section, optionally place authors addresses
2757      at end (PI), trailing dots in section numbers, switch to verdana
2758      default font in CSS.  Add experimental support for centered
2759      artwork.
2760
2761   2005-02-09  Fixes in spacing and links of references section titles.
2762      Enhance sorting in references when change tracking is in place.
2763      Re-add figure centering support.  Add missing 2nd part of
2764      "Author's Adresses" fix.
2765
2766   2005-02-25  Align section number format with xml2rfc1.29.
2767
2768   2005-03-28  Get rid of table elements in Author's section.  Add
2769      experimental hCard (<http://developers.technorati.com/wiki/hCard>)
2770      support.
2771
2772   2005-04-03  Add RFC3978-style IPR statement support.
2773      (fenner@research.att.com)
2774
2775   2005-04-11  Cleanup author display. hCard related fixes.
2776
2777   2005-05-07  Minor fixes to allow change tracking in doc title.  Add
2778      experimental support for table border styles.  CSS cleanup.
2779
2780   2005-06-18  Implement missing support for references to texttables.
2781
2782   2005-09-25  Use (-moz-)column-count when printing the index.
2783
2784   2005-10-04  Report missing element templates with xsl:message.
2785
2786   2005-10-15  Process t/@anchor.
2787
2788   2005-10-23  More workarounds for Mozilla's broken del/ins handling
2789      (this time for figures).
2790
2791   2005-10-27  lowercase hCard class names
2792
2793
2794
2795
2796
2797
2798
2799Reschke                                                        [Page 50]
2800
2801Documentation             RFC2629 through XSLT                 July 2008
2802
2803
2804   2005-11-22  Enhance diagnostics for XML-in-artwork extension
2805
2806   2005-11-26  Fix formatting of section numbers for sections inserted
2807      into <back>.
2808
2809   2005-12-12  Fix some validity problems when change tracking occured
2810      inside lists.
2811
2812   2005-12-18  Add change tracking inside the index.
2813
2814   2006-02-04  Add prev/next links to highlighted changes (change
2815      tracking extension).
2816
2817   2006-02-10  Catch errors instantiating MSXML component.
2818
2819   2006-02-11  References: add "work in progress" for Internet Drafts.
2820
2821   2006-02-27  Fix front matter (lowercase Internet-Draft, say "Intended
2822      status" for non-RFC documents).  Start work on experimental
2823      extension for simplified internal links.
2824
2825   2006-03-19  Tweaks to IESG Copyright stuff; support submissionType
2826      attribute.  Fix duplicate reference anchors in HTML output.
2827      Reduce HTML Tidy warnings.  Fix reference to normative ASCII
2828      version (now requires trailing ".txt").  Tweaks to hCard
2829      generation.  Started to move non-issue-tracking extensions into
2830      namespace "http://purl.org/net/xml2rfc/ext".
2831
2832   2006-03-27  Moved "simple reference" extension into namespace
2833      "http://purl.org/net/xml2rfc/ext" and add documentation.  HTML
2834      conformance enhancements.
2835
2836   2006-04-02  Cleanup special code for automated XHTML XSLT generation.
2837
2838   2006-04-21  Generate <CITE> elements where appropiate.  Introduce
2839      x:blockquote, x:dfn, x:h and x:q elements.
2840
2841   2006-05-06  Introduce x:bcp14 element.
2842
2843   2006-05-14  Fix content model for x:blockquote.
2844
2845   2006-06-18  Add box drawing support (x:bt, x:bc, x:bb).
2846
2847   2006-06-20  HTML validity fixes (legal chars in anchors in index).
2848
2849
2850
2851
2852
2853
2854
2855Reschke                                                        [Page 51]
2856
2857Documentation             RFC2629 through XSLT                 July 2008
2858
2859
2860   2006-06-24  Reduce leading empty lines in artwork.  Move <dt> style
2861      info into CSS.
2862
2863   2006-07-14  Fix rendering of multiple street address entries (missing
2864      line break).
2865
2866   2006-07-24  Add extension for deep linking into RFCs, do not generate
2867      empty list items in TOC output, avoid empty <dt> elements for list
2868      items without hangText attribute.
2869
2870   2006-08-01  Allow @anchor on more elements; start work on Relax NG
2871      grammar for extensions.  Reduce generated style elements (use CSS
2872      classes instead).  Consistently use "id" instead of "name".
2873      Change default target for RFC links to
2874      "http://tools.ietf.org/html/rfcNNNN".
2875
2876   2006-08-06  Include appendices defined in <appendix> elements in TOC
2877      (please consider them deprecated anyhow!).  Generate links to
2878      "http://tools.ietf.org/html/draft-*" for Internet Drafts.  Replace
2879      x:frag by x:rel, allowing any kind of relative reference instead
2880      of just fragments.
2881
2882   2006-08-30  Reduce textual differences between HTML output and what
2883      xml2rfc produces in TXT output mode (section refs/reference
2884      targets).  Add small workaround for Opera 9.0.1's problem with
2885      node-set().
2886
2887   2006-10-29  Fix problem generating internal links to change markup
2888      within references section.  Enhancements when generating numbered
2889      references for deleted references.  Allow inclusion of references
2890      into the index (through include-references-in-index extension).
2891      Fix a bug that caused the newer version of the IETF boilerplate to
2892      be produced rather than the pre-RFC3667 one.  Update to RFC4287
2893      boilerplate.
2894
2895   2006-11-11  Add extension attribute x:for-anchor to <iref> handling.
2896
2897   2006-11-26  Experimental (and limited) support for <x:lt>.
2898
2899   2006-12-04  Fix bugs in processing documents that have both the ipr
2900      and the number attribute set on the rfc root element.  Add support
2901      for x:fmt='none' on xrefs.  Add different pre style based on
2902      artwork type attributes (experimental).
2903
2904   2006-12-13  Add x:fmt='anchor' for xref elements.
2905
2906
2907
2908
2909
2910
2911Reschke                                                        [Page 52]
2912
2913Documentation             RFC2629 through XSLT                 July 2008
2914
2915
2916   2007-01-07  Fix root template for compatibility for the exslt:node-
2917      set implementation in Firefox3.
2918
2919   2007-01-29  Avoid empty table entry in front matter when organization
2920      is not specified for an author.
2921
2922   2007-02-10  Allow change tracking in table rows.
2923
2924   2007-03-09  Add hcard profile URI (<http://www.w3.org/2006/03/hcard>)
2925      to head element.  Add warning for misplaced <t> elements (after
2926      section).
2927
2928   2007-03-21  Fix internal linking from reference entries in index for
2929      some xref types.  Minor CSS tweaks contributed by MTR.  Allow
2930      turning on text justification through a PI.  Improve iref anchor
2931      generation to generate less instable anchors.
2932
2933   2007-03-28  Fixes for numbering of ed:inserted references sections.
2934
2935   2007-05-04  Do not generate anchors for edits in deleted sections.
2936      Enhance HTML conformance.
2937
2938   2007-05-19  Enhance diagnostics when using Saxon (needs Saxon's "-l"
2939      command line parameter to keep line number information).  Add
2940      warning when symref PI is missing (default will change in the
2941      future).  Add support for overriding computed section numbers
2942      (when formatting historic documents).
2943
2944   2007-06-07  Change default for symrefs PI to "yes" (see change in
2945      xml2rfc 1.33pre4).  Warn about docName attributes that appear to
2946      contain a file extension.
2947
2948   2007-06-26  Workaround author/@initials values without trailing dot,
2949      as in xml2rfc.tcl.
2950
2951   2007-07-14  Enhance index generation for references that use @x:sec
2952      attribute.
2953
2954   2007-09-09  Fix: sortrefs is a nop when symrefs=no.
2955
2956   2007-10-17  Work in progress: add support for referencing sections in
2957      sibling documents by anchor name.
2958
2959   2007-10-17  Work in progress (continued): support for referencing
2960      sections in sibling documents by anchor name.
2961
2962
2963
2964
2965
2966
2967Reschke                                                        [Page 53]
2968
2969Documentation             RFC2629 through XSLT                 July 2008
2970
2971
2972   2007-12-31  Emit warning when updating/obsoleting stuff that's not
2973      referenced.
2974
2975   2008-02-03  Support xml2rfc-1.33pre5's suppress-title attribute on
2976      texttable and figure.
2977
2978   2008-02-06  Extension: allow <eref> below <cref>.
2979
2980   2008-02-17  Extensions: add x:span and x:length-of.
2981
2982   2008-02-20  Add new RFC boilerplate (as changed in 2007-08).
2983
2984   2008-02-27  Improve diagnostics for artwork width problems; add
2985      defaulting of publication dates (requires XSLT processor
2986      supporting exslt:date, or msxml).
2987
2988   2008-02-29  Enhance CSS for link elements in the front header, update
2989      rules for generating "Acknowledgment" statement.
2990
2991   2008-03-01  Use line numbers in diagnostics in Saxon8/9 as well.
2992
2993   2008-03-02  Fix a bug in the logic choosing the boilerplate,
2994      resulting in obsolete text being inserted into IDs.
2995
2996   2008-04-01  Add support for superscript element.
2997
2998   2008-06-28  Add sanity checks for email addresses, allow multiple
2999      email elements.
3000
3001   2008-07-06  Add x:abnf-char-sequence.
3002
3003D.6.  rfc2629toFO.xslt
3004
3005   2003-11-16  Initial release.
3006
3007   2003-11-29  Enhance handling of unknown list styles.
3008
3009   2004-04-04  Update reference section handling.
3010
3011   2004-04-17  Use XSL-WD-1.1-style fo:bookmark and index handling and
3012      add postprocessors for existing implementations.  Unify PDF info
3013      generation by using XEP (postprocessors) will convert.
3014
3015   2004-04-20  Add experimental cref support.
3016
3017
3018
3019
3020
3021
3022
3023Reschke                                                        [Page 54]
3024
3025Documentation             RFC2629 through XSLT                 July 2008
3026
3027
3028   2004-06-14  Set correct index-item defaults.
3029
3030   2004-07-18  Add list style=letters.
3031
3032   2004-09-03  Make URLs in text break where they are allowed to break
3033      by inserting zero-width spaces.
3034
3035   2004-09-26  Fix letter-style inside nested lists.
3036
3037   2004-10-31  Update handling of artwork.
3038
3039   2004-11-13  Fix handling of references inside ed:* markup.  Fix
3040      whitespace handling in artwork.
3041
3042   2004-11-27  Irefs in artwork generate monospaced entries in index.
3043
3044   2005-01-31  Fix TOC generation that was broken after changes in main
3045      XSLT.
3046
3047   2005-02-05  Bring in sync with cosmetic changes in rfc2629.xslt.
3048
3049   2005-05-07  Minor fix for change tracking in document title.  Support
3050      for table styles.
3051
3052   2005-06-18  Fix references to tables.
3053
3054   2005-10-15  Process t/@anchor.
3055
3056   2006-02-11  References: add "work in progress" for Internet Drafts.
3057
3058   2006-06-02  Use XSL 1.1 WD Feb 2006.
3059
3060   2007-03-21  Support optional text justification.
3061
3062   2007-05-19  Various improvements in spacing; also allow overriding
3063      the automatic list indentation via list/x:indent.
3064
3065D.7.  xsl11toAn.xslt
3066
3067   2004-05-17  Initial release.
3068
3069   2006-06-02  Use XSL 1.1 WD Feb 2006.
3070
3071D.8.  xsl11toFop.xslt
3072
3073
3074
3075
3076
3077
3078
3079Reschke                                                        [Page 55]
3080
3081Documentation             RFC2629 through XSLT                 July 2008
3082
3083
3084   2004-05-17  Initial release.
3085
3086   2006-06-02  Use XSL 1.1 WD Feb 2006.
3087
3088D.9.  xsl11toFop-0.93.xslt
3089
3090   2008-03-15  Add a workaround to the fo:inline workaround (sigh).
3091
3092D.10.  xsl11toXep.xslt
3093
3094   2004-05-17  Initial release.
3095
3096   2004-09-04  Fix xep:index-item attributes.
3097
3098   2006-06-02  Use XSL 1.1 WD Feb 2006.
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135Reschke                                                        [Page 56]
3136
3137Documentation             RFC2629 through XSLT                 July 2008
3138
3139
3140Index
3141
3142   A
3143      abnf-char-sequence Extension Element  21, 33
3144      allow-markup-in-artwork PI pseudo-attribute  8
3145      alternate HTML LINK element  15
3146      anchor-alias Extension Element  21, 33
3147      Anchors
3148         rfc.abstract  12
3149         rfc.authors  12
3150         rfc.copyright  12
3151         rfc.copyrightnotice  12
3152         rfc.figure.n  12
3153         rfc.figure.u.n  12
3154         rfc.index  12
3155         rfc.ipr  12
3156         rfc.iref.n  12
3157         rfc.note.n  12
3158         rfc.references  12
3159         rfc.section.n  12
3160         rfc.section.n.p.m  12
3161         rfc.status  12
3162         rfc.toc  12
3163         rfc.xref.name.n  12
3164      AntennaHouse XSL Formatter  19
3165      Apache FOP  19
3166      appendix HTML LINK element  15
3167      assign-section-number Extension Element  33
3168      author HTML LINK element  15
3169      authors-section PI pseudo-attribute  8
3170
3171   B
3172      background PI pseudo-attribute  6
3173      bb Extension Element  22, 33
3174      bc Extension Element  22, 33
3175      bcp14 Extension Element  21, 33
3176      blockquote Extension Element  22, 33
3177      bt Extension Element  22, 33
3178
3179   C
3180      chapter HTML LINK element  15
3181      CHM format  18
3182      comments PI pseudo-attribute  6
3183      compact PI pseudo-attribute  6
3184      contents HTML LINK element  15
3185      copyright HTML LINK element  15
3186      Creator DCMI property  16
3187
3188
3189
3190
3191Reschke                                                        [Page 57]
3192
3193Documentation             RFC2629 through XSLT                 July 2008
3194
3195
3196   D
3197      Date.Issued DCMI property  16
3198      DCMI properties
3199         Creator  16
3200         Date.Issued  16
3201         Description.Abstract  16
3202         Identifier  16
3203         Relation.Replaces  16
3204      Description.Abstract DCMI property  16
3205      dfn Extension Element  23, 33
3206
3207   E
3208      editing PI pseudo-attribute  6
3209      Extension Elements
3210         abnf-char-sequence  21, 33
3211         anchor-alias  21, 33
3212         assign-section-number  33
3213         bb  22, 33
3214         bc  22, 33
3215         bcp14  21, 33
3216         blockquote  22, 33
3217         bt  22, 33
3218         dfn  23, 33
3219         h  23, 33
3220         length-of  23, 33
3221         link  23, 33
3222         lt  23, 33
3223         q  24, 33
3224         ref  24, 33
3225         source  24, 33
3226         span  33
3227         sup  25, 33
3228         x  33
3229
3230   F
3231      Firefox
3232         1.*/2.*  13
3233         3.*  13
3234      footer PI pseudo-attribute  6
3235
3236   G
3237      generator HTML META element  16
3238      Grammar  33
3239
3240   H
3241      h Extension Element  23, 33
3242      header PI pseudo-attribute  6
3243      HTML compliance  15
3244
3245
3246
3247Reschke                                                        [Page 58]
3248
3249Documentation             RFC2629 through XSLT                 July 2008
3250
3251
3252      HTML LINK elements
3253         alternate  15
3254         appendix  15
3255         author  15
3256         chapter  15
3257         contents  15
3258         copyright  15
3259         index  15
3260      HTML META elements
3261         generator  16
3262         keywords  16
3263
3264   I
3265      Identifier DCMI property  16
3266      include PI pseudo-attribute  7
3267      include-references-in-index PI pseudo-attribute  8
3268      index HTML LINK element  15
3269      inline PI pseudo-attribute  6
3270      Internet Explorer 5.5  13
3271      Internet Explorer 6  13
3272      Internet Explorer 7  13
3273      iprnotified PI pseudo-attribute  6
3274
3275   J
3276      justification PI pseudo-attribute  8
3277
3278   K
3279      keywords HTML META element  16
3280
3281   L
3282      length-of Extension Element  23, 33
3283      link Extension Element  23, 33
3284      linkmailto PI pseudo-attribute  6
3285      lt Extension Element  23, 33
3286
3287   M
3288      Microsoft Help  18
3289      Mozilla  13
3290      MSXML3  13
3291      MSXML4  13
3292
3293   N
3294      needLines PI pseudo-attribute  7
3295
3296   O
3297      Opera  13
3298
3299   P
3300
3301
3302
3303Reschke                                                        [Page 59]
3304
3305Documentation             RFC2629 through XSLT                 July 2008
3306
3307
3308      Parameters
3309         xml2rfc-background  6
3310         xml2rfc-comments  6
3311         xml2rfc-compact  6
3312         xml2rfc-editing  6
3313         xml2rfc-ext-allow-markup-in-artwork  8
3314         xml2rfc-ext-authors-section  8
3315         xml2rfc-ext-include-references-in-index  8
3316         xml2rfc-ext-justification  8
3317         xml2rfc-ext-parse-xml-in-artwork  8
3318         xml2rfc-ext-sec-no-trailing-dots  8
3319         xml2rfc-ext-support-rfc2731  8
3320         xml2rfc-footer  6
3321         xml2rfc-header  6
3322         xml2rfc-inline  6
3323         xml2rfc-iprnotified  6
3324         xml2rfc-linkmailto  6
3325         xml2rfc-private  6
3326         xml2rfc-sortrefs  6
3327         xml2rfc-symrefs  6
3328         xml2rfc-toc  6
3329         xml2rfc-tocdepth  6
3330         xml2rfc-topblock  6
3331      parse-xml-in-artwork PI pseudo-attribute  8
3332      private PI pseudo-attribute  6
3333      Processing Instruction pseudo attributes
3334         allow-markup-in-artwork  8
3335         authors-section  8
3336         background  6
3337         comments  6
3338         compact  6
3339         editing  6
3340         footer  6
3341         header  6
3342         ijustification  8
3343         include  7
3344         include-references-in-index  8
3345         inline  6
3346         iprnotified  6
3347         linkmailto  6
3348         needLines  7
3349         parse-xml-in-artwork  8
3350         private  6
3351         sec-no-trailing-dots  8
3352         slides  7
3353         sortrefs  6
3354         strict  7
3355         subcompact  7
3356
3357
3358
3359Reschke                                                        [Page 60]
3360
3361Documentation             RFC2629 through XSLT                 July 2008
3362
3363
3364         support-rfc2731  8
3365         symrefs  6
3366         toc  6
3367         tocdepth  6
3368         tocindent  7
3369         tocompact  7
3370         topblock  6
3371
3372   Q
3373      q Extension Element  24, 33
3374
3375   R
3376      ref Extension Element  24, 33
3377      Relation.Replaces DCMI property  16
3378      RELAX NG Compact Schema  33
3379      rfc.abstract anchor  12
3380      rfc.authors anchor  12
3381      rfc.copyright anchor  12
3382      rfc.copyrightnotice anchor  12
3383      rfc.figure.n anchor  12
3384      rfc.figure.u.n anchor  12
3385      rfc.index anchor  12
3386      rfc.ipr anchor  12
3387      rfc.iref.n anchor  12
3388      rfc.note.n anchor  12
3389      rfc.references anchor  12
3390      rfc.references.n anchor  12
3391      rfc.section.n anchor  12
3392      rfc.section.n.p.m anchor  12
3393      rfc.status anchor  12
3394      rfc.toc anchor  12
3395      rfc.xref.name.n anchor  12
3396
3397   S
3398      Safari  13
3399         3.*  13
3400      Saxon  13
3401      Schema  33
3402      sec-no-trailing-dots PI pseudo-attribute  8
3403      slides PI pseudo-attribute  7
3404      sortrefs PI pseudo-attribute  6
3405      source Extension Element  24, 33
3406      span Extension Element  33
3407      strict PI pseudo-attribute  7
3408      subcompact PI pseudo-attribute  7
3409      sup Extension Element  25, 33
3410      support-rfc2731 PI pseudo-attribute  8
3411      symrefs PI pseudo-attribute  6
3412
3413
3414
3415Reschke                                                        [Page 61]
3416
3417Documentation             RFC2629 through XSLT                 July 2008
3418
3419
3420   T
3421      toc PI pseudo-attribute  6
3422      tocdepth PI pseudo-attribute  6
3423      tocindent PI pseudo-attribute  7
3424      tocompact PI pseudo-attribute  7
3425      topblock PI pseudo-attribute  6
3426
3427   X
3428      x Extension Element  33
3429      Xalan  13
3430      xml-stylesheet PI  15
3431      xml2rfc-background parameter  6
3432      xml2rfc-comments parameter  6
3433      xml2rfc-editing parameter  6
3434      xml2rfc-ext-allow-markup-in-artwork parameter  8
3435      xml2rfc-ext-authors-section parameter  8
3436      xml2rfc-ext-include-references-in-index parameter  8
3437      xml2rfc-ext-justification parameter  8
3438      xml2rfc-ext-parse-xml-in-artwork parameter  8
3439      xml2rfc-ext-sec-no-trailing-dots parameter  8
3440      xml2rfc-ext-support-rfc2731 parameter  8
3441      xml2rfc-footer parameter  6
3442      xml2rfc-header parameter  6
3443      xml2rfc-inline parameter  6
3444      xml2rfc-iprnotified parameter  6
3445      xml2rfc-linkmailto parameter  6
3446      xml2rfc-private parameter  6
3447      xml2rfc-sortrefs parameter  6
3448      xml2rfc-symrefs parameter  6
3449      xml2rfc-toc parameter  6
3450      xml2rfc-tocdepth parameter  6
3451      xml2rfc-topblock parameter  6
3452      xsltproc  13
3453         passing parameters  5
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471Reschke                                                        [Page 62]
3472
3473Documentation             RFC2629 through XSLT                 July 2008
3474
3475
3476Author's Address
3477
3478   Julian F. Reschke
3479   greenbytes GmbH
3480   Hafenweg 16
3481   Muenster, NW  48155
3482   Germany
3483
3484   Phone: +49 251 2807760
3485   Email: julian.reschke@greenbytes.de
3486   URI:   http://greenbytes.de/tech/webdav/
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502
3503
3504
3505
3506
3507
3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527Reschke                                                        [Page 63]
3528
Note: See TracBrowser for help on using the repository browser.