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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (show annotations) (download) (as text)
Fri May 3 06:21:01 2002 UTC (22 years ago) by wakaba
Branch: MAIN
CVS Tags: HEAD
Changes since 1.1: +1 -1 lines
File MIME type: text/xml
FILE REMOVED
*** empty log message ***

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

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24