/[suikacvs]/doc/rfc-ja/rfc2629-ja.rfcja
Suika

Contents of /doc/rfc-ja/rfc2629-ja.rfcja

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (hide annotations) (download)
Fri May 3 07:29:27 2002 UTC (22 years ago) by wakaba
Branch: MAIN
Changes since 1.1: +3 -3 lines
*** empty log message ***

1 wakaba 1.1 <?xml version="1.0" encoding="iso-2022-jp"?>
2     <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [<!ENTITY rfc.number "2629">]>
3     <?rfc toc="yes"?>
4     <rfc number="2629"
5 wakaba 1.2 xmlns:ja="http://suika.fam.cx/~wakaba/lang/rfc/translation/"
6 wakaba 1.1 xmlns:h="http://www.w3.org/1999/xhtml">
7     <front>
8     <title>Writing I-Ds and RFCs using XML</title>
9     <ja:title xml:lang="ja">XML $B$r;H$C$F(B I-D $B$d(B RFC $B$r=q$/(B</ja:title>
10     <author initials="M.T." surname="Rose" fullname="Marshall T. Rose">
11     <organization>Invisible Worlds, Inc.</organization>
12     <address>
13     <postal>
14     <street>660 York Street</street>
15     <city>San Francisco</city> <region>CA</region> <code>94110</code>
16     <country>US</country>
17     </postal>
18     <phone>+1 415 695 3975</phone>
19     <email>mrose@not.invisible.net</email>
20     <uri>http://invisible.net/</uri>
21     </address>
22     </author>
23     <date month="June" year="1999" />
24     <area>General</area>
25     <keyword>RFC</keyword>
26     <keyword>Request for Comments</keyword>
27     <keyword>I-D</keyword>
28     <keyword>Internet-Draft</keyword>
29     <keyword>XML</keyword>
30     <keyword>Extensible Markup Language</keyword>
31     <abstract>
32     <t>
33     <ja:pair>
34     <ja:l xml:lang="en">
35     This memo presents a technique for using XML
36     (Extensible Markup Language)
37     as a source format for documents in the Internet-Drafts (I-Ds)
38     and Request for Comments (RFC) series.
39     </ja:l>
40     <ja:l xml:lang="ja">
41     $B$3$N%a%b$O!"(B XML ($B3HD%%^!<%/IU$18@8l(B) $B$r(B Internet-Draft (I-D)
42     $B$d(B Request for Comments (RFC) $B7ONs$NJ8=q$N867A<0$H$7$F;HMQ$9$k<jK!$r@bL@$7$^$9!#(B
43     </ja:l>
44     </ja:pair>
45     </t>
46     </abstract>
47     </front>
48     <ja:front>
49     <author fullname="$B$o$+$P(B" ja:id="wakaba">
50     <address>
51     <email>w@suika.fam.cx</email>
52     <uri>http://suika.fam.cx/~wakaba/</uri>
53     </address>
54     </author>
55     <ja:copyright>
56     <ja:item>Copyright &#xa9; $B$o$+$P(B (2002)$B!#A48"J]N1!#(B</ja:item>
57     </ja:copyright>
58     <ja:change>
59     <ja:item year="2002" month="04" day="30"><author ja:ref="wakaba" />
60     <t>$BK]Lu40N;!#(B</t>
61     </ja:item>
62     <ja:item year="2002" month="05" day="03"><author ja:ref="wakaba" />
63     <t>$BLuCm$r4v$D$+DI2C!#K]LuJQ99MzNr$N>O$r?7@_!#(B</t>
64     </ja:item>
65 wakaba 1.2 </ja:change><!-- $Date: 2002/05/03 06:21:38 $ -->
66 wakaba 1.1 <keyword>$B3HD%%^!<%/IU$18@8l(B</keyword>
67     </ja:front>
68     <middle>
69    
70     <section title="Introduction">
71     <t>
72     <ja:pair>
73     <ja:l xml:lang="en">
74     This memo describes how to write a document for the I-D and
75     RFC series using <xref target="XML">the Extensible Markup
76     Language</xref> (XML). This memo has three goals:
77     </ja:l>
78     <ja:l xml:lang="ja">
79     $B$3$N%a%b$O!"(B I-D $B$*$h$S(B RFC
80     $B7ONs$NJ8=q$r(B<xref target="XML">$B3HD%%^!<%/IU$18@8l(B</xref> (XML)
81     $B$r;H$C$F=q$/J}K!$r@bL@$7$^$9!#$3$N%a%b$K$O!";0$D$NL\E*$,$"$j$^$9!#(B
82     </ja:l>
83     </ja:pair>
84    
85     <list style="numbers">
86     <t>
87     <ja:pair>
88     <ja:l xml:lang="en">
89     To describe a simple XML Document Type Definition (DTD) that is
90     powerful enough to handle the simple formatting requirements of RFC-like
91     documents whilst allowing for meaningful markup of descriptive
92     qualities.
93     </ja:l>
94     <ja:l xml:lang="ja">
95     $B0UL#%^!<%/IU$1$N5-=RIJ<A$,2DG=$J(B RFC
96     $B7?J8=q$NC1=c$J=q<0$E$1MW7o$r<h$j07$&$N$K==J,6/NO$G$"$k(B XML
97     $BJ8=q7?Dj5A(B (DTD) $B$N@bL@(B
98     </ja:l>
99     </ja:pair>
100     </t>
101     <t>
102     <ja:pair>
103     <ja:l xml:lang="en">
104     To describe software that processes XML source files,
105     including a tool that produces documents
106     conforming to <xref target="refs.RFC2223">RFC 2223</xref>,
107     HTML format, and so on.
108     </ja:l>
109     <ja:l xml:lang="ja">
110     <xref target="refs.RFC2223">RFC 2223</xref> $B$KE,9g$9$kJ8=q(B,
111     HTML $B7A<0(B, $B$=$NB>$r@8@.$9$kF;6q$r4^$`!"(B
112     XML $B8;%U%!%$%k$r=hM}$9$k%=%U%H%&%'%"$N@bL@(B
113     </ja:l>
114     </ja:pair>
115     </t>
116     <t>
117     <ja:pair>
118     <ja:l xml:lang="en">
119     To provide the proof-of-concept for the first two goals
120     (this memo was written using this DTD and produced using that
121     software).
122     </ja:l>
123     <ja:l xml:lang="ja">
124     $BA0=R$N(B2$B$D$NL\E*$N35G0$N>ZL@$NDs6!(B ($B$3$N%a%b$O$=$N(B DTD
125     $B$r;H$C$F<9I.$5$l!"$=$&$7$?%=%U%H%&%'%"$r;H$C$F@8@.$5$l$^$7$?!#(B)
126     </ja:l>
127     </ja:pair>
128     </t>
129     </list>
130     </t>
131     <t>
132     <ja:pair>
133     <ja:l xml:lang="en">
134     It is beyond the scope of this memo to discuss the political
135     ramifications of using XML as a source format for RFC-like documents.
136     Rather,
137     it is simply noted that adding minimal markup to plain text:
138     </ja:l>
139     <ja:l xml:lang="ja">
140     RFC $BE*J8=q$N8;7A<0$H$7$F(B XML $B$r;H$&$3$H$N@/<#E*5DO@$O$3$N%a%b$NE,MQHO0O30$G$9!#$=$l$h$j$b!"J?J8(B (plain text) $B$K:G>.$N%^!<%/IU$1$r2C$($k$3$H$G!"(B
141     </ja:l>
142     </ja:pair>
143    
144     <list style="symbols">
145     <t>
146     <ja:pair>
147     <ja:l xml:lang="en">
148     allows the traditional production of textual RFC-like documents using
149     familiar editors;
150     </ja:l>
151     <ja:l xml:lang="ja">
152     $B$h$/CN$i$l$F$$$k%(%G%#%?!<$r;H$C$FJ8;z$J(B RFC $BE*J8=q$NEAE}E*@8@.$,2DG=$K$J$k(B
153     </ja:l>
154     </ja:pair>
155     </t>
156     <t>
157     <ja:pair>
158     <ja:l xml:lang="en">
159     requires some, albeit minimal, additions to existing software
160     environments; and,
161     </ja:l>
162     <ja:l xml:lang="ja">
163     $B4v$D$+!":GDc$G$b!"4{B8$N%=%U%H%&%'%"4D6-$KDI2C$,I,MW$G$"$k(B
164     </ja:l>
165     </ja:pair>
166     </t>
167     <t>
168     <ja:pair>
169     <ja:l xml:lang="en">
170     permits information to be organized, searched, and retrieved
171     using both unstructured and structured mechanisms.
172     </ja:l>
173     <ja:l xml:lang="ja">
174     $BHs9=B$2=!&9=B$2=$NN>5!9=$r;H$C$F>pJs$rAH?%2=$7$?$j8!:w$7$?$j<h$j=P$7$?$j=PMh$k(B
175     </ja:l>
176     </ja:pair>
177     </t>
178     </list>
179    
180     <ja:pair>
181     <ja:l xml:lang="ja">
182     $B$H$$$&$3$H$rC1$K5-$9$b$N$G$9!#(B
183     </ja:l>
184     </ja:pair>
185     </t>
186     </section>
187    
188     <section title="Using the DTD to Write I-Ds and RFCs" ja:title-ja="I-D $B$d(B RFC $B$r=q$/$N$K(B DTD $B$r;H$&(B">
189     <t>
190     <ja:pair>
191     <ja:l xml:lang="en">
192     We do not provide a formal or comprehensive description of XML.
193     Rather,
194     this section discusses just enough XML to use a Document Type
195     Declaration (DTD) to write RFC-like documents.
196     </ja:l>
197     <ja:l xml:lang="ja">
198     XML $B$K$D$$$F$N@5<0$J!"$"$k$$$OJq3gE*$J@bL@$O$7$^$;$s!#(B
199     $B$3$N@a$G$O!"(B RFC $BE*J8=q$r=q$/$?$a$NJ8=q7?@k8@(B (DTD)
200     $B$r;H$&$N$KI,MW$J$@$1$NOC$r$7$^$9!#(B
201     </ja:l>
202     </ja:pair>
203     </t>
204     <t>
205     <ja:pair>
206     <ja:l xml:lang="en">
207     If you're already familiar with XML,
208     skip to <xref target="rfc.dtd" /> to look at the DTD.
209     </ja:l>
210     <ja:l xml:lang="ja">
211     XML $B$K$D$$$F4{$K$h$/J,$+$C$F$$$k$J$i!"(B<xref target="rfc.dtd" />$B$KHt$s$G!"(B DTD $B$r8fMw2<$5$$!#(B
212     </ja:l>
213     </ja:pair>
214     </t>
215    
216     <section anchor="xml_basics" title="XML basics" ja:title-ja="XML $B$N4pAC(B">
217     <t>
218     <ja:pair>
219     <ja:l xml:lang="en">
220     There are very few rules when writing in XML,
221     as the syntax is simple.
222     There are five terms you'll need to know:
223     </ja:l>
224     <ja:l xml:lang="ja">
225     XML $B$O9=J8$,4JC1$J$N$G!"=q$/;~$KI,MW$J$N$O$[$s$N>/$7$N5,B'$@$1$G$9!#CN$C$F$*$/$Y$-$3$H$O(B5$B$D$"$j$^$9!#(B
226     </ja:l>
227     </ja:pair>
228    
229     <list style="numbers">
230     <t>
231     <ja:pair>
232     <ja:l xml:lang="en">
233     An $B!H(Belement$B!I(B usually refers to a start tag, an end tag, and all the
234     characters in between,
235     e.g.,
236     "&lt;example&gt;text and/or nested elements&lt;/example&gt;"
237     </ja:l>
238     <ja:l xml:lang="ja">
239     $B!VMWAG!W$ODL>o3+;O%?%0$H=*N;%?%0!"$=$l$K4V$NA4$F$NJ8;z!"Nc$($P(B
240     <h:samp>&lt;$BNc(B&gt;$BJ8;z$H$+F~$l;R$NMWAG(B&lt;/$BNc(B&gt;</h:samp>
241     $B$r;X$7$^$9!#(B
242     </ja:l>
243     </ja:pair>
244     </t>
245     <t>
246     <ja:pair>
247     <ja:l xml:lang="en">
248     An "empty element" combines the start tag and the end tag,
249     e.g.,
250     "&lt;empty/&gt;".
251     You don't find these in HTML.
252     </ja:l>
253     <ja:l xml:lang="ja">
254     $B!V6uMWAG!W$O3+;O%?%0$H=*N;%?%0$,$/$C$D$$$F!"(B
255     <h:samp>&lt;$B6u(B/&gt;</h:samp> $B$N$h$&$K$J$j$^$9!#(B
256     HTML $B$K$O$3$l$O$"$j$^$;$s!#(B
257     </ja:l>
258     </ja:pair>
259     </t>
260     <t>
261     <ja:pair>
262     <ja:l xml:lang="en">
263     An "attribute" is part of an element.
264     If present, they occur in the start tag, e.g.,
265     "&lt;example name='value'&gt;".
266     Of course,
267     they can also appear in empty elements, e.g.,
268     "&lt;empty name='value'/&gt;".
269     </ja:l>
270     <ja:l xml:lang="ja">
271     $B!VB0@-!W$OMWAG$N0lIt$G$9!#B8:_$9$k>l9g!"3+;O%?%0Cf$K!"(B
272     <h:samp>&lt;$BNc(B $BL>A0(B='$BCM(B'&gt;</h:samp>
273     $B$NMM$K8=$l$^$9!#$b$A$m$s!"6uMWAGCf$G$b(B
274     <h:samp>&lt;$B6u(B $BL>A0(B='$BCM(B'/&gt;</h:samp> $B$NMM$K;H$($^$9!#(B
275     </ja:l>
276     </ja:pair>
277     </t>
278     <t>
279     <ja:pair>
280     <ja:l xml:lang="en">
281     An "entity" is a textual macro that starts with "&amp;".
282     Don't worry about these,
283     you'll only use them whenever you want to put a "&amp;" or a "&lt;" in
284     your text.
285     </ja:l>
286     <ja:l xml:lang="ja">
287     $B!V<BBN!W$OJ8;z%^%/%m$G!"!V(B&amp;$B!W$G;O$^$j$^$9!#(B
288     $B$J!A$K?4G[$7$J$5$s$J!"!V(B&amp;$B!W$d!V(B&lt;$B!W$rJ8Cf$KF~$l$?$$;~$K$@$1$$$D$G$b;H$&$3$H$,=PMh$^$9!#(B
289     </ja:l>
290     </ja:pair>
291     </t>
292     <t>
293     <ja:pair>
294     <ja:l xml:lang="en">
295     A "token" is a string of characters.
296     The first character is either a letter or an underscore ("_").
297     Any characters that follow are either letters, numbers, an
298     underscore, or a period (".").
299     </ja:l>
300     <ja:l xml:lang="ja">
301     $B!V;z6g(B (token)$B!W(B $B$OJ8;z$NNs$G$9!#:G=i$NJ8;z$OJ8;z$+2<@~(B ($B!V(B_$B!W(B)
302     $B$G$9!#$=$N8e$NJ8;z$OJ8;z!"?t;z!"2<@~!"6gE@(B ($B!V(B.$B!W(B) $B$G$9!#(B
303     <ja:note>$B$3$3$GJ8;z$H$O!"(B26$B!_(B2$B<oN`$N4pK\%i%F%s;zJl$N$3$H$G$9!#(B</ja:note>
304     </ja:l>
305     </ja:pair>
306     </t>
307     </list>
308     </t>
309     <figure>
310     <preamble>
311     <ja:pair>
312     <ja:l xml:lang="en">
313     First,
314     start your source file with an XML declaration,
315     a reference to the DTD,
316     and the "rfc" element:
317     </ja:l>
318     <ja:l xml:lang="ja">
319     $B:G=i$K!"8;%U%!%$%k$O(B XML $B@k8@(B, DTD $B$X$N;2>H(B, $B!V(Brfc$B!WMWAG$G;O$a$^$9!#(B
320     </ja:l>
321     </ja:pair>
322     </preamble>
323     <artwork><![CDATA[
324     <?xml version="1.0"?>
325     <!DOCTYPE rfc SYSTEM "rfc]]>&rfc.number;<![CDATA[.dtd">
326     <rfc>
327     ...
328     </rfc>
329     ]]></artwork>
330     <postamble>
331     <ja:pair>
332     <ja:l xml:lang="en">
333     Ignore the first two lines
334     $B!=!=(B the declaration and the reference $B!=!=(B
335     and simply treat them as opaque strings.
336     Nothing else should be present after the "&lt;/rfc&gt;" tag.
337     </ja:l>
338     <ja:l xml:lang="ja">
339     $B:G=i$N(B2$B9T(B ($B@k8@$H;2>H(B) $B$OL5;k$7!"C1$K<vJ8$@$H;W$C$F2<$5$$!#(B
340     $B!V(B&lt;/rfc&gt;$B!W%?%0$N8e$K$O2?$b8=$l$k$Y$-$G$O$"$j$^$;$s!#(B
341     <ja:note>rfc $BMWAG$K$D$$$F$O!"(B <xref target="rfc" /> $B$K@bL@$,$"$j$^$9!#(B</ja:note>
342     </ja:l>
343     </ja:pair>
344     </postamble>
345     </figure>
346     <t>
347     <ja:pair>
348     <ja:l xml:lang="en">
349     Second,
350     make sure that all elements are properly matched and nested.
351     A properly matched element that starts with
352     "&lt;example&gt;" is eventually followed with "&lt;/example&gt;".
353     (Empty elements are always matched.)
354     Elements are properly nested when they don't overlap.
355     </ja:l>
356     <ja:l xml:lang="ja">
357     $BFsHVL\$K!"A4$F$NMWAG$,E,@Z$KBP1~!&F~$l;R$K$J$C$F$$$k$+3N$+$a$F2<$5$$!#(B
358     <h:samp>&lt;$BNc(B&gt;</h:samp> $B$G;O$^$kE,@Z$KBP1~$9$kMWAG$O!":G=*E*$K$O(B
359     <h:samp>&lt;/$BNc(B&gt;</h:samp> $B$,B3$/$3$H$K$J$j$^$9!#(B
360     ($B6uMWAG$O>o$KBP1~$7$F$$$^$9!#(B)
361     $B3FMWAG$O=EJ#$7$F$$$J$$;~$GE,@Z$KF~$l;R$K$J$C$F$$$^$9!#(B
362     </ja:l>
363     </ja:pair>
364     </t>
365     <figure>
366     <preamble>
367     <ja:pair>
368     <ja:l xml:lang="en">
369     For example,
370     </ja:l>
371     <ja:l xml:lang="ja">
372     $BNc$($P!"(B
373     </ja:l>
374     </ja:pair>
375     </preamble>
376     <artwork><![CDATA[
377     <outer>
378     ...
379     <inner>
380     ...
381     </inner>
382     ...
383     </outer>
384     ]]></artwork>
385     <postamble>
386     <ja:pair>
387     <ja:l xml:lang="en">
388     is properly nested.
389     </ja:l>
390     <ja:l xml:lang="ja">
391     $B$OE,@Z$KF~$jAH$s$G$$$^$9!#(B
392     </ja:l>
393     </ja:pair>
394     </postamble>
395     </figure>
396     <figure>
397     <preamble>
398     <ja:pair>
399     <ja:l xml:lang="en">
400     However,
401     </ja:l>
402     <ja:l xml:lang="ja">
403     $B$7$+$7!"(B
404     </ja:l>
405     </ja:pair>
406     </preamble>
407     <artwork><![CDATA[
408     <outer>
409     ...
410     <inner>
411     ...
412     </outer>
413     ...
414     </inner>
415     ]]></artwork>
416     <postamble>
417     <ja:pair>
418     <ja:l xml:lang="en">
419     overlaps, so the elements aren't properly nested.
420     </ja:l>
421     <ja:l xml:lang="ja">
422     $B$O=E$J$C$F$$$k$N$G!"MWAG$O@5$7$/F~$l;R$K$J$C$F$$$^$;$s!#(B
423     </ja:l>
424     </ja:pair>
425     </postamble>
426     </figure>
427     <t>
428     <ja:pair>
429     <ja:l xml:lang="en">
430     Third,
431     never use "&lt;" or "&amp;" in your text.
432     Instead, use either "&amp;lt;" or "&amp;amp;", respectively.
433     </ja:l>
434     <ja:l xml:lang="ja">
435     $B;0HVL\$K!"!V(B&lt;$B!W$d!V(B&amp;$B!W$rJ8Cf$K;H$C$F$O$$$1$^$;$s!#Be$o$j$K!"$=$l$>$l!V(B&amp;lt;$B!W$H!V(B&amp;amp;$B!W$r;H$$$^$9!#(B
436     </ja:l>
437     </ja:pair>
438     </t>
439     <t>
440     <ja:pair>
441     <ja:l xml:lang="en">
442     Fourth,
443     there are two quoting characters in XML, 'apostrophe' and "quotation".
444     Make sure that all attributes values are quoted,
445     e.g., "&lt;example name='value'&gt;",
446     If the value contains one of the quoting characters,
447     then use the other to quote the value,
448     e.g., "&lt;example name='"'&gt;",
449     If the value contains both quoting characters,
450     then use one of them to quote the value,
451     and replace occurrances of that character in the attribute value with
452     either '&amp;apos;' (apostrophe) or "&amp;quot;" (quotation),
453     e.g., "&lt;example name='"&amp;apos;"'&gt;".
454     </ja:l>
455     <ja:l xml:lang="ja">
456     $B;MHVL\$K!"(B XML $B$G$O(B '$B%"%]%9%H%m%U%#(B' $B$H(B "$B0zMQ(B"
457     $B$NFs<oN`$N0zMQJ8;z$,$"$j$^$9!#A4$F$NB0@-CM$r!"(B
458     <h:samp>6lt;$BNc(B $BL>A0(B='$BCM(B'&gt;</h:samp> $B$NMM$K0zMQId$G0O$`$3$H$r3NG'$7$F2<$5$$!#CM$K0zMQJ8;z$N0lJ}$,;H$o$l$F$$$k;~$O!"(B
459     <h:samp>&lt;$BNc(B $BL>A0(B='"'&gt;</h:samp> $B$NMM$KB>J}$rCM$r0O$`$N$K;H$$$^$9!#(B
460     $BCM$,0zMQJ8;z$NN>J}$r4^$s$G$$$k>l9g!"$I$A$i$+$rCM$r0O$`$N$K;H$$!"B0@-CM$K;H$o$l$F$$$kJ8;z$r(B '&amp;apos;' ($B%"%]%9%H%m%U%#(B) $B$^$?$O(B "&amp;quot;"
461     ($B0zMQ(B) $B$KCV$-49$($F!"(B <h:samp>&lt;$BNc(B $BL>A0(B='"&amp;apos;"'&gt;"</h:samp>
462     $B$N$h$&$K$7$^$9!#(B
463     </ja:l>
464     </ja:pair>
465     </t>
466     <figure>
467     <preamble>
468     <ja:pair>
469     <ja:l xml:lang="en">
470     If you want to put a comment in your source file,
471     here's the syntax:
472     </ja:l>
473     <ja:l xml:lang="ja">
474     $B8;%U%!%$%k$KCm<a$rF~$l$?$$;~$O!"<!$N9=J8$NMM$K$7$^$9!#(B
475     </ja:l>
476     </ja:pair>
477     </preamble>
478    
479     <ja:pair>
480     <ja:l xml:lang="en">
481     <artwork><![CDATA[
482     <!-- comments can be multiline,
483     if you wish -->
484     ]]></artwork>
485     </ja:l>
486     <ja:l xml:lang="ja">
487     <artwork><![CDATA[
488     <!-- $BCm<a9T$O!"I,MW$J$i(B
489     $BJ#?t9T$K=PMh$^$9!#(B -->
490     ]]></artwork>
491     <postamble>
492     <ja:note>$B$^$?!"Cm<aCf$K!V(B--$B!W$r;H$C$F$O$$$1$^$;$s!#(B</ja:note>
493     </postamble>
494     </ja:l>
495     </ja:pair>
496    
497     </figure>
498     <t>
499     <ja:pair>
500     <ja:l xml:lang="en">
501     Finally,
502     XML is case sensitive.
503     </ja:l>
504     <ja:l xml:lang="ja">
505     $B8^HVL\$K!"(B XML $B$OBgJ8;z$H>.J8;z$r6hJL$7$^$9!#(B
506     </ja:l>
507     </ja:pair>
508     </t>
509     </section>
510    
511     <section anchor="front_matter" title="Front matter">
512     <figure>
513     <preamble>
514     <ja:pair>
515     <ja:l xml:lang="en">
516     Immediately following the "&lt;rfc&gt;" tag is the "front"
517     element:
518     </ja:l>
519     <ja:l xml:lang="ja">
520     "&lt;rfc&gt;" $B%?%0$ND>$08e$KB3$/$N$O(B "front" $BMWAG$G$9!#(B
521     </ja:l>
522     </ja:pair>
523     </preamble>
524     <artwork><![CDATA[
525     <?xml version="1.0"?>
526     <!DOCTYPE rfc SYSTEM "rfc]]>&rfc.number;<![CDATA[.dtd">
527     <rfc>
528     <front>
529     <title ...>
530     <author ...>
531     <author ...>
532     <date ...>
533     <area ...>
534     <workgroup ...>
535     <keyword ...>
536     <keyword ...>
537     <abstract ...>
538     <note ...>
539     </front>
540     ...
541     </rfc>
542     ]]></artwork>
543     <postamble>
544     <ja:pair>
545     <ja:l xml:lang="en">
546     (Note that in all examples,
547     indentation is used only for expository purposes.)
548     </ja:l>
549     <ja:l xml:lang="ja">
550     ($BA4$F$NNc$G!";z2<$2$O@bL@$N$?$a$@$1$K;H$C$F$$$k$3$H$KCm0U$7$F2<$5$$!#(B)
551     </ja:l>
552     </ja:pair>
553     </postamble>
554     </figure>
555     <t>
556     <ja:pair>
557     <ja:l xml:lang="en">
558     The "front" element consists of a "title" element,
559     one or more "author" elements,
560     a "date" element,
561     one or more optional "area" elements,
562     one or more optional "workgroup" elements,
563     one or more optional "keyword" elements,
564     an optional "abstract" element.
565     and,
566     one or more optional "note" elements.
567     </ja:l>
568     <ja:l xml:lang="ja">
569     "front" $BMWAG$O(B "title" $BMWAG(B, 1$B$D0J>e$N(B "author" $BMWAG(B, "date" $BMWAG(B,
570     1$B$D0J>e$N>JN,2DG=$J(B "area" $BMWAG(B,
571     1$B$D0J>e$N>JN,2DG=$J(B "workgroup" $BMWAG(B,
572     1$B$D0J>e$N>JN,2DG=$J(B "keyword" $BMWAG(B,
573     $B>JN,2DG=$J(B "abstract" $BMWAG(B,
574     1$B$D0J>e$N>JN,2DG=$J(B "note" $BMWAG$+$i@.$j$^$9!#(B
575     </ja:l>
576     </ja:pair>
577     </t>
578     <section title="The title Element" ja:title-ja="title $BMWAG(B">
579     <figure>
580     <preamble>
581     <ja:pair>
582     <ja:l xml:lang="en">
583     The "title" element identifies the title of the document.
584     Because the title will be used in the headers of the document when formatted
585     according to <xref target="refs.RFC2223" />,
586     if the title is more than 42 characters,
587     then an abbreviation should also be provided,
588     e.g.,
589     </ja:l>
590     <ja:l xml:lang="ja">
591     "title" $BMWAG$O!"J8=q$NBj$r<1JL$7$^$9!#Bj$O(B
592     <xref target="refs.RFC2223" /> $B$K=>$C$F@07A$9$k;~$KJ8=q$NF,$K;H$o$l$k$N$G!"Bj$O(B42$BJ8;z0J>e$N;~$O!">JN,7A$bM?$($k$Y$-$G$9!#Nc$($P!"<!$N$h$&$K$7$^$9!#(B
593     </ja:l>
594     </ja:pair>
595     </preamble>
596     <artwork><![CDATA[
597     <title abbrev="Much Ado about Nothing">
598     The IETF's Discussion on "Source Format of RFC Documents"
599     </title>
600     ]]></artwork>
601     </figure>
602     </section>
603     <section anchor="author" title="The author Element" ja:title-ja="author $BMWAG(B">
604     <figure>
605     <preamble>
606     <ja:pair>
607     <ja:l xml:lang="en">
608     Each "author" element identifies a document author.
609     Since a document may have more than one author,
610     more than one "author" element may be present.
611     If the author is a person,
612     then three attributes must be present in the "&lt;author&gt;" tag,
613     "initials", "surname", and "fullname",
614     e.g.,
615     </ja:l>
616     <ja:l xml:lang="ja">
617     $B3F(B "author" $BMWAG$O!"J8=q$NMWAG$r<1JL$7$^$9!#J8=q$K$OJ#?t?M$NCx<T$,$$F@$^$9$N$G!"J#?t$N(B
618     "author" $BMWAG$r;H$&$3$H$,=PMh$^$9!#Cx<T$,?MJ*$G$"$k;~$O!"(B
619     "initials" ($BF,J8;z(B), "surname" ($B@+(B), "fullname" ($BA4L>(B) $B$N(B3$B$D$NB0@-$,(B
620     "author" $B%?%0$K$J$1$l$P$J$j$^$;$s!#Nc$($P!"<!$NMM$K$7$^$9!#(B
621     </ja:l>
622     </ja:pair>
623     </preamble>
624     <artwork><![CDATA[
625     <author initials="M.T." surname="Rose"
626     fullname="Marshall T. Rose">
627     ]]></artwork>
628     </figure>
629     <t>
630     <ja:pair>
631     <ja:l xml:lang="en">
632     The "author" element itself consists of an "organization" element,
633     and,
634     an optional "address" element.
635     </ja:l>
636     <ja:l xml:lang="ja">
637     "author" $BMWAG<+?H$O(B "organization" $BMWAG$H!">JN,2DG=$J(B "address"
638     $BMWAG$+$i@.$j$^$9!#(B
639     </ja:l>
640     </ja:pair>
641     </t>
642     <figure>
643     <preamble>
644     <ja:pair>
645     <ja:l xml:lang="en">
646     The "organization" element is similar to the "title"
647     element,
648     in that an abbreviation may be paired with a long organization name
649     using the "abbrev" attribute, e.g.,
650     </ja:l>
651     <ja:l xml:lang="ja">
652     "organization" $BMWAG$O(B "title" $BMWAG$HF1$8MM$K!"D9$$AH?%L>$K(B
653     "abbrev" $BB0@-$r;H$C$F<!$NNc$NMM$K>JN,L>$r;XDj$9$k$3$H$,=PMh$^$9!#(B
654     </ja:l>
655     </ja:pair>
656     </preamble>
657     <artwork><![CDATA[
658     <organization abbrev="ISI">
659     USC/Information Sciences Institute
660     </organization>
661     ]]></artwork>
662     </figure>
663     <t>
664     <ja:pair>
665     <ja:l xml:lang="en">
666     The "address" element consists of an optional "postal" element,
667     an optional "phone" element,
668     an optional "facsimile" element,
669     an optional "email" element,
670     and,
671     an optional "uri" element.
672     </ja:l>
673     <ja:l xml:lang="ja">
674     "address" $BMWAG$O>JN,2DG=$J(B "postal" $BMWAG(B,
675     $B>JN,2DG=$J(B "phone" $BMWAG(B,
676     $B>JN,2DG=$J(B "facsimile" $BMWAG(B,
677     $B>JN,2DG=$J(B "email" $BMWAG(B,
678     $B>JN,2DG=$J(B "uri" $BMWAG$+$i@.$j$^$9!#(B
679     </ja:l>
680     </ja:pair>
681     </t>
682     <figure>
683     <preamble>
684     <ja:pair>
685     <ja:l xml:lang="en">
686     The "postal" element contains one or more "street" elements,
687     followed by any combination of "city", "region" (state or province),
688     "code" (zipcode or postal code), and "country" elements, e.g.,
689     </ja:l>
690     <ja:l xml:lang="ja">
691     "postal" $BMWAG$O<!$NNc$NMM$K!"(B1$B$D0J>e$N(B "street" $BMWAG(B, $B$=$l$KB3$/(B
692     "city", "region" ($B=#$dCOJ}(B), "code" ($BM9JXHV9f(B), "country"
693     $B3FMWAG$N<+M3$JAH9g$;$+$i@.$j$^$9!#(B
694     </ja:l>
695     </ja:pair>
696     </preamble>
697     <artwork><![CDATA[
698     <postal>
699     <street>660 York Street</street>
700     <street>M/S 40</street>
701     <city>San Francisco</city> <region>CA</region>
702     <code>94110</code>
703     <country>US</country>
704     </postal>
705     ]]></artwork>
706     <postamble>
707     <ja:pair>
708     <ja:l xml:lang="en">
709     This flexibility is provided to allow for different national
710     formats for postal addresses.
711     Note however,
712     that although the order of the "city", "region", "code", and "country"
713     elements isn't specified,
714     at most one of each may be present.
715     Regardless,
716     these elements must not be re-ordered during processing by an XML
717     application
718     (e.g., display applications must preserve the ordering of the
719     information contained in these elements).
720     Finally,
721     the value of the "country" element should be a two-letter
722     code from ISO 3166.
723     </ja:l>
724     <ja:l xml:lang="ja">
725     $B$3$N=@Fp$5$K$h$j!"0[$J$C$?9q2HM9JX=;=j7A<0$,;H$($^$9!#(B
726     $B$7$+$7!"(B "city", "region", "code", "country"
727     $B3FMWAG$N=g=x$O5,Dj$7$F$$$^$;$s$,!"$3$NFb$N$;$$$<$$(B1$B$D$O=P8=$9$k$+$b$7$l$J$$$3$H$KCm0U$7$F2<$5$$!#$H$K$+$/!"$3$l$i$NMWAG$O(B
728     XML $B1~MQ$N=hM}$N2aDx$G=g=x$rF~$lBX$($F$O$J$j$^$;$s!#(B
729     ($BNc$($P!"I=<(1~MQ$O$3$l$i$NMWAG$K4^$^$l$k>pJs$N=g=x$rJ]$?$J$1$l$P$J$j$^$;$s!#(B)
730     $B:G8e$K!"(B "country" $BMWAG$NCM$O(B ISO 3166 $B$N(B2$BJ8;zId9f$H$9$k$Y$-$G$9!#(B
731     </ja:l>
732     </ja:pair>
733     </postamble>
734     </figure>
735     <figure>
736     <preamble>
737     <ja:pair>
738     <ja:l xml:lang="en">
739     The "phone", "facsimile", "email", and "uri" elements are
740     simple, e.g.,
741     </ja:l>
742     <ja:l xml:lang="ja">
743     "phone", "facsimile", "email", "uri" $B3FMWAG$O4JC1$G!"<!$NMM$J46$8$G$9!#(B
744     </ja:l>
745     </ja:pair>
746     </preamble>
747     <artwork><![CDATA[
748     <phone>+1 415 695 3975</phone>
749     <email>mrose@not.invisible.net</email>
750     <uri>http://invisible.net/</uri>
751     ]]></artwork>
752     </figure>
753     </section>
754     <section anchor="date" title="The date Element" ja:title-ja="date $BMWAG(B">
755     <figure>
756     <preamble>
757     <ja:pair>
758     <ja:l xml:lang="en">
759     The "date" element identifies the publication date of the
760     document.
761     It consists of a month and a year, e.g.,
762     </ja:l>
763     <ja:l xml:lang="ja">
764     "date" $BMWAG$OJ8=q$N=PHG$NF|IU$r<($7$^$9!#<!$N$h$&$K7n$HG/$+$i@.$j$^$9!#(B
765     </ja:l>
766     </ja:pair>
767     </preamble>
768     <artwork><![CDATA[
769     <date month="February" year="1999" />
770     ]]></artwork>
771     <postamble>
772     <ja:pair>
773     <ja:l xml:lang="en">
774     The "date" element also has an optional day attribute.
775     </ja:l>
776     <ja:l xml:lang="ja">
777     "date" $BMWAG$K$O>JN,2DG=$J(B day $BB0@-$b$"$j$^$9!#(B
778     </ja:l>
779     </ja:pair>
780     </postamble>
781     </figure>
782     </section>
783     <section title="Meta Data Elements" ja:title-ja="$B%a%?!&%G!<%?MWAG(B">
784     <t>
785     <ja:pair>
786     <ja:l xml:lang="en">
787     The "front" element may contain meta data $B!=!=(B
788     the content of these elements does not appear in printed versions of
789     the document.
790     </ja:l>
791     <ja:l xml:lang="ja">
792     "front" $BMWAG$O%a%?!&%G!<%?(B ($BFbMF$OJ8=q$N0u:~HG$K$O=P8=$7$J$$$b$N(B) $B$b4^$`$3$H$,=PMh$^$9!#(B
793     </ja:l>
794     </ja:pair>
795     </t>
796     <figure>
797     <preamble>
798     <ja:pair>
799     <ja:l xml:lang="en">
800     A document has one or more optional "area",
801     "workgroup" and "keyword" elements, e.g.,
802     </ja:l>
803     <ja:l xml:lang="ja">
804     $BJ8=q$O(B1$B$D0J>e$N>JN,2DG=$J(B "area", "workgroup", "keyword"
805     $B3FMWAG$r<!$NNc$NMM$K;}$A$^$9!#(B
806     </ja:l>
807     </ja:pair>
808     </preamble>
809     <artwork><![CDATA[
810     <area>General</area>
811     <workgroup>RFC Beautification Working Group</workgroup>
812     <keyword>RFC</keyword>
813     <keyword>Request for Comments</keyword>
814     <keyword>I-D</keyword>
815     <keyword>Internet-Draft</keyword>
816     <keyword>XML</keyword>
817     <keyword>Extensible Markup Language</keyword>
818     ]]></artwork>
819     <postamble>
820     <ja:pair>
821     <ja:l xml:lang="en">
822     The "area" elements identify a general category for the
823     document
824     (e.g., one of "Applications", "General", "Internet", "Management",
825     "Operations", "Routing", "Security", "Transport", or "User"),
826     while the "workgroup" elements identify the IETF working groups that
827     produced the document,
828     and the "keyword" elements identify useful search terms.
829     </ja:l>
830     <ja:l xml:lang="ja">
831     "area" $BMWAG$OJ8=q$N0lHLJ,N`(B ("Applications" ($B1~MQ(B),
832     "General" ($B0lHL(B), "Internet", "Management" ($B7P1D(B),
833     "Operations" ($B:n6H(B), "Routing" ($B7PO)(B), "Security" ($BJ]0B(B),
834     "Transport" ($BM"Aw(B), "User" ($BMxMQ<T(B)) $B$r<($7!"(B
835     "workgroup" $BMWAG$OJ8=q$r=P$7$?(B IETF $B:n6HIt2q$r<($7!"(B
836     "keyword" $BMWAG$OM-MQ$J8!:w8l$r<($7$^$9!#(B
837     </ja:l>
838     </ja:pair>
839     </postamble>
840     </figure>
841     </section>
842     <section title="The abstract Element" ja:title-ja="abstract $BMWAG(B">
843     <figure>
844     <preamble>
845     <ja:pair>
846     <ja:l xml:lang="en">
847     A document may have an "abstract" element,
848     which contains one or more <xref target="t">"t" elements</xref>.
849     In general,
850     only a single "t" element is present,
851     e.g.,
852     </ja:l>
853     <ja:l xml:lang="ja">
854     $BJ8=q$K$O(B "abstract" $BMWAG$r;H$&$3$H$,=PMh$F!"(B
855     $B$=$l$K$O(B1$B$D0J>e$N(B <xref target="t">"t" $BMWAG(B</xref>$B$,4^$a$i$l$^$9!#DL>o!"<!$NNc$NMM$K!"(B "t" $BMWAG$r(B1$B$D$@$1;H$$$^$9!#(B
856     </ja:l>
857     </ja:pair>
858     </preamble>
859    
860     <ja:pair>
861     <ja:l xml:lang="en">
862     <artwork><![CDATA[
863     <abstract>
864     <t>This memo presents a technique for using XML
865     (Extensible Markup Language) as a source format
866     for documents in the Internet-Drafts (I-Ds) and
867     Request for Comments (RFC) series.</t>
868     </abstract>
869     ]]></artwork>
870     </ja:l>
871     <ja:l xml:lang="ja">
872     <artwork><![CDATA[
873     <abstract>
874     <t>$B$3$N%a%b$O!"(B XML ($B3HD%%^!<%/IU$18@8l(B) $B$r(B
875     Internet-Draft (I-D) $B$d(B Request for Comments (RFC)
876     $B7ONs$NJ8=q$N867A<0$H$7$F;HMQ$9$k<jK!$r@bL@$7$^$9!#(B</t>
877     </abstract>
878     ]]></artwork>
879     </ja:l>
880     </ja:pair>
881    
882     </figure>
883     </section>
884     <section title="The note Element" ja:title-ja="note $BMWAG(B">
885     <figure>
886     <preamble>
887     <ja:pair>
888     <ja:l xml:lang="en">
889     A document may have one or more "note" elements,
890     each of which contains one or more <xref target="t">"t" elements</xref>.
891     There is a mandatory "title" attribute.
892     In general,
893     the "note" element contains text from the IESG,
894     e.g.,
895     </ja:l>
896     <ja:l xml:lang="ja">
897     $BJ8=q$K$O(B1$B$D0J>e$N(B "note" $BMWAG$r;H$&$3$H$,=PMh$F!"(B
898     $B$=$l$>$l(B1$B$D0J>e$N(B <xref target="t">"t" $BMWAG(B</xref>$B$,4^$a$i$l$^$9!#I,?\$N(B
899     "title" $BB0@-$,$"$j$^$9!#DL>o!"(B "note" $BMWAG$O(B IESG
900     $B$+$i$NJ8$r<!$NNc$NMM$KF~$l$^$9!#(B
901     </ja:l>
902     </ja:pair>
903     </preamble>
904    
905     <ja:pair>
906     <ja:l xml:lang="en">
907     <artwork><![CDATA[
908     <note title="IESG Note">
909     <t>The IESG has something to say.</t>
910     </note>
911     ]]></artwork>
912     </ja:l>
913     <ja:l xml:lang="ja">
914     <artwork><![CDATA[
915     <note title="IESG $BCm5-(B">
916     <t>IESG $B$OFC$K8@$&$3$H$O$"$j$^$;$s!#(B</t>
917     </note>
918     ]]></artwork>
919     </ja:l>
920     </ja:pair>
921    
922     </figure>
923     </section>
924     <section title="Status, Copyright Notice, Table of Contents" ja:title-ja="$B0LCVIU$1(B, $BCx:n8"I=<((B, $BL\<!(B">
925     <t>
926     <ja:pair>
927     <ja:l xml:lang="en">
928     Note that text relating to the memo's status, copyright notice, or
929     table of contents is not included in the document's markup $B!=!=(B this is
930     automatically inserted by an XML application when it produces either
931     a text or HTML version of the document.
932     </ja:l>
933     <ja:l xml:lang="ja">
934     $B%a%b$N0LCVIU$1$r@bL@$9$kJ8>O(B, $BCx:n8"I=<((B,
935     $BL\<!$OJ8=q$N%^!<%/IU$1$K$O4^$a$^$;$s!#$3$l$O(B XML
936     $B1~MQ$,J8=q$N(B text $BHG$d(B HTML $BHG$r@8@.$9$k;~$K<+F0E*$KA^F~$5$l$^$9!#(B
937     </ja:l>
938     </ja:pair>
939     </t>
940     <section anchor="ipr" title="Conformance with RFC 2026" ja:title-ja="RFC 2026 $B$X$NE,9g@-(B">
941     <t>
942     <ja:pair>
943     <ja:l xml:lang="en">
944     If an Internet-Draft is being produced,
945     then the "ipr" attribute should be present in the "&lt;rfc&gt;"
946     tag at the beginning of the file.
947     The value of the attribute should be one of:
948     </ja:l>
949     <ja:l xml:lang="ja">
950     Internet-Draft $B$,@8@.$5$l$k>l9g$K!"(B "ipr" $BB0@-$,%U%!%$%k$N$O$8$a$N(B
951     "&lt;rfc&gt;"$B%?%0$K8=$l$k$Y$-$G$9!#$3$NB0@-$NCM$O<!$N$$$:$l$+$G$"$k$Y$-$G$9!#(B
952     </ja:l>
953     </ja:pair>
954    
955     <list style="hanging">
956     <t hangText="full2026:">
957     <ja:pair>
958     <ja:l xml:lang="en">
959     indicating that the document is in full conformance with all
960     the provisions of Section 10 of RFC 2026;
961     </ja:l>
962     <ja:l xml:lang="ja">
963     $BJ8=q$,(B <ja:link type="rfc" number="2026">RFC 2026</ja:link>
964     $B$N(B<ja:link type="rfc" number="2026" section="10">$BBh(B10$B>O(B</ja:link>
965     $B$NA4$F$NMW7o$K40A4$KE,9g$9$k$3$H$r<($7$^$9(B
966     </ja:l>
967     </ja:pair>
968     </t>
969     <t hangText="noDerivativeWorks2026:">
970     <ja:pair>
971     <ja:l xml:lang="en">
972     indicating that the document is in full
973     conformance with all the provisions of Section 10 of RFC 2026 except that the
974     right to produce derivative works is not granted; or,
975     </ja:l>
976     <ja:l xml:lang="ja">
977     $BJ8=q$,!"GI@8E*:n6H$N@8@.$,G'$a$i$l$F$$$J$$$3$H$r=|$$$F!"(B
978     <ja:link type="rfc" number="2026">RFC 2026</ja:link>
979     $B$N(B<ja:link type="rfc" number="2026" section="10">$BBh(B10$B>O(B</ja:link>
980     $B$NA4$F$NMW7o$K40A4$KE,9g$9$k$3$H$r<($7$^$9(B
981     </ja:l>
982     </ja:pair>
983     </t>
984     <t hangText="none:">
985     <ja:pair>
986     <ja:l xml:lang="en">
987     indicating that the document is NOT offered in accordance with
988     Section 10 of RFC 2026, and the author does not provide the IETF with any rights
989     other than to publish as an Internet-Draft.
990     </ja:l>
991     <ja:l xml:lang="ja">
992     $BJ8=q$,(B
993     <ja:link type="rfc" number="2026">RFC 2026</ja:link>
994     $B$N(B<ja:link type="rfc" number="2026" section="10">$BBh(B10$B>O(B</ja:link>
995     $B$K=>$C$F(B<h:strong>$B$*$i$:(B</h:strong>$B!"Cx<T$O(B IETF $B$K(B Internet-Draft
996     $B$H$7$FH/9T$9$k0J30$N$$$+$J$k8"Mx$r$bDs6!$7$J$$$3$H$r<($7$^$9(B
997     </ja:l>
998     </ja:pair>
999     </t>
1000     </list>
1001    
1002     <ja:pair>
1003     <ja:l xml:lang="en">
1004     In the latter case,
1005     a copyright notice will not be automatically inserted during
1006     processing by an XML application.
1007     </ja:l>
1008     <ja:l xml:lang="ja">
1009     $B8e<T$N>l9g$G$O!"Cx:n8"I=<($O(B XML $B1~MQ$K$h$j<+F0E*$K$OA^F~$5$l$^$;$s!#(B
1010     <ja:note>$B8e<T(B (the latter case) $B$H$O:G8e$N>l9g$N$_(B?
1011     rfc2629.xslt $B$G$O$I$N>l9g$G$bA^F~$5$l$k$h$&$G$9$,(B...</ja:note>
1012     </ja:l>
1013     </ja:pair>
1014     </t>
1015     <t>
1016     <ja:pair>
1017     <ja:l xml:lang="en">
1018     Consult <xref target="refs.RFC2026" /> for further details.
1019     </ja:l>
1020     <ja:l xml:lang="ja">
1021     $B>\$7$/$O(B <xref target="refs.RFC2026" /> $B$rD4$Y$F2<$5$$!#(B
1022     </ja:l>
1023     </ja:pair>
1024     </t>
1025     <figure>
1026     <preamble>
1027     <ja:pair>
1028     <ja:l xml:lang="en">
1029     Finally,
1030     if the Internet-Draft is being submitted to an automated process,
1031     then the "docName" attribute should be present in the "&lt;rfc&gt;"
1032     tag at the beginning of the file.
1033     The value of this attribute contains the document (not file) name
1034     associated with this Internet-Draft, e.g.,
1035     </ja:l>
1036     <ja:l xml:lang="ja">
1037     $B:G8e$K!"(B Internet-Draft $B$,<+F0=hM}$K2s$5$l$?;~$O!"(B "docName"
1038     $BB0@-$,%U%!%$%k$N$O$8$a$N(B "&lt;rfc&gt;" $B%?%0Cf$K=P8=$9$k$Y$-$G$9!#(B
1039     $B$3$NB0@-$NCM$O(B Internet-Draft $B$K$D$1$i$l$?J8=q(B ($B%U%!%$%k$G$J$7$K(B)
1040     $B$NL>A0$G!"<!$NMM$K$J$j$^$9!#(B
1041     </ja:l>
1042     </ja:pair>
1043     </preamble>
1044     <artwork><![CDATA[
1045     <rfc ipr="full" docName="draft-mrose-writing-rfcs-01">
1046     ...
1047     </rfc>
1048     ]]></artwork>
1049     <!-- $B"-86J8%^%^(B -->
1050     <postamble></postamble>
1051     </figure>
1052     </section>
1053     </section>
1054     <section title="Everything in the Front" ja:title-ja="Front $BA4BN(B">
1055     <figure>
1056     <preamble>
1057     <ja:pair>
1058     <ja:l xml:lang="en">
1059     So,
1060     putting it all together, we have, e.g.,
1061     </ja:l>
1062     <ja:l xml:lang="ja">
1063     $B0J>e$r$^$H$a$k$H<!$NMM$K$J$j$^$9!#(B
1064     </ja:l>
1065     </ja:pair>
1066     </preamble>
1067    
1068     <ja:pair>
1069     <ja:l xml:lang="en"><artwork><![CDATA[
1070     <front>
1071     <title>Writing I-Ds and RFCs using XML</title>
1072    
1073     <author initials="M.T." surname="Rose"
1074     fullname="Marshall T. Rose">
1075     <organization>Invisible Worlds, Inc.</organization>
1076    
1077     <address>
1078     <postal>
1079     <street>660 York Street</street>
1080     <street>M/S 40</street>
1081     <city>San Francisco</city> <region>CA</region>
1082     <code>94110</code>
1083     <country>US</country>
1084     </postal>
1085    
1086     <phone>+1 415 695 3975</phone>
1087     <email>mrose@not.invisible.net</email>
1088     <uri>http://invisible.net/</uri>
1089     </address>
1090     </author>
1091    
1092     <date month="February" year="1999" />
1093    
1094     <area>General</area>
1095     <workgroup>RFC Beautification Working Group</workgroup>
1096     <keyword>RFC</keyword>
1097     <keyword>Request for Comments</keyword>
1098     <keyword>I-D</keyword>
1099     <keyword>Internet-Draft</keyword>
1100     <keyword>XML</keyword>
1101     <keyword>Extensible Markup Language</keyword>
1102     <abstract>
1103     <t>This memo presents a technique for using XML
1104     (Extensible Markup Language) as a source format
1105     for documents in the Internet-Drafts (I-Ds) and
1106     Request for Comments (RFC) series.</t>
1107     </abstract>
1108     </front>
1109     ]]></artwork></ja:l>
1110     <ja:l xml:lang="ja"><artwork><![CDATA[
1111     <front>
1112     <title>XML $B$r;H$C$F(B I-D $B$d(B RFC $B$r=q$/(B</title>
1113    
1114     <author initials="M.T." surname="Rose"
1115     fullname="Marshall T. Rose">
1116     <organization>Invisible Worlds, Inc.</organization>
1117    
1118     <address>
1119     <postal>
1120     <street>660 York Street</street>
1121     <street>M/S 40</street>
1122     <city>San Francisco</city> <region>CA</region>
1123     <code>94110</code>
1124     <country>US</country>
1125     </postal>
1126    
1127     <phone>+1 415 695 3975</phone>
1128     <email>mrose@not.invisible.net</email>
1129     <uri>http://invisible.net/</uri>
1130     </address>
1131     </author>
1132    
1133     <date month="February" year="1999" />
1134    
1135     <area>General</area>
1136     <workgroup>RFC $BH~2=:n6HIt2q(B</workgroup>
1137     <keyword>RFC</keyword>
1138     <keyword>Request for Comments</keyword>
1139     <keyword>I-D</keyword>
1140     <keyword>Internet-Draft</keyword>
1141     <keyword>XML</keyword>
1142     <keyword>$B3HD%%^!<%/IU$18@8l(B</keyword>
1143     <abstract>
1144     <t>$B$3$N%a%b$O!"(B XML ($B3HD%%^!<%/IU$18@8l(B) $B$r(B
1145     Internet-Draft (I-D) $B$d(B Request for Comments (RFC)
1146     $B7ONs$NJ8=q$N867A<0$H$7$F;HMQ$9$k<jK!$r@bL@$7$^$9!#(B</t>
1147     </abstract>
1148     </front>
1149     ]]></artwork></ja:l>
1150     </ja:pair>
1151    
1152     </figure>
1153     </section>
1154     </section>
1155     <section title="The Middle">
1156     <figure>
1157     <preamble>
1158     <ja:pair>
1159     <ja:l xml:lang="en">
1160     The "middle" element contains all the sections of the document
1161     except for the bibliography and appendices:
1162     </ja:l>
1163     <ja:l xml:lang="ja">
1164     "middle" $BMWAG$O;29MJ88%$HImB0=q$r=|$/J8=q$NA4$F$N@a$+$i@.$j$^$9!#(B
1165     </ja:l>
1166     </ja:pair>
1167     </preamble>
1168     <artwork><![CDATA[
1169     ...
1170     </front>
1171     <middle>
1172     <section ...>
1173     <section ...>
1174     <section ...>
1175     </middle>
1176     <back>
1177     ...
1178     ]]></artwork>
1179     <postamble>
1180     <ja:pair>
1181     <ja:l xml:lang="en">
1182     The "middle" element consists of one or more "section"
1183     elements.
1184     </ja:l>
1185     <ja:l xml:lang="ja">
1186     "middle" $BMWAG$O(B1$B$D0J>e$N(B "section" $BMWAG$+$i@.$j$^$9!#(B
1187     </ja:l>
1188     </ja:pair>
1189     </postamble>
1190     </figure>
1191     <section anchor="section" title="The section Element" ja:title-ja="section $BMWAG(B">
1192     <figure>
1193     <preamble>
1194     <ja:pair>
1195     <ja:l xml:lang="en">
1196     Each "section" element contains a section of the document.
1197     There is a mandatory attribute,
1198     "title",
1199     that identifies the title of the section.
1200     There is also an optional attribute,
1201     "anchor",
1202     that is used for cross-referencing with
1203     <xref target="xref">the "xref" element</xref>,
1204     e.g.,
1205     </ja:l>
1206     <ja:l xml:lang="ja">
1207     $B3F(B "section" $BMWAG$OJ8=q$N@a$+$i@.$j$^$9!#I,?\$NB0@-(B "title"
1208     $B$O@a$NBj$rI=$7$^$9!#>JN,2DG=$NB0@-(B "anchor" $B$O(B
1209     <xref target="xref">"xref" $BMWAG(B</xref>$B$K$h$k8r:9;2>H$K;H$$$^$9!#(B
1210     $B<!$NNc$r8fMw2<$5$$!#(B
1211     </ja:l>
1212     </ja:pair>
1213     </preamble>
1214     <artwork><![CDATA[
1215     <section anchor="intro" title="Introduction">
1216     ...
1217     </section>
1218     ]]></artwork>
1219     </figure>
1220     <figure>
1221     <preamble>
1222     <ja:pair>
1223     <ja:l xml:lang="en">
1224     The "section" element is recursive $B!=!=(B
1225     each contains any number and combination of "t", "figure", and "section"
1226     elements, e.g.,
1227     </ja:l>
1228     <ja:l xml:lang="ja">
1229     "section" $BMWAG$O:F5"E*$G!"3F!9G$0U$N?t!&AH9g$;$G(B "t",
1230     "figure", "section" $B3FMWAG$r<!$NNc$NG!$/;H$$$^$9!#(B
1231     </ja:l>
1232     </ja:pair>
1233     </preamble>
1234     <artwork><![CDATA[
1235     <section title="The Middle">
1236     ...
1237     <section title="The section Element">
1238     ...
1239     <section title="The t Element">...</section>
1240     <section title="The list Element">...</section>
1241     <section title="The figure Element">...</section>
1242     <section title="The xref Element">...</section>
1243     <section title="The eref Element">...</section>
1244     <section title="The iref Element">...</section>
1245     </section>
1246     </section>
1247     ]]></artwork>
1248     </figure>
1249     <section anchor="t" title="The t Element" ja:title-ja="t $BMWAG(B">
1250     <t>
1251     <ja:pair>
1252     <ja:l xml:lang="en">
1253     The "t" element contains any number and combination of
1254     paragraphs, lists, and figures.
1255     If a cross-reference is needed to a section, figure, or reference,
1256     <xref target="xref">the "xref" element</xref> is used;
1257     similarly,
1258     if an external-reference is needed,
1259     <xref target="eref">the "eref" element</xref> is used.
1260     Indexing of text is provided by the
1261     <xref target="iref">the "iref" element</xref>.
1262     </ja:l>
1263     <ja:l xml:lang="ja">
1264     "t" $BMWAG$OG$0U$N?t!&AH9g$;$NCJMn!&0lMw!&?^$+$i@.$j$^$9!#@a!&?^!&;29MJ88%$X$N8r:9;2>H$,I,MW$J$i!"(B <xref target="xref">"xref" $BMWAG(B</xref>
1265     $B$r;H$$$^$9!#F1MM$K30It;2>H$,I,MW$J$i!"(B <xref target="eref">"eref"
1266     $BMWAG(B</xref>$B$r;H$$$^$9!#J8>O$N:w0zIU$1$K$O(B <xref target="iref">"iref"
1267     $BMWAG(B</xref>$B$r;H$$$^$9!#(B
1268     </ja:l>
1269     </ja:pair>
1270     </t>
1271     </section>
1272     <section title="The list Element" ja:title-ja="list $BMWAG(B">
1273     <figure>
1274     <preamble>
1275     <ja:pair>
1276     <ja:l xml:lang="en">
1277     The "list" element contains one or more items.
1278     Each item is a "t" element,
1279     allowing for recursion, e.g.,
1280     </ja:l>
1281     <ja:l xml:lang="ja">
1282     "list" $BMWAG$O(B1$B$D0J>e$N9`L\$+$i@.$j$^$9!#3F9`L\$O(B
1283     "t" $BMWAG$G!"7+$jJV$72DG=$G$9!#Nc$r8fMw$"$l(B:
1284     </ja:l>
1285     </ja:pair>
1286     </preamble>
1287    
1288     <ja:pair>
1289     <ja:l xml:lang="en">
1290     <artwork><![CDATA[
1291     <list style="numbers">
1292     <t>The first item.</t>
1293     <t>The second item, which contains two bulleted sub-items:
1294     <list style="symbols">
1295     <t>The first sub-item.</t>
1296     <t>The second sub-item.</t>
1297     </list>
1298     </t>
1299     </list>
1300     ]]></artwork>
1301     </ja:l>
1302     <ja:l xml:lang="ja">
1303     <artwork><![CDATA[
1304     <list style="numbers">
1305     <t>$B:G=i$N9`L\!#(B</t>
1306     <t>2$B$D$N>.9`L\$,$"$kFsHVL\$N9`L\(B
1307     <list style="symbols">
1308     <t>$B:G=i$N>.9`L\(B</t>
1309     <t>$BFsHVL\$N>.9`L\(B</t>
1310     </list>
1311     </t>
1312     </list>
1313     ]]></artwork>
1314     </ja:l>
1315     </ja:pair>
1316    
1317     <postamble>
1318     <ja:pair>
1319     <ja:l xml:lang="en">
1320     The "list" element has an optional attribute,
1321     "style",
1322     having the value "numbers" (for numeric lists),
1323     "symbols" (for bulleted lists),
1324     "hanging" (for hanging lists),
1325     or,
1326     "empty" (for indented text).
1327     If a "list" element is nested,
1328     the default value is taken from its closest parent;
1329     otherwise,
1330     the default value is "empty".
1331    
1332     </ja:l>
1333     <ja:l xml:lang="ja">
1334     "list" $BMWAG$O>JN,2DG=$J(B "style" $BB0@-$,$"$C$F!"(B "numbers"
1335     ($BHV9f$D$-0lMw(B), "symbols" ($B5-9f$D$-0lMw(B), "hanging" ($B$V$i2<$,$j0lMw(B),
1336     "empty" ($B;z2<$2J8(B) $B$N$$$:$l$+$NCM$r<h$k$3$H$,=PMh$^$9!#(B
1337     "list" $BMWAG$,F~$l;R$K$J$C$F$$$k;~!"4{DjCM$O0lHV6a$$?F$+$i<h$i$l$^$9!#$=$&$G$J$$;~$O!"4{DjCM$O(B "empty" $B$G$9!#(B
1338     </ja:l>
1339     </ja:pair>
1340     </postamble>
1341     </figure>
1342     <figure>
1343     <preamble>
1344     <ja:pair>
1345     <ja:l xml:lang="en">
1346     When nested within a "hanging list" element,
1347     the "t" element has an optional attribute,
1348     "hangText" that specifies the text to be inserted, e.g.,
1349     </ja:l>
1350     <ja:l xml:lang="ja">
1351     $B!V$V$i2<$,$j0lMw!W(B $BMWAGCf$GF~$l;R$K$J$C$F$$$k;~!"(B
1352     "t" $BMWAG$O>JN,2DG=$JB0@-(B "hangText" $B$r;}$A!"A^F~$5$l$kJ8;zNs$r;XDj$7$^$9!#<!$NNc$r;2>H$7$F2<$5$$!#(B
1353     </ja:l>
1354     </ja:pair>
1355     </preamble>
1356    
1357     <ja:pair>
1358     <ja:l xml:lang="en">
1359     <artwork><![CDATA[
1360     <list style="hanging">
1361     <t hangText="full2026:">indicating that the document is in
1362     full conformance with all the provisions of Section 10 of
1363     RFC 2026;</t>
1364    
1365     <t hangText="noDerivativeWorks2026:">indicating that the
1366     document is in full conformance with all the provisions of
1367     Section 10 of RFC 2026 except that the right to produce
1368     derivative works is not granted; or,</t>
1369    
1370     <t hangText="none:">indicating that the document is NOT
1371     offered in accordance with Section 10 of RFC 2026, and
1372     the author does not provide the IETF with any rights other
1373     than to publish as an Internet-Draft.</t>
1374     </list>
1375     ]]></artwork>
1376     </ja:l>
1377     <ja:l xml:lang="ja">
1378     <artwork><![CDATA[
1379     <list style="hanging">
1380     <t hangText="full2026:">$BJ8=q$,(B RFC 2026
1381     $B$NBh(B10$B>O$NA4$F$NMW7o$K40A4$KE,9g$9$k$3$H$r<($7$^$9(B</t>
1382    
1383     <t hangText="noDerivativeWorks2026:">
1384     $BJ8=q$,!"GI@8E*:n6H$N@8@.$,G'$a$i$l$F$$$J$$$3$H$r=|$$$F!"(B
1385     RFC 2026 $B$NBh(B10$B>O$NA4$F$NMW7o$K40A4$KE,9g$9$k$3$H$r(B
1386     $B<($7$^$9(B</t>
1387    
1388     <t hangText="none:">$BJ8=q$,(B RFC 2026 $B$NBh(B10$B>O$K=>$C$F(B
1389     *$B$*$i$:(B*$B!"Cx<T$O(B IETF $B$K(B Internet-Draft
1390     $B$H$7$FH/9T$9$k0J30$N$$$+$J$k8"Mx$r$bDs6!$7$J$$$3$H$r(B
1391     $B<($7$^$9(B</t>
1392     </list>
1393     ]]></artwork>
1394     </ja:l>
1395     </ja:pair>
1396    
1397     </figure>
1398     </section>
1399     <section anchor="figure" title="The figure Element" ja:title-ja="figure $BMWAG(B">
1400     <t>
1401     <ja:pair>
1402     <ja:l xml:lang="en">
1403     The "figure" element groups an optional "preamble" element,
1404     an "artwork" element,
1405     and an optional "postamble" element together.
1406     The "figure" element also has an optional "anchor" attribute that is
1407     used for cross-referencing with
1408     <xref target="xref">the "xref" element</xref>.
1409     There is also an optional "title" attribute that identifies the title
1410     of the figure.
1411    
1412     </ja:l>
1413     <ja:l xml:lang="ja">
1414     "figure" $BMWAG$O>JN,2DG=$J(B "preamble" $BMWAG(B,
1415     "artwork" $BMWAG(B, $B>JN,2DG=$J(B "postable" $BMWAG$r$R$H$^$H$a$K$7$^$9!#(B
1416     "figure" $BMWAG$O>JN,2DG=$J(B "anchor" $BB0@-$b;}$C$F$$$F!"(B
1417     <xref target="xref">"xref" $BMWAG(B</xref>$B$K$h$k8r:9;2>H$K;H$&$3$H$,=PMh$^$9!#(B
1418     $B>JN,2DG=$J(B "title" $BB0@-$H$$$&$N$b$"$C$F!"?^$NBj$r<($7$^$9!#(B
1419     </ja:l>
1420     </ja:pair>
1421     </t>
1422     <t>
1423     <ja:pair>
1424     <ja:l xml:lang="en">
1425     The "preamble" and "postamble" elements,
1426     if present,
1427     are simply text.
1428     If a cross-reference is needed to a section, figure, or reference,
1429     <xref target="xref">the "xref" element</xref> is used;
1430     similarly,
1431     if an external-reference is needed,
1432     <xref target="eref">the "eref" element</xref> is used.
1433     Indexing of text is provided by the
1434     <xref target="iref">the "iref" element</xref>.
1435     </ja:l>
1436     <ja:l xml:lang="ja">
1437     "preamble" $B!&(B "postamble" $BN>MWAG$O!"B8:_$9$k>l9g!"C1=c$JJ8;zNs$G$9!#(B
1438     $B@a!&?^!&;29MJ88%$X$N8r:9;2>H$,I,MW$J>l9g$O!"(B
1439     <xref target="xref">"xref"
1440     $BMWAG(B</xref>$B$r;H$$$^$9!#F1MM$K!"30It;2>H$,I,MW$J$i!"(B
1441     <xref target="eref">"eref" $BMWAG(B</xref>$B$r;H$$$^$9!#J8>O$N:w0zIU$1$K$O(B
1442     <xref target="iref">"iref" $BMWAG(B</xref>$B$r;H$$$^$9!#(B
1443     </ja:l>
1444     </ja:pair>
1445     </t>
1446     <t>
1447     <ja:pair>
1448     <ja:l xml:lang="en">
1449     The "artwork" element,
1450     which must be present,
1451     contains "ASCII artwork".
1452     Unlike text contained in the "t", "preamble", or "postamble" elements,
1453     both horizontal and vertical whitespace is significant in the "artwork"
1454     element.
1455     </ja:l>
1456     <ja:l xml:lang="ja">
1457     "artwork" $BMWAG$O!"I,$:B8:_$7$J$1$l$P$J$i$:!"!V(BASCII $B3(!W$+$i@.$j$^$9!#(B
1458     "t", "preamble", "postamble" $B3FMWAGCf$NJ8;zNs$H$O0c$C$F!"?eJ?!&?bD>$I$A$i$N6uGr4V3V$b(B
1459     "artwork" $BMWAGCf$G$O0UL#$r;}$A$^$9!#(B
1460     </ja:l>
1461     </ja:pair>
1462     </t>
1463     <figure>
1464     <preamble>
1465     <ja:pair>
1466     <ja:l xml:lang="en">
1467     So,
1468     putting it all together, we have, e.g.,
1469     </ja:l>
1470     <ja:l xml:lang="ja">
1471     $B$H$$$&$3$H$G!"A4$F$^$H$a$k$H!"<!$NNc$NMM$K$J$j$^$9!#(B
1472     </ja:l>
1473     </ja:pair>
1474     </preamble>
1475    
1476     <ja:pair>
1477     <ja:l xml:lang="en">
1478     <artwork><![CDATA[
1479     <figure anchor="figure_example">
1480     <preamble>So,
1481     putting it all together, we have, e.g.,</preamble>
1482     <artwork>
1483     ascii artwork goes here...
1484    
1485     be sure to use "&lt;" or "&amp;" instead of "<" and "&",
1486     respectively!
1487     </artwork>
1488     <postamble>which is a very simple example.</postamble>
1489     </figure>
1490     ]]></artwork>
1491     </ja:l>
1492     <ja:l xml:lang="ja">
1493     <artwork><![CDATA[
1494     <figure anchor="figure_example">
1495     <preamble>$B$H$$$&$3$H$G!"A4$F$^$H$a$k$H!"(B
1496     $B<!$NNc$NMM$K$J$j$^$9!#(B</preamble>
1497     <artwork>
1498     ascii $B3($,$3$3$KF~$j$^$9(B...
1499    
1500     "&lt;" $B$H$+(B "&amp;" $B$r$=$l$>$l(B "<" $B$H(B "&"
1501     $B$NBe$o$j$K;H$&$s$@$h(B!
1502     </artwork>
1503     <postamble>$BHs>o$KC1=c$JNc$G$7$?!#(B</postamble>
1504     </figure>
1505     ]]></artwork>
1506     </ja:l>
1507     </ja:pair>
1508    
1509     <postamble>
1510     <ja:pair>
1511     <ja:l xml:lang="en">
1512     which is a very simple example.
1513     </ja:l>
1514     <ja:l xml:lang="ja">
1515     $BHs>o$KC1=c$JNc$G$7$?!#(B
1516     </ja:l>
1517     </ja:pair>
1518     </postamble>
1519     </figure>
1520     <figure>
1521     <preamble>
1522     <ja:pair>
1523     <ja:l xml:lang="en">
1524     If you have artwork with a lot of "&lt;" characters,
1525     then there's an XML trick you can use:
1526     </ja:l>
1527     <ja:l xml:lang="ja">
1528     $BBt;3$N(B "&lt;" $BJ8;z$,3($NCf$K$"$k>l9g$O!"$3$N$h$&$J(B
1529     XML $BKbK!$r;H$&$3$H$,=PMh$^$9!#(B
1530     </ja:l>
1531     </ja:pair>
1532     </preamble>
1533    
1534     <ja:pair>
1535     <ja:l xml:lang="en">
1536     <artwork>
1537     &lt;figure>
1538     &lt;preamble>If you have artwork with a lot of "&amp;lt;"
1539     characters, then there's an XML trick you can
1540     use:&lt;/preamble>
1541     &lt;artwork>&lt;![CDATA[
1542     ascii artwork goes here...
1543    
1544     just don't use "]]" in your artwork!
1545     ]]&gt;&lt;/artwork>
1546     &lt;postamble>The "&amp;lt;![CDATA[ ... ]]&gt;" construct is called
1547     a CDATA block -- everything between the innermost brackets
1548     is left alone by the XML application.&lt;/postamble>
1549     &lt;/figure>
1550     </artwork>
1551     </ja:l>
1552     <ja:l xml:lang="ja">
1553     <artwork>
1554     &lt;figure>
1555     &lt;preamble>$BBt;3$N(B "&amp;lt;" $BJ8;z$,3($NCf$K$"$k>l9g$O!"(B
1556     $B$3$N$h$&$J(B XML $BKbK!$r;H$&$3$H$,=PMh$^$9!#(B&lt;/preamble>
1557     &lt;artwork>&lt;![CDATA[
1558     ascii $B$,$3$3$KMh$^$9(B...
1559    
1560     $BC1$K(B "]]" $B$r3($NCf$G;H$o$J$$$@$1$G$9(B!
1561     ]]&gt;&lt;/artwork>
1562     &lt;postamble>"&amp;lt;![CDATA[ ... ]]&gt;" $B9=B$$O(B CDATA
1563     $B2t$H8F$P$l$^$9!#0lHVFbB&$N3g8L$N4V$N$b$N$OA4$F(B XML
1564     $B1~MQ$K43>D$5$l$^$;$s!#(B&lt;/postamble>
1565     &lt;/figure>
1566     </artwork>
1567     </ja:l>
1568     </ja:pair>
1569    
1570     <postamble>
1571     <ja:pair>
1572     <ja:l xml:lang="en">
1573     The "&lt;![CDATA[ ... ]]&gt;" construct is called a CDATA
1574     block $B!=!=(B everything between the innermost brackets is left alone by
1575     the XML application.
1576     </ja:l>
1577     <ja:l xml:lang="ja">
1578     <h:samp>&lt;![CDATA[ ... ]]&gt;</h:samp> $B9=B$$O(B CDATA
1579     $B2t$H8F$P$l$^$9!#0lHVFbB&$N3g8L$N4V$N$b$N$OA4$F(B XML $B1~MQ$K43>D$5$l$^$;$s!#(B
1580     </ja:l>
1581     </ja:pair>
1582     </postamble>
1583     </figure>
1584     <t>
1585     <ja:pair>
1586     <ja:l xml:lang="en">
1587     Because the "figure" element represents a logical grouping of text
1588     and artwork,
1589     an XML application producing a text version of the document should
1590     attempt to keep these elements on the same page.
1591     Because <xref target="refs.RFC2223">RFC 2223</xref> allows no more than 69
1592     characters by 49 lines of content on each page,
1593     XML applications should be prepared to prematurely introduce page
1594     breaks to allow for better visual grouping.
1595     </ja:l>
1596     <ja:l xml:lang="ja">
1597     "figure" $BMWAG$OJ8=q$H3($NO@M}E*$J=89g$rI=8=$9$k$N$G!"J8=q$N(B
1598     text $BHG$r@8@.$9$k(B XML $B1~MQ$O3FMWAG$rF10lJGCf$KF~$l$k$h$&$K:v$9$k$Y$-$G$9!#(B
1599     <xref target="refs.RFC2223">RFC 2223</xref>
1600     $B$,3FJG(B49$B9T$NFbMF$G(B, 69$BJ8;z$rD6$($k$N$rG'$a$F$$$J$$$N$G!"(B
1601     XML $B1~MQ$O$h$jNI$$;k3PE*=89g2=$r9T$&$?$a$KM=$a2~JG$9$k=`Hw$r$7$F$*$/$Y$-$G$9!#(B
1602     </ja:l>
1603     </ja:pair>
1604     </t>
1605     <t>
1606     <ja:pair>
1607     <ja:l xml:lang="en">
1608     Finally,
1609     the "artwork" element has two optional attributes:
1610     "name" and "type".
1611     The former is used to suggest a filename to use when storing the
1612     content of the "artwork" element,
1613     whilst the latter contains a suggestive data-typing for the content.
1614     </ja:l>
1615     <ja:l xml:lang="ja">
1616     $B:G8e$K!"(B "artwork" $BMWAG$O(B2$B$D$N>JN,2DG=$JB0@-(B "name", "type"
1617     $B$r;}$A$^$9!#A0<T$O(B "artwork" $BMWAG$NFbMF$rJ]4I$9$k;~$K;H$&%U%!%$%kL>$N0F$r?d$9$N$K;H$$$^$9!#8e<T$OFbMF$N%G!<%?7?$r<($9$N$K;H$$$^$9!#(B
1618     </ja:l>
1619     </ja:pair>
1620     </t>
1621     </section>
1622     <section anchor="xref" title="The xref Element" ja:title-ja="xref $BMWAG(B">
1623     <t>
1624     <ja:pair>
1625     <ja:l xml:lang="en">
1626     The "xref" element is used to cross-reference sections, figures, and
1627     references.
1628     The mandatory "target" attribute is used to link back to the "anchor"
1629     attribute of the "section", "figure", and "reference" elements.
1630     The value of the "anchor" and "target" attributes should be formatted
1631     according to the token syntax in <xref target="xml_basics" />.
1632     </ja:l>
1633     <ja:l xml:lang="ja">
1634     "xref" $BMWAG$O@a!&?^!&;29MJ88%$N8r:9;2>H$K;H$$$^$9!#I,?\$N(B
1635     "target" $BB0@-$O(B "section", "figure", "reference" $BMWAG$N(B
1636     "anchor" $BB0@-$K5U@\B3$9$k$N$K;H$$$^$9!#(B
1637     "anchor" $B$*$h$S(B "target" $BN>B0@-$NCM$O(B <xref target="xml_basics" />
1638     $B$N;z6g(B (token) $B9=J8$K=>$$=q<02=$5$l$k$Y$-$G$9!#(B
1639     </ja:l>
1640     </ja:pair>
1641     </t>
1642     <figure>
1643     <preamble>
1644     <ja:pair>
1645     <ja:l xml:lang="en">
1646     If used as an empty element,
1647     e.g.,
1648     </ja:l>
1649     <ja:l xml:lang="ja">
1650     $B6uMWAG$H$7$F;H$&;~$O(B
1651     </ja:l>
1652     </ja:pair>
1653     </preamble>
1654    
1655     <ja:pair>
1656     <ja:l xml:lang="en">
1657     <artwork><![CDATA[
1658     according to the token syntax in <xref target="xml_basics" />.
1659     ]]></artwork>
1660     </ja:l>
1661     <ja:l xml:lang="ja">
1662     <artwork><![CDATA[
1663     <xref target="xml_basics" /> $B$N;z6g(B (token) $B9=J8$K=>$$(B
1664     ]]></artwork>
1665     </ja:l>
1666     </ja:pair>
1667    
1668     <postamble>
1669     <ja:pair>
1670     <ja:l xml:lang="en">
1671     then the XML application inserts an appropriate phrase
1672     during processing,
1673     such as "Section 2.1" or
1674     <![CDATA["<a href="#xml_basics">XML Basics</a>"]]>.
1675     </ja:l>
1676     <ja:l xml:lang="ja">
1677     $B$NMM$K$J$j!"(B XML $B1~MQ$O(B <h:samp>2.1 $B@a(B</h:samp> $B$d(B
1678     <h:samp><![CDATA[<a href="#xml_basics">XML $B$N4pAC(B</a>]]></h:samp>
1679     $B$N$h$&$KE,@Z$JJ8;zNs$r=hM}$K$h$jA^F~$7$^$9!#(B
1680     </ja:l>
1681     </ja:pair>
1682     </postamble>
1683     </figure>
1684     <figure>
1685     <preamble>
1686     <ja:pair>
1687     <ja:l xml:lang="en">
1688     If used with content, e.g.,
1689     </ja:l>
1690     <ja:l xml:lang="ja">
1691     $BFbMF$"$j$G;H$&;~$O(B
1692     </ja:l>
1693     </ja:pair>
1694     </preamble>
1695    
1696     <ja:pair>
1697     <ja:l xml:lang="en">
1698     <artwork><![CDATA[
1699     conforming to <xref target="refs.RFC2223">RFC 2223</xref>.
1700     ]]></artwork>
1701     </ja:l>
1702     <ja:l xml:lang="ja">
1703     <artwork><![CDATA[
1704     <xref target="refs.RFC2223">RFC 2223</xref> $B$KE,9g$9$k(B
1705     ]]></artwork>
1706     </ja:l>
1707     </ja:pair>
1708    
1709     <postamble>
1710     <ja:pair>
1711     <ja:l xml:lang="en">
1712     then the XML application inserts an appropriate
1713     designation during processing,
1714     such as "RFC 2223[2]" or
1715     <![CDATA["<a href="#refs.RFC2223">RFC 2223</a>"]]>.
1716     Although the XML application decides what "an appropriate designation"
1717     might be,
1718     its choice is consistent throughout the processing of the document.
1719     </ja:l>
1720     <ja:l xml:lang="ja">
1721     $B$NMM$K$J$j!"(B XML $B1~MQ$O(B <h:samp>RFC 2223[2]</h:samp> $B$d(B
1722     <h:samp><![CDATA[<a href="#refs.RFC2223">RFC 2223</a>]]></h:samp>
1723     $B$N$h$&$KE,@Z$J;X<($r=hM}$K$h$jA^F~$7$^$9!#!VE,@Z$J;X<(!W$NFbMF$O(B
1724     XML $B1~MQ$,7h$a$^$9$,!"A*Br$OEv3:J8=q$N=hM}$rDL$8$F8GDj$G$9!#(B
1725     </ja:l>
1726     </ja:pair>
1727     </postamble>
1728     </figure>
1729     </section>
1730    
1731     <section anchor="eref" title="The eref Element" ja:title-ja="eref $BMWAG(B">
1732     <figure>
1733     <preamble>
1734     <ja:pair>
1735     <ja:l xml:lang="en">
1736     The "eref" element is used to reference external documents.
1737     The mandatory "target" attribute is a
1738     <xref target="URI">URI</xref>, e.g.,
1739     </ja:l>
1740     <ja:l xml:lang="ja">
1741     "eref" $BMWAG$O!"30ItJ8=q$r;2>H$9$k$N$K;H$$$^$9!#I,?\$N(B
1742     "target" $BB0@-$O(B <xref target="URI">URI</xref>
1743     $B$G!"<!$NMM$K;H$$$^$9!#(B
1744     </ja:l>
1745     </ja:pair>
1746     </preamble>
1747     <artwork><![CDATA[
1748     <eref target="http://metalab.unc.edu/xml/">Cafe con Leche</eref>
1749     ]]></artwork>
1750     </figure>
1751     <figure>
1752     <preamble>
1753     <ja:pair>
1754     <ja:l xml:lang="en">
1755     Note that while the "target" attribute is always present,
1756     the "eref" element may be empty, e.g.,
1757     </ja:l>
1758     <ja:l xml:lang="ja">
1759     "target" $BB0@-$O>o$KI,MW$G$"$j!"(B "eref" $BMWAG$O6u$G$"$jF@$k$3$H$KCm0U$7$F2<$5$$!#(B
1760     </ja:l>
1761     </ja:pair>
1762     </preamble>
1763     <artwork><![CDATA[
1764     <eref target="http://invisible.net/" />
1765     ]]></artwork>
1766     <postamble>
1767     <ja:pair>
1768     <ja:l xml:lang="en">
1769     and the XML application inserts an appropriate designation during
1770     processing such as "[9]" or
1771     <![CDATA["<a href="http://invisible.net/">http://invisible.net/</a>"]]>.
1772     </ja:l>
1773     <ja:l xml:lang="ja">
1774     XML $B1~MQ$O(B <h:samp>[9]</h:samp> $B$d(B
1775     <h:samp><![CDATA[<a href="http://invisible.net/">http://invisible.net/</a>]]></h:samp>
1776     $B$NMM$KE,@Z$J;X<($r=hM}$N2aDx$GA^F~$7$^$9!#(B
1777     </ja:l>
1778     </ja:pair>
1779     </postamble>
1780     </figure>
1781     </section>
1782     <section anchor="iref" title="The iref Element" ja:title-ja="iref $BMWAG(B">
1783     <figure>
1784     <preamble>
1785     <ja:pair>
1786     <ja:l xml:lang="en">
1787     <iref item="indexing" subitem="how to" />The "iref" element
1788     is used to add information to an index.
1789     The mandatory "item" attribute is the primary key the information is stored
1790     under,
1791     whilst the optional "subitem" attribute is the secondary key, e.g.,
1792     </ja:l>
1793     <ja:l xml:lang="ja">
1794     <iref item="$B:w0zIU$1(B" subitem="$BJ}K!(B" />"iref"
1795     $BMWAG$O:w0z$K>pJs$rDI2C$9$k$N$K;H$$$^$9!#I,?\$NB0@-(B "item"
1796     $B$O>pJs$,J]4I$5$l$k<g80$G!">JN,2DG=$J(B "subitem" $BB0@-$OI{80$G$9!#(B
1797     </ja:l>
1798     </ja:pair>
1799     </preamble>
1800    
1801     <ja:pair>
1802     <ja:l xml:lang="en">
1803     <artwork><![CDATA[
1804     <iref item="indexing" subitem="how to" />
1805     ]]></artwork>
1806     </ja:l>
1807     <ja:l xml:lang="ja">
1808     <artwork><![CDATA[
1809     <iref item="$B:w0zIU$1(B" subitem="$BJ}K!(B" />
1810     ]]></artwork>
1811     </ja:l>
1812     </ja:pair>
1813    
1814     </figure>
1815     <t>
1816     <ja:pair>
1817     <ja:l xml:lang="en">
1818     Finally, note that the "iref" element is always empty $B!=!=(B it never
1819     contains any text.
1820     </ja:l>
1821     <ja:l xml:lang="ja">
1822     $B:G8e$K!"(B "iref"
1823     $BMWAG$O>o$K6u$G$"$k!=!=$I$s$JJ8;zNs$b4^$^$J$$$H$$$&$3$H$KCm0U$7$F2<$5$$!#(B
1824     </ja:l>
1825     </ja:pair>
1826     </t>
1827     </section>
1828     <section title="The vspace Element" ja:title-ja="vspace $BMWAG(B">
1829     <t>
1830     <ja:pair>
1831     <ja:l xml:lang="en">
1832     The "vspace" element,
1833     which may occur only inside the "t" element,
1834     is used by the author to provide formatting guidance to the XML
1835     application.
1836     There is an attribute,
1837     "blankLines",
1838     that indicates the number of blank lines that should be inserted.
1839     A physical linebreak is specified by using the default value, "0".
1840     </ja:l>
1841     <ja:l xml:lang="ja">
1842     "vspace" $BMWAG$O!"(B "t" $BMWAG$NCf$K$N$_8=$l$k$3$H$,=PMh$F!"Cx<T$,(B
1843     XML $B1~MQ$K@07A$N<j0z$-$rM?$($k$N$K;H$$$^$9!#(B "blankLines"
1844     $BB0@-$,$"$j!"A^F~$5$l$k$Y$-6uGr9T$N?t$r<($7$^$9!#J*M}2~9T$O4{DjCM$G$"$k(B
1845     "0" $B$r;H$C$FI=$7$^$9!#(B
1846     </ja:l>
1847     </ja:pair>
1848     </t>
1849     <figure>
1850     <preamble>
1851     <ja:pair>
1852     <ja:l xml:lang="en">
1853     In addition,
1854     the "vspace" element can be used to force a new physical paragraph
1855     within a list item, e.g.,
1856     </ja:l>
1857     <ja:l xml:lang="ja">
1858     $B2C$($F!"(B "vspace" $BMWAG$O<!$KNc<($9$k$h$&$K!"?7$7$$7A<0CJMn$r0lMw9`L\Cf$K:n$j=P$9$N$K;H$&$3$H$,=PMh$^$9!#(B
1859     </ja:l>
1860     </ja:pair>
1861     </preamble>
1862    
1863     <ja:pair>
1864     <ja:l xml:lang="en">
1865     <artwork><![CDATA[
1866     <list style="numbers">
1867     <t>This is list item.
1868     <vspace blankLines="1" />
1869     This is part of the same list item,
1870     although when displayed, it appears
1871     as a separate physical paragraph.</t>
1872     </list>
1873     ]]></artwork>
1874     </ja:l>
1875     <ja:l xml:lang="ja">
1876     <artwork><![CDATA[
1877     <list style="numbers">
1878     <t>$B$3$l$O0lMw$N9`L\$G$9!#(B
1879     <vspace blankLines="1" />
1880     $B$3$l$OF1$80lMw9`L\$G$9!#(B
1881     $B$7$+$7I=<($N:]$K$OJL$N7A<0CJMn$K8+$($^$9!#(B</t>
1882     </list>
1883     ]]></artwork>
1884     </ja:l>
1885     </ja:pair>
1886    
1887     </figure>
1888     <t>
1889     <ja:pair>
1890     <ja:l xml:lang="en">
1891     An XML application producing a text version of the document should
1892     exercise care when encountering a value for "blankLines" that causes a
1893     pagebreak $B!=!=(B
1894     in particular,
1895     if a "vspace" element causes a pagebreak,
1896     then no further blank lines should be inserted.
1897     This allows authors to "force" a pagebreak by using an arbitrarily
1898     large value, e.g., "blankLines='100'".
1899     </ja:l>
1900     <ja:l xml:lang="ja">
1901     $BJ8=q$N(B text $BHG$r@8@.$9$k(B XML $B1~MQ$O!"2~JG$r5/$3$9$h$&$J(B
1902     "breakLines" $B$NCM$G$"$C$?;~$KCm0U$9$k$Y$-$G$9!#(B
1903     "vspace" $BMWAG$,2~JG$r5/$3$9;~$O!"$=$l0J>e6uGr9T$rA^F~$9$k$Y$-$G$O$"$j$^$;$s!#$3$l$K$h$j!"Cx<T$OG$0U$NBg$-$JCM!"Nc$($P(B
1904     <h:samp>blankLines='100'</h:samp> $B$G!V6/@)!W2~JG$5$;$k$3$H$,=PMh$^$9!#(B
1905     </ja:l>
1906     </ja:pair>
1907     </t>
1908     <t>
1909     <ja:pair>
1910     <ja:l xml:lang="en">
1911     Finally, note that the "vspace" element is always empty $B!=!=(B it never
1912     contains any text.
1913     </ja:l>
1914     <ja:l xml:lang="ja">
1915     $B:G8e$K!"(B "vspace" $BMWAG$O>o$K6u$G$"$k!=!=J8;zNs$r4^$^$J$$$H$$$&$3$H$KCm0U$7$F2<$5$$!#(B
1916     </ja:l>
1917     </ja:pair>
1918     </t>
1919     </section>
1920     </section>
1921     </section>
1922     <section anchor="back_matter" title="Back matter">
1923     <figure>
1924     <preamble>
1925     <ja:pair>
1926     <ja:l xml:lang="en">
1927     Finally,
1928     the "back" element is used for references and
1929     appendices:
1930     </ja:l>
1931     <ja:l xml:lang="ja">
1932     $B:G8e$K!"(B "back" $BMWAG$O;29MJ88%$HImB0=q$K;H$$$^$9!#(B
1933     </ja:l>
1934     </ja:pair>
1935     </preamble>
1936     <artwork><![CDATA[
1937     ...
1938     </middle>
1939     <back>
1940     <references>
1941     <reference ...>
1942     <reference ...>
1943     </references>
1944     <section ...>
1945     <section ...>
1946     </back>
1947     </rfc>
1948     ]]></artwork>
1949     <postamble>
1950     <ja:pair>
1951     <ja:l xml:lang="en">
1952     The "back" element consists of an optional "references" element,
1953     and,
1954     one or more optional "section" elements.
1955     The "back" element itself is optional,
1956     if your document doesn't have any references or appendices,
1957     you don't have to include it.
1958     </ja:l>
1959     <ja:l xml:lang="ja">
1960     "back" $BMWAG$O>JN,2DG=$J(B "references" $BMWAG$H!"(B1$B$D0J>e$N>JN,2DG=$J(B
1961     "section" $BMWAG$+$i@.$j$^$9!#(B "back" $BMWAG<+BN$O>JN,2DG=$G!"J8=q$K;29MJ88%$bImB0=q$b$J$$>l9g$O!"4^$a$kI,MW$O$"$j$^$;$s!#(B
1962     </ja:l>
1963     </ja:pair>
1964     </postamble>
1965     </figure>
1966     <section anchor="references" title="The references Element" ja:title-ja="references $BMWAG(B">
1967     <t>
1968     <ja:pair>
1969     <ja:l xml:lang="en">
1970     The "references" element contains the document's bibliography.
1971     It contains one or more "reference" elements.
1972     </ja:l>
1973     <ja:l xml:lang="ja">
1974     "references" $BMWAG$OJ8=q$N;29MJ88%$+$i@.$j$^$9!#(B1$B$D0J>e$N(B
1975     "reference" $BMWAG$+$i@.$j$^$9!#(B
1976     </ja:l>
1977     </ja:pair>
1978     </t>
1979     <t>
1980     <ja:pair>
1981     <ja:l xml:lang="en">
1982     Each "reference" element contains a "front" element and one or more
1983     optional "seriesInfo" elements.
1984     </ja:l>
1985     <ja:l xml:lang="ja">
1986     $B3F(B "references" $BMWAG$O(B "front" $BMWAG$H(B1$B$D0J>e$N>JN,2DG=$J(B
1987     "seriesInfo" $BMWAG$+$i@.$j$^$9!#(B
1988     </ja:l>
1989     </ja:pair>
1990     </t>
1991     <t>
1992     <ja:pair>
1993     <ja:l xml:lang="en">
1994     We've already discussed the "front" element back in
1995     <xref target="front_matter" />.
1996     </ja:l>
1997     <ja:l xml:lang="ja">
1998     "front" $BMWAG$K$D$$$F$O(B <xref target="front_matter" />
1999     $B$G4{$KOC$7$^$7$?!#(B
2000     </ja:l>
2001     </ja:pair>
2002     </t>
2003     <t>
2004     <ja:pair>
2005     <ja:l xml:lang="en">
2006     The "seriesInfo" element has two attributes,
2007     "name" and "value" that identify the document series and series entry,
2008     respectively.
2009     </ja:l>
2010     <ja:l xml:lang="ja">
2011     "seriesInfo" $BMWAG$O(B "name", "value" $B$N(B2$B$D$NB0@-$r;}$A!"$=$l$>$lJ8=q7ONs$H7ONs9`L\$rFCDj$7$^$9!#(B
2012     </ja:l>
2013     </ja:pair>
2014     </t>
2015     <figure>
2016     <preamble>
2017     <ja:pair>
2018     <ja:l xml:lang="en">
2019     The "reference" element has an optional "anchor"
2020     attribute that is used for cross-referencing with
2021     <xref target="xref">the "xref" element</xref>, e.g.,
2022     </ja:l>
2023     <ja:l xml:lang="ja">
2024     "reference" $BMWAG$O>JN,2DG=$J(B "anchor" $BB0@-$r;}$A!"(B
2025     $B<!$NMM$K;H$$!"(B <xref target="xref">"xref" $BMWAG(B</xref>$B$G8r:9;2>H$K;H$&$3$H$,=PMh$^$9!#(B
2026     </ja:l>
2027     </ja:pair>
2028     </preamble>
2029     <artwork><![CDATA[
2030     <reference anchor="refs.RFC2200">
2031     <front>
2032     <title>Internet Official Protocol Standards</title>
2033     <author initials="J." surname="Postel"
2034     fullname="Jon Postel">
2035     <organization abbrev="ISI">
2036     USC/Information Sciences Institute
2037     </organization>
2038     </author>
2039    
2040     <date month="June" year="1997" />
2041     </front>
2042     <seriesInfo name="RFC" value="2200" />
2043     <seriesInfo name="STD" value="1" />
2044     </reference>
2045     ]]></artwork>
2046     </figure>
2047     <t>
2048     <ja:pair>
2049     <ja:l xml:lang="en">
2050     The "reference" element also has an optional "target"
2051     attribute that is used for external references
2052     (c.f., <xref target="eref" />).
2053     The XML application,
2054     if producing an HTML version of the document will use the "target"
2055     attribute accordingly;
2056     however, if the "name" attribute of the "seriesInfo" element has the value
2057     "RFC",
2058     then the XML application should automatically provide an appropriate
2059     default for the "target" attribute
2060     (e.g., <![CDATA["http://example.com/rfcs/rfc2200.txt"]]>).
2061     </ja:l>
2062     <ja:l xml:lang="ja">
2063     "reference" $BMWAG$K$O>JN,2DG=$J(B "target" $BB0@-$,$"$j!"30It;2>H$K;H$$$^$9!#(B
2064     (cf. <xref target="eref" />) XML $B1~MQ$OJ8=q$N(B HTML $BHG$r@8@.$9$k;~$K(B
2065     "target" $BB0@-$r;H$$$^$9!#$7$+$7!"(B "seriseInfo" $BMWAG$N(B "name"
2066     $BB0@-$,CM(B "RFC" $B$r;}$D>l9g!"(B XML $B1~MQ$O<+F0E*$KE,@Z$J(B "target"
2067     $BB0@-$N4{DjCM$rMQ0U$9$k$Y$-$G$9!#(B ($BNc$($P(B
2068     <h:samp><![CDATA[http://example.com/rfcs/rfc2200.txt]]></h:samp>)
2069     </ja:l>
2070     </ja:pair>
2071     </t>
2072     </section>
2073     <section title="Appendices" ja:title-ja="$BImB0=q(B">
2074     <t>
2075     <ja:pair>
2076     <ja:l xml:lang="en">
2077     To include appendices after the bibliography,
2078     simply add more "section" elements.
2079     (For an example,
2080     look at the example at the beginning of <xref target="back_matter" />.)
2081     </ja:l>
2082     <ja:l xml:lang="ja">
2083     $B;29MJ88%$N8e$KImB0=q$r4^$a$k$K$O!"C1$K(B "section"
2084     $BMWAG$rDI2C$9$k$@$1$G$9!#(B ($BNc$H$7$F!"(B <xref target="back_matter" />
2085     $B$N$O$8$a$NNc$r8fMw2<$5$$!#(B)
2086     </ja:l>
2087     </ja:pair>
2088     </t>
2089     </section>
2090     <section title="Copyright Status" ja:title-ja="$BCx:n8">uBV(B">
2091     <t>
2092     <ja:pair>
2093     <ja:l xml:lang="en">
2094     The copyright status for the document is not included in the
2095     document's markup $B!=!=(B this is automatically inserted by an XML
2096     application that produces either a text or HTML version of the document.
2097     </ja:l>
2098     <ja:l xml:lang="ja">
2099     $BJ8=q$NCx:n8">uBV$OJ8=q$N%^!<%/IU$1$K$O4^$a$^$;$s!#(B
2100     $B$3$l$OJ8=q$N(B text $BHG$+(B HTML $BHG$r@8@.$9$k(B XML
2101     $B1~MQ$K$h$j<+F0E*$KA^F~$5$l$^$9!#(B
2102     </ja:l>
2103     </ja:pair>
2104     </t>
2105     </section>
2106     </section>
2107     </section>
2108     <section title="Processing the XML Source File" ja:title-ja="XML $B8;%U%!%$%k$N=hM}(B">
2109     <t>
2110     <ja:pair>
2111     <ja:l xml:lang="en">
2112     This section concerns itself with applications that operate on
2113     an XML source file.
2114     A lot of XML tools are available,
2115     as are many lists of XML resources,
2116     e.g.,
2117     <eref target="http://metalab.unc.edu/xml/">Cafe con Leche</eref>.
2118     </ja:l>
2119     <ja:l xml:lang="ja">
2120     $B$3$N@a$O(B XML $B8;%U%!%$%k$r=hM}$9$k1~MQ$K$D$$$F$G$9!#Bt;3$N(B
2121     XML $B9)6q$,MxMQ2DG=$G$9$7!"Bt;3$N(B XML $B;q8;$N0lMw$b!"Nc$($P(B
2122     <eref target="http://metalab.unc.edu/xml/">Cafe con Leche</eref>
2123     $B$K$"$j$^$9!#(B
2124     </ja:l>
2125     </ja:pair>
2126     </t>
2127     <t>
2128     <ja:pair>
2129     <ja:l xml:lang="en">
2130     There are two kinds of XML tools: validating and non-validating.
2131     Both check that the source file conforms to the rules given in
2132     <xref target="xml_basics" />.
2133     However,
2134     in addition to making sure that the source file is well-formed,
2135     a validating tool also reads the DTD referenced by the source file
2136     to make sure that they match.
2137     There are a number of both validating and non-validating tools available.
2138     </ja:l>
2139     <ja:l xml:lang="ja">
2140     XML $B9)6q$K$O(B2$B<oN`$"$j$^$9(B: $B8!>Z$9$k$b$N$H8!>Z$7$J$$$b$N$G$9!#N><T6&$K!"8;%U%!%$%k$,(B
2141     <xref target="xml_basics" /> $B$K5s$2$?5,B'$KE,9g$9$k$+$O3NG'$7$^$9!#$7$+$7!"2C$($F8;%U%!%$%k$,@07A<0$G$"$k$+$r3NG'$9$k$?$a!"8!>Z9)6q$O8=%U%!%$%k$,;2>H$7$F$$$k(B
2142     DTD $B$bFI$s$G0lCW$7$F$$$k$+3NG'$7$^$9!#8!>Z!&Hs8!>Z9)6q6&$KB??tF~<j=PMh$^$9!#(B
2143     </ja:l>
2144     </ja:pair>
2145     </t>
2146     <section title="Editing" ja:title-ja="$BJT=8(B">
2147     <t>
2148     <ja:pair>
2149     <ja:l xml:lang="en">
2150     There are several XML editors available.
2151     Ideally,
2152     you want an editor that validates.
2153     This has two advantages:
2154     </ja:l>
2155     <ja:l xml:lang="ja">
2156     XML $B%(%G%#%?!<$O4v$D$+F~<j2DG=$G$9!#M}A[E*$K$O!"8!>Z=PMh$k%(%G%#%?!<$,NI$$$G$7$g$&!#$3$l$K$O(B2$B$D$NMxE@$,$"$j$^$9!#(B
2157     </ja:l>
2158     </ja:pair>
2159    
2160     <list style="symbols">
2161     <t>
2162     <ja:pair>
2163     <ja:l xml:lang="en">
2164     the editor provides guidance in fleshing-out the document structure;
2165     and,
2166     </ja:l>
2167     <ja:l xml:lang="ja">
2168     $B%(%G%#%?!<$,J8=q9=B$$KFyIU$1$9$k<j0z$-$r<($9(B
2169     </ja:l>
2170     </ja:pair>
2171     </t>
2172     <t>
2173     <ja:pair>
2174     <ja:l xml:lang="en">
2175     the editor validates that the source file matches the rules in the DTD.
2176     </ja:l>
2177     <ja:l xml:lang="ja">
2178     $B%(%G%#%?!<$,8;%U%!%$%k$,(B DTD $B$N5,B'$H0lCW$7$F$$$k$+8!>Z$9$k(B
2179     </ja:l>
2180     </ja:pair>
2181     </t>
2182     </list>
2183     </t>
2184     <figure>
2185     <preamble>
2186     <ja:pair>
2187     <ja:l xml:lang="en">
2188     There are two major modes in Emacs that support XML:
2189     <eref target="http://www.mulberrytech.com/tdtd/">tdtd</eref> and
2190     <eref target="http://www.inria.fr/koala/plh/sxml.html">psgml</eref>.
2191     The latter mode allows you to validate the source file
2192     (by calling an external program).
2193     If you visit the source file in Emacs and the major mode isn't
2194     "SGML" or "XML",
2195     then usually all it takes is adding these lines to your ".emacs"
2196     file:
2197     </ja:l>
2198     <ja:l xml:lang="ja">
2199     Emacs $B$G$O(B XML $B$KBP1~$7$?(B2$B$D$NBg%b!<%I!"(B
2200     <eref target="http://www.mulberrytech.com/tdtd/">tdtd</eref> $B$H(B
2201     <eref target="http://www.inria.fr/koala/plh/sxml.html">psgml</eref>
2202     $B$,$"$j$^$9!#8e<T$N%b!<%I$G$O8;%U%!%$%k$r(B
2203     ($B30It%W%m%0%i%`$r8F$S=P$9$3$H$K$h$j(B) $B8!>Z$9$k$3$H$,=PMh$^$9!#8;%U%!%$%k$r(B
2204     Emacs $B$G$_$F!"Bg%b!<%I$,(B $B!V(BSGML$B!W(B $B$+(B $B!V(BXML$B!W(B
2205     $B$K$J$i$J$$>l9g!"DL>o$O(B ".emacs" $B%U%!%$%k$K<!$N9T(B
2206     </ja:l>
2207     </ja:pair>
2208     </preamble>
2209     <artwork><![CDATA[
2210     (setq auto-mode-alist
2211     (cons (cons "\\.xml$" 'sgml-mode) auto-mode-alist))
2212     ]]></artwork>
2213     <postamble>
2214     <ja:pair>
2215     <ja:l xml:lang="en">
2216     and then restarting Emacs.
2217     If this doesn't work,
2218     try one of the sources above.
2219     </ja:l>
2220     <ja:l xml:lang="ja">
2221     $B$r2C$($F!"(B Emacs $B$r:F5/F0$7$^$9!#$3$l$G>e<j$/$$$+$J$1$l$P!">e5-$N>pJs8;$N$$$:$l$+$r;n$7$F$_$F2<$5$$!#(B
2222     </ja:l>
2223     </ja:pair>
2224     </postamble>
2225     </figure>
2226     <t>
2227     <ja:pair>
2228     <ja:l xml:lang="en">
2229     The author uses both sgml-mode in Emacs,
2230     and a commercial validating editor,
2231     <eref target="http://www.t2000-usa.com/">Clip! version 1.5</eref>,
2232     when editing source
2233     files.
2234     </ja:l>
2235     <ja:l xml:lang="ja">
2236     $BCx<T$ON>(B sgml-mode $B$r(B Emacs $B$G;H$C$F$$$F!">&MQ8!>Z%(%G%#%?!<(B
2237     <eref xml:lang="en" target="http://www.t2000-usa.com/">Clip! version 1.5</eref>
2238     $B$r8;%U%!%$%k$rJT=8$9$k$N$K;H$C$F$$$^$9!#(B
2239     </ja:l>
2240     </ja:pair>
2241     </t>
2242     <section title="Checking" ja:title-ja="$B3NG'(B">
2243     <t>
2244     <ja:pair>
2245     <ja:l xml:lang="en">
2246     If your editor doesn't validate,
2247     then you should run a program to validate the source file.
2248     </ja:l>
2249     <ja:l xml:lang="ja">
2250     $B$*;H$$$N%(%G%#%?!<$,8!>Z$7$J$$$J$i!"8;%U%!%$%k$r8!>Z$9$k$N$K%W%m%0%i%`$rF0$+$9I,MW$,$"$j$^$9!#(B
2251     </ja:l>
2252     </ja:pair>
2253     </t>
2254     <t>
2255     <ja:pair>
2256     <ja:l xml:lang="en">
2257     The author uses
2258     <eref target="http://www.alphaworks.ibm.com/formula/xml/">the
2259     AlphaWorks XML parser</eref> for this purpose.
2260     It requires that your system have a Java virtual machine.
2261     In addition to Java,
2262     there are validating parsers written in C, Perl, Python, and Tcl.
2263     </ja:l>
2264     <ja:l xml:lang="ja">
2265     $BCx<T$O(B
2266     <eref xml:lang="en" target="http://www.alphaworks.ibm.com/formula/xml/">the
2267     AlphaWorks XML parser</eref> $B$r$3$NL\E*$K;H$C$F$$$^$9!#$3$l$K$O$*;H$$$N7OE}$K(B
2268     Java $B2>A[5!3#$,I,MW$G$9!#(B Java $B$K2C$(!"(B C, Perl, Python, Tcl
2269     $B$G=q$+$l$?8!>Z2r@O4o$,$"$j$^$9!#(B
2270     </ja:l>
2271     </ja:pair>
2272     </t>
2273     </section>
2274     </section>
2275     <section anchor="xml2rfc" title="Converting to Text Format" ja:title-ja="text $B7A<0$KJQ49$9$k(B">
2276     <t>
2277     <ja:pair>
2278     <ja:l xml:lang="en">
2279     The author has written
2280     <eref target="http://memory.palace.org/authoring/">the xml2rfc tool</eref>,
2281     which reads the source file and produces both a text and HTML version
2282     of the document.
2283     (This memo was produced using the xml2rfc tool.)
2284     Note that xml2rfc isn't a validating tool,
2285     so it's a good idea to use either a validating editor or run a stand-alone
2286     validating parser prior to using the tool.
2287     </ja:l>
2288     <ja:l xml:lang="ja">
2289     $BCx<T$O8;%U%!%$%k$rFI$s$GJ8=q$N(B text $BHG$H(B HTML $BHG$NN><T$r@8@.$9$k(B
2290     <eref target="http://memory.palace.org/authoring/">xml2rfc
2291     $B9)6q(B</eref>$B$r=q$-$^$7$?!#(B ($B$3$N%a%b$O(B xml2rfc $B9)6q$r;H$C$F@8@.$7$^$7$?!#(B)
2292     $B$J$*!"(B xml2rfc $B$O8!>Z9)6q$G$O$J$$$N$G!"8!>Z%(%G%#%?!<$dC1FH8!>Z2r@O4o$r$3$N9)6q$NA0$K;H$&$N$,NI$$$G$7$g$&!#(B
2293     </ja:l>
2294     </ja:pair>
2295     </t>
2296     </section>
2297     <section title="Converting to HTML Format" ja:title-ja="HTML $B7A<0$KJQ49$9$k(B">
2298     <t>
2299     <ja:pair>
2300     <ja:l xml:lang="en">
2301     The XML Style Language (XSL) is used to describe transformations
2302     from the source file into some other structured file.
2303     So,
2304     ideally you should use an XSL-capable formatter to convert an XML source
2305     file to HTML.
2306     </ja:l>
2307     <ja:l xml:lang="ja">
2308     XML $B%9%?%$%k8@8l(B (XSL) $B$r8;%U%!%$%k$+$iB>$N9=B$$N%U%!%$%k$KJQ7A$9$k$N$r5-=R$9$k$N$K;HMQ=PMh$^$9!#$G$9$+$i!"M}A[E*$K$O(B XSL $B$,;H$($k(B formatter
2309     $B$r;H$C$F(B XML $B8;%U%!%$%k$r(B HTML $B$KJQ49$9$k$Y$-$G$7$g$&!#(B
2310     </ja:l>
2311     </ja:pair>
2312     </t>
2313     <t>
2314     <ja:pair>
2315     <ja:l xml:lang="en">
2316     However,
2317     as of this writing XSL is still in considerable flux.
2318     (Hence,
2319     no reference was included in this memo,
2320     as by the time you read this section,
2321     the reference would be outdated.)
2322     So,
2323     in the interim,
2324     the author uses the xml2rfc tool for this purpose,
2325     even though this tool doesn't provide much flexibility in its HTML layout.
2326     </ja:l>
2327     <ja:l xml:lang="ja">
2328     $B$7$+$7$J$,$i!"$3$N(B XSL $B=q$-$O$^$@N.F0E*$H9M$($i$l$^$9!#(B
2329     ($B$=$l8N!"$3$N%a%b$K$O;2>H$O4^$a$^$;$s$G$7$?!#FI<T$,$3$N@a$rFI$`;~$K$O;2>H$O$b$&8E$$$b$N$K$J$C$F$$$k$G$7$g$&$+$i!#(B)
2330     $B$G$9$,!"$=$N4V!"Cx<T$O$3$NL\E*$K(B xml2rfc $B9)6q$r;H$$$^$9!#(B
2331     $B$3$N9)6q$O$=$l$[$I(B HTML $BG[CV$K=@Fp@-$r;}$C$F$$$J$$$N$G$9$,!#(B
2332     </ja:l>
2333     </ja:pair>
2334     </t>
2335     <ja:note>
2336     <t>rfc2629.xslt $B$O!"(B
2337     <eref target="http://xml.resource.org/authoring/">xml2rfc
2338     $B9)6q(B</eref>$B$K4^$^$l$F$$$^$9!#$3$l$r;H$C$F9+$N(B XSLT formatter
2339     $B$G$b(B HTML $B$KJQ49=PMh$^$9!#(B</t>
2340     </ja:note>
2341     </section>
2342     <section title="Viewing" ja:title-ja="$BI=<((B">
2343     <t>
2344     <ja:pair>
2345     <ja:l xml:lang="en">
2346     Browsers that support either XSL or Cascading Style Sheets (CSS)
2347     are able to view the source file directly.
2348     </ja:l>
2349     <ja:l xml:lang="ja">
2350     XSL $B$+(B Cascading Style Sheets (CSS)
2351     $B$KBP1~$7$?1\Mw4o$r8;%U%!%$%k$rD>@\8+$k$N$K;HMQ=PMh$^$9!#(B
2352     </ja:l>
2353     </ja:pair>
2354     </t>
2355     <t>
2356     <ja:pair>
2357     <ja:l xml:lang="en">
2358     At present,
2359     the author doesn't use any of these browsers,
2360     instead converting source files to either text or HTML.
2361     </ja:l>
2362     <ja:l xml:lang="ja">
2363     $B8=;~E@$G!"Cx<T$O$=$NMM$J1\Mw4o$r;H$C$F$*$i$:!"Be$o$j$K8;%U%!%$%k$r(B
2364     text $B$+(B HTML $B$KJQ49$7$F$$$^$9!#(B
2365     </ja:l>
2366     </ja:pair>
2367     </t>
2368     </section>
2369     <section title="Searching" ja:title-ja="$B8!:w(B">
2370     <t>
2371     <ja:pair>
2372     <ja:l xml:lang="en">
2373     As with text editors,
2374     any text-oriented search tool (e.g., grep) can be used on the source file.
2375     However,
2376     there are search tools available that understand structured source.
2377     </ja:l>
2378     <ja:l xml:lang="ja">
2379     text $B%(%G%#%?!<$H6&$K!"$I$s$J(B text $B;X8~8!:w9)6q(B ($BNc(B grep)
2380     $B$r$b8;%U%!%$%k$KBP$7$F;H$&$3$H$,=PMh$^$9!#$7$+$7!"9=B$2=$5$l$?8;$rM}2r$9$k8!:wF;6q$b$"$j$^$9!#(B
2381     </ja:l>
2382     </ja:pair>
2383     </t>
2384     <figure>
2385     <preamble>
2386     <ja:pair>
2387     <ja:l xml:lang="en">
2388     The author uses
2389     <eref target="http://www.cs.helsinki.fi/~jjaakkol/sgrep.html">sgrep
2390     version 1.9</eref>
2391     for this purpose,
2392     e.g.
2393     </ja:l>
2394     <ja:l xml:lang="ja">
2395     $BCx<T$O(B
2396     <eref target="http://www.cs.helsinki.fi/~jjaakkol/sgrep.html">sgrep
2397     version 1.9</eref> $B$r$3$NL\E*$G<!$NMM$K;H$C$F$$$^$9!#(B
2398     </ja:l>
2399     </ja:pair>
2400     </preamble>
2401     <artwork>
2402     sgrep -g xml 'ELEMENTS("title") not in ELEMENTS("back")' \
2403     writing-rfcs.xml
2404     </artwork>
2405     <postamble>
2406     <ja:pair>
2407     <ja:l xml:lang="en">
2408     which extracts the title element from the source file.
2409     </ja:l>
2410     <ja:l xml:lang="ja">
2411     $B$3$l$O(B title $BMWAG$r8;%U%!%$%k$+$i<h$j=P$7$^$9!#(B
2412     </ja:l>
2413     </ja:pair>
2414     </postamble>
2415     </figure>
2416     </section>
2417     </section>
2418     <section title="Security Considerations">
2419     <figure>
2420     <preamble>
2421     <ja:pair>
2422     <ja:l xml:lang="en">
2423     This memo raises no security issues;
2424     however,
2425     according to <xref target="refs.RFC2223" />,
2426     your document should contain a section near the end that discusses the
2427     security considerations of the protocol or procedures that are the
2428     main topic of your document, e.g.,
2429     </ja:l>
2430     <ja:l xml:lang="ja">
2431     $B$3$N%a%b$O0BA4@-LdBj$r5/$3$7$^$;$s!#$7$+$7!"(B <xref target="refs.RFC2223" />
2432     $B$K$h$k$H!"J8=q$O=*$o$j6a$/$K!"J8=q$N<gBj$G$"$k%W%m%H%3%k$d=hM}$N0BA4@-$K4X$7$F$N5DO@$N@a$r@_$1$k$Y$-$G$9!#Nc(B:
2433     </ja:l>
2434     </ja:pair>
2435     </preamble>
2436    
2437     <ja:pair>
2438     <ja:l xml:lang="en">
2439     <artwork><![CDATA[
2440     <middle>
2441     ...
2442     <section title="Security Considerations">
2443     <t>This memo raises no security issues;
2444     however,
2445     according to <xref target="refs.RFC2223" />,
2446     your document should contain a section near the end
2447     that discusses the security considerations of the
2448     protocol or procedures that are the main topic of your
2449     document.</t>
2450     </section>
2451     </middle>
2452     ]]></artwork>
2453     </ja:l>
2454     <ja:l xml:lang="ja">
2455     <artwork><![CDATA[
2456     <middle>
2457     ...
2458     <section title="$B0BA4@-$K4X$7$F(B">
2459     <t>$B$3$N%a%b$O0BA4@-LdBj$r5/$3$7$^$;$s!#$7$+$7!"(B
2460     <xref target="refs.RFC2223" /> $B$K$h$k$H!"(B
2461     $BJ8=q$O=*$o$j6a$/$K!"J8=q$N<gBj$G$"$k%W%m%H%3%k$d(B
2462     $B=hM}$N0BA4@-$K4X$7$F$N5DO@$N@a$r@_$1$k$Y$-$G$9!#(B</t>
2463     </section>
2464     </middle>
2465     ]]></artwork>
2466     </ja:l>
2467     </ja:pair>
2468    
2469     </figure>
2470     </section>
2471     </middle>
2472     <back>
2473     <references>
2474     <reference anchor="XML" target="http://www.w3.org/TR/1998/REC-xml-19980210">
2475     <front>
2476     <title>Extensible Markup Language (XML) 1.0</title>
2477     <ja:title-ja>$B3HD%2DG=%^!<%/IU$18@8l(B (XML) 1.0</ja:title-ja>
2478     <author>
2479     <organization abbrev="W3C">World Wide Web Consortium</organization>
2480     <address>
2481     <postal>
2482     <street>MIT Laboratory for Computer Science</street>
2483     <street>545 Technology Square</street>
2484     <city>Cambridge</city> <region>MA</region> <code>02139</code>
2485     <country>US</country>
2486     </postal>
2487     <phone>+ 1 617 253 2613</phone>
2488     <facsimile>+ 1 617 258 5999</facsimile>
2489     <email>timbl@w3.org</email>
2490     <uri>http://www.w3c.org</uri>
2491     </address>
2492     </author>
2493     <date month="February" year="1998" />
2494     </front>
2495     <seriesInfo name="W3C" value="XML" />
2496     </reference>
2497     <reference anchor="refs.RFC2223">
2498     <front>
2499     <title>Instructions to RFC Authors</title>
2500     <ja:title-ja>RFC $BCx<T$N<j0z$-(B</ja:title-ja>
2501     <author initials="J." surname="Postel" fullname="Jon Postel">
2502     <organization abbrev="ISI">USC/Information Sciences Institute</organization>
2503     <address>
2504     <postal>
2505     <street>4676 Admiralty Way</street>
2506     <city>Marina del Rey</city> <region>CA</region> <code>90292</code>
2507     <country>US</country>
2508     </postal>
2509     <phone>+1 310 822 1511</phone>
2510     <facsimile>+1 310 823 6714</facsimile>
2511     <email>Postel@ISI.EDU</email>
2512     </address>
2513     </author>
2514     <author initials="J." surname="Reynolds" fullname="Joyce K. Reynolds">
2515     <organization abbrev="ISI">USC/Information Sciences Institute</organization>
2516     <address>
2517     <postal>
2518     <street>4676 Admiralty Way</street>
2519     <city>Marina del Rey</city> <region>CA</region> <code>90292</code>
2520     <country>US</country>
2521     </postal>
2522     <phone>+1 310 822 1511</phone>
2523     <facsimile>+1 310 823 6714</facsimile>
2524     <email>jkrey@isi.edu</email>
2525     </address>
2526     </author>
2527     <date month="October" year="1997" />
2528     </front>
2529     <seriesInfo name="RFC" value="2223" />
2530     </reference>
2531     <reference anchor="refs.RFC2026">
2532     <front>
2533     <title>The Internet Standards Process $B!=!=(B Revision 3</title>
2534     <ja:title-ja>Internet $BI8=`2=2aDx(B $B!=!=(B $B2~D{(B3$BHG(B</ja:title-ja>
2535     <author initials="S.O." surname="Bradner" fullname="Scott O. Bradner">
2536     <organization>Harvard University</organization>
2537     <address>
2538     <postal>
2539     <street>Holyoke Center, Room 813</street>
2540     <street>1350 Massachusettes Avenue</street>
2541     <city>Cambridge</city> <region>MA</region> <code>02138</code>
2542     <country>US</country>
2543     </postal>
2544     <phone>+1 617 495 3864</phone>
2545     <email>sob@harvard.edu</email>
2546     </address>
2547     </author>
2548     <date month="October" year="1996" />
2549     </front>
2550     <seriesInfo name="RFC" value="2026" />
2551     <seriesInfo name="BCP" value="9" />
2552     </reference>
2553     <reference anchor="URI">
2554     <front>
2555     <title>Uniform Resource Identifiers (URI): Generic Syntax</title>
2556     <ja:title-ja>$BE}0l;q8;<1JL;R(B (URI): $B0lHL9=J8(B</ja:title-ja>
2557     <author initials="T." surname="Berners-Lee" fullname="Tim Berners-Lee">
2558     <organization abbrev="W3C">World Wide Web Consortium</organization>
2559     <address>
2560     <postal>
2561     <street>MIT Laboratory for Computer Science</street>
2562     <street>545 Technology Square</street>
2563     <city>Cambridge</city> <region>MA</region> <code>02139</code>
2564     <country>US</country>
2565     </postal>
2566     <phone>+1 617 253 5702</phone>
2567     <facsimile>+1 617 258 8682</facsimile>
2568     <email>timbl@w3.org</email>
2569     </address>
2570     </author>
2571     <author initials="R.T." surname="Fielding" fullname="Roy T. Fielding">
2572     <organization abbrev="UCI">University of California, Irvine</organization>
2573     <address>
2574     <postal>
2575     <street>Department of Information and Computer Science</street>
2576     <street>University of California, Irvine</street>
2577     <city>Irvine</city> <region>CA</region> <code>92697-3425</code>
2578     <country>US</country>
2579     </postal>
2580     <phone>+1 949 824 7403</phone>
2581     <facsimile>+1 949 824 1715</facsimile>
2582     <email>fielding@ics.uci.edu</email>
2583     </address>
2584     </author>
2585     <author initials="L." surname="Masinter" fullname="Larry Masinter">
2586     <organization>Xerox PARC</organization>
2587     <address>
2588     <postal>
2589     <street>3333 Coyote Hill Road</street>
2590     <city>Palo Alto</city> <region>CA</region> <code>94304</code>
2591     <country>US</country>
2592     </postal>
2593     <phone>+1 650 812 4365</phone>
2594     <facsimile>+1 650 812 4333</facsimile>
2595     <email>masinter@parc.xerox.com</email>
2596     </address>
2597     </author>
2598     <date month="August" year="1998" />
2599     </front>
2600     <seriesInfo name="RFC" value="2396" />
2601     </reference>
2602     </references>
2603     <section anchor="rfc" title="The rfc Element" ja:title-ja="rfc $BMWAG(B">
2604     <figure>
2605     <preamble>
2606     <ja:pair>
2607     <ja:l xml:lang="en">
2608     The "&lt;rfc&gt;" tag at the beginning of the file,
2609     with only <xref target="ipr">an "ipr" attribute</xref>,
2610     produces an Internet-Draft.
2611     However,
2612     when other attributes are added to this tag by the RFC editor,
2613     an RFC is produced, e.g.,
2614     </ja:l>
2615     <ja:l xml:lang="ja">
2616     $B%U%!%$%k$N$O$8$a$N(B "&lt;rfc&gt;" $B%?%0$O!"(B
2617     <xref target="ipr">"ipr" $BB0@-(B</xref>$B$@$1$r;}$D$H!"(B Internet-Draft
2618     $B$r@8@.$7$^$9!#$7$+$7!"$3$N%?%0$K(B RFC $BJT=8<T$K$h$jB>$NB0@-$,(B
2619     $BIU2C$5$l$k$H!"(B RFC $B$,@8@.$5$l$^$9!#(B
2620     </ja:l>
2621     </ja:pair>
2622     </preamble>
2623     <artwork><![CDATA[
2624     <rfc number="2200"
2625     obsoletes="2000, 1920, 1880, 1800, ..."
2626     category="std"
2627     seriesNo="1">
2628     ]]></artwork>
2629     <postamble>
2630     <ja:pair>
2631     <ja:l xml:lang="en">
2632     At a minimum,
2633     the "number" attribute should be present.
2634     </ja:l>
2635     <ja:l xml:lang="ja">
2636     $B>/$J$/$F$b!"(B "number" $BB0@-$,$"$k$Y$-$G$9!#(B
2637     </ja:l>
2638     </ja:pair>
2639     </postamble>
2640     </figure>
2641     <t>
2642     <ja:pair>
2643     <ja:l xml:lang="en">
2644     The other attributes are:
2645     </ja:l>
2646     <ja:l xml:lang="ja">
2647     $B$3$NB>$NB0@-$O!"(B
2648     </ja:l>
2649     </ja:pair>
2650    
2651     <list style="symbols">
2652     <t>
2653     <ja:pair>
2654     <ja:l xml:lang="en">
2655     "obsoletes",
2656     having a comma-separated list of RFC numbers,
2657     that the document obsoletes;
2658     </ja:l>
2659     <ja:l xml:lang="ja">
2660     "obsoleted" $B$O!"$=$NJ8=q$,GQ;_$9$kFIE@(B (comma) $B6h@Z$j$N(B RFC $BHV9f$N0lMw$G$9!#(B
2661     </ja:l>
2662     </ja:pair>
2663     </t>
2664     <t>
2665     <ja:pair>
2666     <ja:l xml:lang="en">
2667     "updates",
2668     having a comma-separated list of RFC numbers,
2669     that the document updates;
2670     </ja:l>
2671     <ja:l xml:lang="ja">
2672     "updates" $B$O!"$=$NJ8=q$,99?7$9$kFIE@(B (comma) $B6h@Z$j$N(B RFC $BHV9f$N0lMw$G$9!#(B
2673     </ja:l>
2674     </ja:pair>
2675     </t>
2676     <t>
2677     <ja:pair>
2678     <ja:l xml:lang="en">
2679     "category",
2680     having one of these values:
2681     </ja:l>
2682     <ja:l xml:lang="ja">
2683     "category" $B$O!"<!$NCM$N$$$:$l$+$r;}$A$^$9!#(B
2684     </ja:l>
2685     </ja:pair>
2686    
2687     <list style="numbers">
2688     <t>
2689     <ja:pair>
2690     <ja:l xml:lang="en">"std", for a Standards-Track document;</ja:l>
2691     <ja:l xml:lang="ja">"std" $B$OI8=`2=2aDxJ8=qMQ(B</ja:l>
2692     </ja:pair>
2693     </t>
2694     <t>
2695     <ja:pair>
2696     <ja:l xml:lang="en">"bcp", for a Best Current Practices document;</ja:l>
2697     <ja:l xml:lang="ja">"bcp" $B$O8=>u:GA11?MQJ8=qMQ(B</ja:l>
2698     </ja:pair>
2699     </t>
2700     <t>
2701     <ja:pair>
2702     <ja:l xml:lang="en">"exp", for an Experimental Protocol document;</ja:l>
2703     <ja:l xml:lang="ja">"exp" $B$O<B83%W%m%H%3%kJ8=qMQ(B</ja:l>
2704     </ja:pair>
2705     </t>
2706     <t>
2707     <ja:pair>
2708     <ja:l xml:lang="en">"historic", for a historic document; or,</ja:l>
2709     <ja:l xml:lang="ja">"exp" $B$ONr;KE*J8=qMQ(B</ja:l>
2710     </ja:pair>
2711     </t>
2712     <t>
2713     <ja:pair>
2714     <ja:l xml:lang="en">"info", the default, for an Informational document.</ja:l>
2715     <ja:l xml:lang="ja">"info" $B$O4{DjCM$G;29MJ8=qMQ(B</ja:l>
2716     </ja:pair>
2717     </t>
2718     </list>
2719     </t>
2720     <t>
2721     <ja:pair>
2722     <ja:l xml:lang="en">
2723     "seriesNo",
2724     having the corresponding number in the STD (std), BCP (bcp), or FYI (info)
2725     series.
2726     </ja:l>
2727     <ja:l xml:lang="ja">
2728     "seriesNo" $B$O!"(B STD (std), BCP (bcp), FYI (info) $B3F7ONs$G$NBP1~HV9f$rCM$K;}$A$^$9!#(B
2729     </ja:l>
2730     </ja:pair>
2731     </t>
2732     </list>
2733     </t>
2734     <t>
2735     <ja:pair>
2736     <ja:l xml:lang="en">
2737     Finally,
2738     a special entity, "&amp;rfc.number;", is available.
2739     Authors preparing an RFC should use this entity whenever they want to
2740     reference the number of the RFC within the document itself.
2741     In printed versions of the document,
2742     the appropriate substitution (or "XXXX") will occur.
2743     </ja:l>
2744     <ja:l xml:lang="ja">
2745     $B:G8e$K!"FCJL$J<BBN(B "&amp;rfc.number;" $B$,;H$($^$9!#(B
2746     RFC $B$rMQ0U$9$kCx<T$O$3$N<BBN$rJ8=q<+?H$N(B
2747     RFC $BHV9f$r;2>H$7$?$$;~$K;H$&$Y$-$G$9!#J8=q$N0u:~HG$G$O!"E,@Z$JBeBX(B
2748     ($B$^$?$O(B "XXXX") $B$r;H$$$^$9!#(B
2749     </ja:l>
2750     </ja:pair>
2751     <ja:note>
2752     <figure>
2753     <preamble>$B<B:]$K;H$&;~$O!"(B</preamble>
2754     <artwork><![CDATA[<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [<!ENTITY rfc.number "1234">]>]]></artwork>
2755     <postamble>$B$N$h$&$K!"J8=q7?@k8@$GEv3:(B RFC
2756     $BHV9f$r<($9$3$H$K$J$k$G$7$g$&!#(B</postamble>
2757     </figure>
2758     </ja:note>
2759     </t>
2760     </section>
2761     <section anchor="rfc.dtd" title="The RFC DTD">
2762    
2763     <ja:note>
2764     <t>$B$3$N(B DTD $B$N%U%!%$%k(B rfc2629.dtd $B$O!"(B
2765     <eref target="http://xml.resource.org/authoring/">xml2rfc
2766     $B9)6q(B</eref>$B$NCf$K$b4^$^$l$F$$$^$9!#(B</t>
2767     </ja:note>
2768    
2769     <figure>
2770    
2771     <ja:pair>
2772     <ja:l xml:lang="en">
2773     <artwork><![CDATA[
2774     <!--
2775     DTD for the RFC document series, draft of 99-01-30
2776     -->
2777    
2778    
2779     <!--
2780     Contents
2781    
2782     DTD data types
2783    
2784     The top-level
2785    
2786     Front matter
2787    
2788     The Body
2789    
2790     Back matter
2791     -->
2792    
2793    
2794     <!--
2795     DTD data types:
2796    
2797     entity description
2798     ====== ===============================================
2799     NUMBER [0-9]+
2800     NUMBERS a comma-separated list of NUMBER
2801    
2802     DAY the day of the month, e.g., "1"
2803     MONTH the month of the year, e.g., "January"
2804     YEAR a four-digit year, e.g., "1999"
2805    
2806     URI e.g., "http://invisible.net/"
2807    
2808     ATEXT/CTEXT printable ASCII text (no line-terminators)
2809    
2810     TEXT character data
2811     -->
2812    
2813    
2814     <!ENTITY % NUMBER "CDATA">
2815     <!ENTITY % NUMBERS "CDATA">
2816    
2817     <!ENTITY % DAY "CDATA">
2818     <!ENTITY % MONTH "CDATA">
2819     <!ENTITY % YEAR "CDATA">
2820    
2821     <!ENTITY % URI "CDATA">
2822    
2823     <!ENTITY % ATEXT "CDATA">
2824     <!ENTITY % CTEXT "#PCDATA">
2825    
2826     <!ENTITY % TEXT "#PCDATA">
2827    
2828     <!ENTITY rfc.number "]]>&rfc.number;<![CDATA[">
2829    
2830    
2831     <!--
2832     The top-level
2833     -->
2834    
2835    
2836     <!--
2837     attributes for the "rfc" element are supplied by the RFC
2838     editor. when preparing drafts, authors should leave them blank.
2839    
2840     the "seriesNo" attribute is used if the category is, e.g., BCP.
2841     -->
2842     <!ELEMENT rfc (front,middle,back?)>
2843     <!ATTLIST rfc
2844     number %NUMBER; #IMPLIED
2845     obsoletes %NUMBERS; ""
2846     updates %NUMBERS; ""
2847     category (std|bcp|info|exp|historic)
2848     "info"
2849     seriesNo %NUMBER; #IMPLIED
2850     ipr (full2026|noDerivativeWorks2026|none)
2851     #IMPLIED
2852     docName %ATEXT; #IMPLIED>
2853    
2854     <!--
2855     Front matter
2856     -->
2857    
2858    
2859     <!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,
2860     abstract?,note*)>
2861    
2862     <!-- the "abbrev" attribute is used for headers, etc. -->
2863     <!ELEMENT title (%CTEXT;)>
2864     <!ATTLIST title
2865     abbrev %ATEXT; #IMPLIED>
2866    
2867     <!ELEMENT author (organization,address?)>
2868     <!ATTLIST author
2869     initials %ATEXT; #IMPLIED
2870     surname %ATEXT; #IMPLIED
2871     fullname %ATEXT; #IMPLIED>
2872    
2873     <!ELEMENT organization
2874     (%CTEXT;)>
2875     <!ATTLIST organization
2876     abbrev %ATEXT; #IMPLIED>
2877    
2878     <!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)>
2879    
2880     <!-- at most one of each the city, region, code, and country
2881     elements may be present -->
2882     <!ELEMENT postal (street+,(city|region|code|country)*)>
2883     <!ELEMENT street (%CTEXT;)>
2884     <!ELEMENT city (%CTEXT;)>
2885     <!ELEMENT region (%CTEXT;)>
2886     <!ELEMENT code (%CTEXT;)>
2887     <!ELEMENT country (%CTEXT;)>
2888     <!ELEMENT phone (%CTEXT;)>
2889     <!ELEMENT facsimile (%CTEXT;)>
2890     <!ELEMENT email (%CTEXT;)>
2891     <!ELEMENT uri (%CTEXT;)>
2892    
2893     <!ELEMENT date EMPTY>
2894     <!ATTLIST date
2895     day %DAY; #IMPLIED
2896     month %MONTH; #REQUIRED
2897     year %YEAR; #REQUIRED>
2898    
2899     <!-- meta-data... -->
2900     <!ELEMENT area (%CTEXT;)>
2901     <!ELEMENT workgroup (%CTEXT;)>
2902     <!ELEMENT keyword (%CTEXT;)>
2903    
2904     <!ELEMENT abstract (t)+>
2905     <!ELEMENT note (t)+>
2906     <!ATTLIST note
2907     title %ATEXT; #REQUIRED>
2908    
2909    
2910     <!--
2911     The body
2912     -->
2913    
2914    
2915     <!ELEMENT middle (section)+>
2916    
2917     <!ELEMENT section (t|figure|section)*>
2918     <!ATTLIST section
2919     anchor ID #IMPLIED
2920     title %ATEXT; #REQUIRED>
2921    
2922     <!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|vspace)*>
2923     <!ATTLIST t
2924     hangText %ATEXT; #IMPLIED>
2925    
2926     <!-- the value of the style attribute is inherited from the closest
2927     parent -->
2928     <!ELEMENT list (t+)>
2929     <!ATTLIST list
2930     style (numbers|symbols|hanging|empty)
2931     "empty">
2932    
2933     <!ELEMENT xref (%CTEXT;)>
2934     <!ATTLIST xref
2935     target IDREF #REQUIRED
2936     pageno (true|false) "false">
2937    
2938     <!ELEMENT eref (%CTEXT;)>
2939     <!ATTLIST eref
2940     target %URI; #REQUIRED>
2941    
2942     <!ELEMENT iref EMPTY>
2943     <!ATTLIST iref
2944     item %ATEXT; #REQUIRED
2945     subitem %ATEXT; "">
2946    
2947     <!ELEMENT vspace EMPTY>
2948     <!ATTLIST vspace
2949     blankLines %NUMBER; "0">
2950    
2951     <!ELEMENT figure (preamble?,artwork,postamble?)>
2952     <!ATTLIST figure
2953     anchor ID #IMPLIED
2954     title %ATEXT; "">
2955    
2956     <!ELEMENT preamble (%TEXT;|xref|eref|iref)*>
2957     <!ELEMENT artwork (%TEXT;)*>
2958     <!ATTLIST artwork
2959     xml:space (default|preserve) "preserve">
2960     <!ELEMENT postamble (%TEXT;|xref|eref|iref)*>
2961    
2962    
2963     <!--
2964     Back matter
2965     -->
2966    
2967    
2968     <!-- sections, if present, are appendices -->
2969     <!ELEMENT back (references?,section*)>
2970    
2971     <!ELEMENT references (reference+)>
2972     <!ELEMENT reference (front,seriesInfo*)>
2973     <!ATTLIST reference
2974     anchor ID #IMPLIED
2975     target %URI; #IMPLIED>
2976     <!ELEMENT seriesInfo EMPTY>
2977     <!ATTLIST seriesInfo
2978     name %ATEXT; #REQUIRED
2979     value %ATEXT; #REQUIRED>
2980     ]]></artwork>
2981     </ja:l>
2982     <ja:l xml:lang="ja">
2983     <artwork><![CDATA[
2984     <!--
2985     RFC $BJ8=q7ONsMQ(B DTD, 99-01-30 $B$N860F(B ($B$NCm<aItJ,OBLu(B)
2986     -->
2987    
2988    
2989     <!--
2990     $BFbMF(B
2991    
2992     DTD $B%G!<%?7?(B
2993    
2994     $B:G>e0L(B
2995    
2996     Front matter
2997    
2998     The Body
2999    
3000     Back matter
3001     -->
3002    
3003    
3004     <!--
3005     DTD $B%G!<%?7?(B:
3006    
3007     $B<BBN(B $B@bL@(B
3008     ====== ===============================================
3009     NUMBER [0-9]+
3010     NUMBERS $BFIE@(B(comma)$B6h@Z$j$N(B NUMBER
3011    
3012     DAY $B7nCf$NF|!"Nc$($P(B "1"
3013     MONTH $BG/Cf$N7n!"Nc$($P(B "January" (1$B7n(B)
3014     YEAR 4$B7eG/9f!"Nc$($P(B "1999"
3015    
3016     URI $BNc(B "http://invisible.net/"
3017    
3018     ATEXT/CTEXT $B0u;z2DG=(B ASCII $BJ8;zNs(B ($B9T=*C<L5$7(B)
3019    
3020     TEXT $BJ8;z%G!<%?(B
3021     -->
3022    
3023    
3024     <!ENTITY % NUMBER "CDATA">
3025     <!ENTITY % NUMBERS "CDATA">
3026    
3027     <!ENTITY % DAY "CDATA">
3028     <!ENTITY % MONTH "CDATA">
3029     <!ENTITY % YEAR "CDATA">
3030    
3031     <!ENTITY % URI "CDATA">
3032    
3033     <!ENTITY % ATEXT "CDATA">
3034     <!ENTITY % CTEXT "#PCDATA">
3035    
3036     <!ENTITY % TEXT "#PCDATA">
3037    
3038     <!ENTITY rfc.number "]]>&rfc.number;<![CDATA[">
3039    
3040    
3041     <!--
3042     $B:G>e0L(B
3043     -->
3044    
3045    
3046     <!--
3047     "rfc" $BMWAG$NB0@-$O(B RFC $BJT=8<T$K$h$jKd$a$i$l$^$9!#(B
3048     $B860F$rMQ0U$9$k:]$K$O!"Cx<T$O6uMs$K$7$F$*$/$Y$-$G$9!#(B
3049    
3050     "seriesNo" $BB0@-$OJ,N`$,Nc$($P(B BCP $B$N;~$K;H$$$^$9!#(B
3051     -->
3052     <!ELEMENT rfc (front,middle,back?)>
3053     <!ATTLIST rfc
3054     number %NUMBER; #IMPLIED
3055     obsoletes %NUMBERS; ""
3056     updates %NUMBERS; ""
3057     category (std|bcp|info|exp|historic)
3058     "info"
3059     seriesNo %NUMBER; #IMPLIED
3060     ipr (full2026|noDerivativeWorks2026|none)
3061     #IMPLIED
3062     docName %ATEXT; #IMPLIED>
3063    
3064     <!--
3065     Front matter
3066     -->
3067    
3068    
3069     <!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,
3070     abstract?,note*)>
3071    
3072     <!-- "abbrev" $BB0@-$OF,$H$+$K;H$$$^$9!#(B -->
3073     <!ELEMENT title (%CTEXT;)>
3074     <!ATTLIST title
3075     abbrev %ATEXT; #IMPLIED>
3076    
3077     <!ELEMENT author (organization,address?)>
3078     <!ATTLIST author
3079     initials %ATEXT; #IMPLIED
3080     surname %ATEXT; #IMPLIED
3081     fullname %ATEXT; #IMPLIED>
3082    
3083     <!ELEMENT organization
3084     (%CTEXT;)>
3085     <!ATTLIST organization
3086     abbrev %ATEXT; #IMPLIED>
3087    
3088     <!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)>
3089    
3090     <!-- city, region, code, country $B3FMWAG$,$;$$$<$$(B1$B2s=P8=2DG=(B -->
3091     <!ELEMENT postal (street+,(city|region|code|country)*)>
3092     <!ELEMENT street (%CTEXT;)>
3093     <!ELEMENT city (%CTEXT;)>
3094     <!ELEMENT region (%CTEXT;)>
3095     <!ELEMENT code (%CTEXT;)>
3096     <!ELEMENT country (%CTEXT;)>
3097     <!ELEMENT phone (%CTEXT;)>
3098     <!ELEMENT facsimile (%CTEXT;)>
3099     <!ELEMENT email (%CTEXT;)>
3100     <!ELEMENT uri (%CTEXT;)>
3101    
3102     <!ELEMENT date EMPTY>
3103     <!ATTLIST date
3104     day %DAY; #IMPLIED
3105     month %MONTH; #REQUIRED
3106     year %YEAR; #REQUIRED>
3107    
3108     <!-- $B%a%?!&%G!<%?!&!&!&(B -->
3109     <!ELEMENT area (%CTEXT;)>
3110     <!ELEMENT workgroup (%CTEXT;)>
3111     <!ELEMENT keyword (%CTEXT;)>
3112    
3113     <!ELEMENT abstract (t)+>
3114     <!ELEMENT note (t)+>
3115     <!ATTLIST note
3116     title %ATEXT; #REQUIRED>
3117    
3118    
3119     <!--
3120     $BK\BN(B
3121     -->
3122    
3123    
3124     <!ELEMENT middle (section)+>
3125    
3126     <!ELEMENT section (t|figure|section)*>
3127     <!ATTLIST section
3128     anchor ID #IMPLIED
3129     title %ATEXT; #REQUIRED>
3130    
3131     <!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|vspace)*>
3132     <!ATTLIST t
3133     hangText %ATEXT; #IMPLIED>
3134    
3135     <!-- style $BB0@-$NCM$OD>6a$N?F$+$i7Q>5$9$k(B -->
3136     <!ELEMENT list (t+)>
3137     <!ATTLIST list
3138     style (numbers|symbols|hanging|empty)
3139     "empty">
3140    
3141     <!ELEMENT xref (%CTEXT;)>
3142     <!ATTLIST xref
3143     target IDREF #REQUIRED
3144     pageno (true|false) "false">
3145    
3146     <!ELEMENT eref (%CTEXT;)>
3147     <!ATTLIST eref
3148     target %URI; #REQUIRED>
3149    
3150     <!ELEMENT iref EMPTY>
3151     <!ATTLIST iref
3152     item %ATEXT; #REQUIRED
3153     subitem %ATEXT; "">
3154    
3155     <!ELEMENT vspace EMPTY>
3156     <!ATTLIST vspace
3157     blankLines %NUMBER; "0">
3158    
3159     <!ELEMENT figure (preamble?,artwork,postamble?)>
3160     <!ATTLIST figure
3161     anchor ID #IMPLIED
3162     title %ATEXT; "">
3163    
3164     <!ELEMENT preamble (%TEXT;|xref|eref|iref)*>
3165     <!ELEMENT artwork (%TEXT;)*>
3166     <!ATTLIST artwork
3167     xml:space (default|preserve) "preserve">
3168     <!ELEMENT postamble (%TEXT;|xref|eref|iref)*>
3169    
3170    
3171     <!--
3172     Back matter
3173     -->
3174    
3175    
3176     <!-- sections $B$,$"$k>l9g!"$=$l$OImB0=q(B -->
3177     <!ELEMENT back (references?,section*)>
3178    
3179     <!ELEMENT references (reference+)>
3180     <!ELEMENT reference (front,seriesInfo*)>
3181     <!ATTLIST reference
3182     anchor ID #IMPLIED
3183     target %URI; #IMPLIED>
3184     <!ELEMENT seriesInfo EMPTY>
3185     <!ATTLIST seriesInfo
3186     name %ATEXT; #REQUIRED
3187     value %ATEXT; #REQUIRED>
3188     ]]></artwork>
3189     </ja:l>
3190     </ja:pair>
3191    
3192     </figure>
3193     </section>
3194     <section title="Acknowledgements">
3195     <t>
3196     <ja:pair>
3197     <ja:l xml:lang="en">The author gratefully acknowledges the contributions of:
3198     Alan Barrett,
3199     Brad Burdick,
3200     Brian Carpenter,
3201     Steve Deering,
3202     Patrik Faltstrom,
3203     Jim Gettys,
3204     Carl Malamud,
3205     Chris Newman,
3206     Kurt Starsinic,
3207     and,
3208     Frank Strauss.</ja:l>
3209     <ja:l xml:lang="ja">$BCx<T$O<!$NJ}!9$N9W8%$K<U0U$rI=$7$^$9(B:
3210     Alan Barrett,
3211     Brad Burdick,
3212     Brian Carpenter,
3213     Steve Deering,
3214     Patrik Faltstrom,
3215     Jim Gettys,
3216     Carl Malamud,
3217     Chris Newman,
3218     Kurt Starsinic,
3219     Frank Strauss$B!#(B</ja:l>
3220     </ja:pair>
3221     </t>
3222     </section>
3223     </back>
3224     <ja:back>
3225     <section anchor="ja.note.mydtd" title="$B$3$NK]LuJ8$N7A<0$K$D$$$F(B">
3226     <t>$B$3$NJ8=q(B ($B$N86K\(B) $B$O!"(B RFC 2629
3227     $B$GDj5A$5$l$?7A<0$K!"K]LuJ8MQ$NMWAG$r(B XML
3228     $BL>A06u4V$r;H$C$FDI2C$7$FMQ$$$F$$$^$9!#>\$7$/$O!"(B
3229 wakaba 1.2 <ja:uri-ref target="http://suika.fam.cx/~wakaba/lang/rfc/translation/" />
3230 wakaba 1.1 $B$r8fMw2<$5$$!#(B</t>
3231     </section>
3232     </ja:back>
3233     </rfc>

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24