source: rfc2629xslt/rfc2629xslt.txt @ 253

Last change on this file since 253 was 246, checked in by julian.reschke@…, 12 years ago

Update to latest version of rfc2629xslt.

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