/[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.5 - (show annotations) (download)
Sat Sep 13 08:57:55 2003 UTC (20 years, 7 months ago) by wakaba
Branch: MAIN
CVS Tags: HEAD
Changes since 1.4: +2 -2 lines
Some markup fixes to be valid

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

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24