--- doc/rfc-ja/rfc2629-ja.html 2002/05/03 07:29:27 1.4 +++ doc/rfc-ja/rfc2629-ja.html 2002/05/03 07:41:04 1.5 @@ -1,14 +1,16 @@ -
+
- <ja:pair>
-
This memo presents a technique for using XML
(Extensible Markup Language)
as a source format for documents in the Internet-Drafts (I-Ds)
and Request for Comments (RFC) series.
-
-</ja:l>
- <ja:l>
-
このメモは、 XML (拡張マーク付け言語) を Internet-Draft (I-D)
や Request for Comments (RFC) 系列の文書の原形式として使用する手法を説明します。
-
-</ja:l>
-
-</ja:pair>
-
This memo describes how to write a document for the I-D and
RFC series using
the Extensible Markup
@@ -121,49 +118,35 @@
[1]
(XML). This memo has three goals:
-
-</ja:l>
- <ja:l>
-
このメモは、 I-D および RFC - 系列の文書を -拡張マーク付け言語 + 系列の文書を拡張マーク付け言語 [1] - - (XML) + (XML) を使って書く方法を説明します。このメモには、三つの目的があります。 - -</ja:l> - -</ja:pair> +
+
To describe a simple XML Document Type Definition (DTD) that is
powerful enough to handle the simple formatting requirements of RFC-like
documents whilst allowing for meaningful markup of descriptive
qualities.
-
-</ja:l>
- <ja:l>
-
意味マーク付けの記述品質が可能な RFC 型文書の単純な書式づけ要件を取り扱うのに十分強力である XML 文書型定義 (DTD) の説明 - -</ja:l> - -</ja:pair> +
+
To describe software that processes XML source files,
including a tool that produces documents
conforming to
@@ -172,331 +155,239 @@
,
HTML format, and so on.
-
-</ja:l>
- <ja:l>
-
+ RFC 2223 [2] - - に適合する文書, + に適合する文書, HTML 形式, その他を生成する道具を含む、 XML 源ファイルを処理するソフトウェアの説明 - -</ja:l> - -</ja:pair> +
+
To provide the proof-of-concept for the first two goals
(this memo was written using this DTD and produced using that
software).
-
-</ja:l>
- <ja:l>
-
前述の2つの目的の概念の証明の提供 (このメモはその DTD を使って執筆され、そうしたソフトウェアを使って生成されました。) - -</ja:l> - -</ja:pair> +
+
It is beyond the scope of this memo to discuss the political
ramifications of using XML as a source format for RFC-like documents.
Rather,
it is simply noted that adding minimal markup to plain text:
-
-</ja:l>
- <ja:l>
-
RFC 的文書の源形式として XML を使うことの政治的議論はこのメモの適用範囲外です。それよりも、平文 (plain text) に最小のマーク付けを加えることで、 - -</ja:l> - -</ja:pair> +
+
allows the traditional production of textual RFC-like documents using
familiar editors;
-
-</ja:l>
- <ja:l>
-
よく知られているエディターを使って文字な RFC 的文書の伝統的生成が可能になる - -</ja:l> - -</ja:pair> +
+
requires some, albeit minimal, additions to existing software
environments; and,
-
-</ja:l>
- <ja:l>
-
幾つか、最低でも、既存のソフトウェア環境に追加が必要である - -</ja:l> - -</ja:pair> +
+
permits information to be organized, searched, and retrieved
using both unstructured and structured mechanisms.
-
-</ja:l>
- <ja:l>
-
非構造化・構造化の両機構を使って情報を組織化したり検索したり取り出したり出来る - -</ja:l> - -</ja:pair> +
+ということを単に記すものです。 - -</ja:l> - -</ja:pair> +
+
- <ja:pair>
-
We do not provide a formal or comprehensive description of XML.
Rather,
this section discusses just enough XML to use a Document Type
Declaration (DTD) to write RFC-like documents.
-
-</ja:l>
- <ja:l>
-
XML についての正式な、あるいは包括的な説明はしません。
この節では、 RFC 的文書を書くための文書型宣言 (DTD)
を使うのに必要なだけの話をします。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
If you're already familiar with XML,
skip to
section 2
to look at the DTD.
-
-</ja:l>
- <ja:l>
-
+ XML について既によく分かっているなら、
+ 附属書Bに飛んで、 DTD を御覧下さい。
+
There are very few rules when writing in XML,
as the syntax is simple.
There are five terms you'll need to know:
-
-</ja:l>
- <ja:l>
-
XML は構文が簡単なので、書く時に必要なのはほんの少しの規則だけです。知っておくべきことは5つあります。
-
-</ja:l>
-
-</ja:pair>
+
An “element” usually refers to a start tag, an end tag, and all the
characters in between,
e.g.,
"<example>text and/or nested elements</example>"
-
-</ja:l>
- <ja:l>
-
「要素」は通常開始タグと終了タグ、それに間の全ての文字、例えば
「<例>文字とか入れ子の要素</例>」
を指します。
-
-</ja:l>
-
-</ja:pair>
+
An "empty element" combines the start tag and the end tag,
e.g.,
"<empty/>".
You don't find these in HTML.
-
-</ja:l>
- <ja:l>
-
「空要素」は開始タグと終了タグがくっついて、
「<空/>」 のようになります。
HTML にはこれはありません。
-
-</ja:l>
-
-</ja:pair>
+
An "attribute" is part of an element.
If present, they occur in the start tag, e.g.,
"<example name='value'>".
Of course,
they can also appear in empty elements, e.g.,
"<empty name='value'/>".
-
-</ja:l>
- <ja:l>
-
「属性」は要素の一部です。存在する場合、開始タグ中に、
「<例 名前='値'>」
の様に現れます。もちろん、空要素中でも
「<空 名前='値'/>」 の様に使えます。
-
-</ja:l>
-
-</ja:pair>
+
An "entity" is a textual macro that starts with "&".
Don't worry about these,
you'll only use them whenever you want to put a "&" or a "<" in
your text.
-
-</ja:l>
- <ja:l>
-
「実体」は文字マクロで、「&」で始まります。
な〜に心配しなさんな、「&」や「<」を文中に入れたい時にだけいつでも使うことが出来ます。
-
-</ja:l>
-
-</ja:pair>
+
A "token" is a string of characters.
The first character is either a letter or an underscore ("_").
Any characters that follow are either letters, numbers, an
underscore, or a period (".").
-
-</ja:l>
- <ja:l>
-
「字句 (token)」 は文字の列です。最初の文字は文字か下線 (「_」)
です。その後の文字は文字、数字、下線、句点 (「.」) です。
- <ja:note>
-
First,
start your source file with an XML declaration,
a reference to the DTD,
and the "rfc" element:
-
-</ja:l>
- <ja:l>
-
最初に、源ファイルは XML 宣言, DTD への参照, 「rfc」要素で始めます。
-
-</ja:l>
-
-</ja:pair>
+
Ignore the first two lines
―― the declaration and the reference ――
and simply treat them as opaque strings.
Nothing else should be present after the "</rfc>" tag.
-
-</ja:l>
- <ja:l>
-
最初の2行 (宣言と参照) は無視し、単に呪文だと思って下さい。
「</rfc>」タグの後には何も現れるべきではありません。
- <ja:note>
-
- <ja:pair>
-
Second,
make sure that all elements are properly matched and nested.
A properly matched element that starts with
"<example>" is eventually followed with "</example>".
(Empty elements are always matched.)
Elements are properly nested when they don't overlap.
-
-</ja:l>
- <ja:l>
-
二番目に、全ての要素が適切に対応・入れ子になっているか確かめて下さい。
「<例>」 で始まる適切に対応する要素は、最終的には
「</例>」 が続くことになります。
(空要素は常に対応しています。)
各要素は重複していない時で適切に入れ子になっています。
-
-</ja:l>
-
-</ja:pair>
-
For example,
-
-</ja:l>
- <ja:l>
-
例えば、
-
-</ja:l>
-
-</ja:pair>
+
is properly nested.
-
-</ja:l>
- <ja:l>
-
は適切に入り組んでいます。
-
-</ja:l>
-
-</ja:pair>
+
However,
-
-</ja:l>
- <ja:l>
-
しかし、
-
-</ja:l>
-
-</ja:pair>
+
overlaps, so the elements aren't properly nested.
-
-</ja:l>
- <ja:l>
-
は重なっているので、要素は正しく入れ子になっていません。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
Third,
never use "<" or "&" in your text.
Instead, use either "<" or "&", respectively.
-
-</ja:l>
- <ja:l>
-
三番目に、「<」や「&」を文中に使ってはいけません。代わりに、それぞれ「<」と「&」を使います。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
Fourth,
there are two quoting characters in XML, 'apostrophe' and "quotation".
Make sure that all attributes values are quoted,
@@ -680,10 +525,8 @@
and replace occurrances of that character in the attribute value with
either ''' (apostrophe) or """ (quotation),
e.g., "<example name='"'"'>".
-
-</ja:l>
- <ja:l>
-
四番目に、 XML では 'アポストロフィ' と "引用"
の二種類の引用文字があります。全ての属性値を、
「6lt;例 名前='値'>」 の様に引用符で囲むことを確認して下さい。値に引用文字の一方が使われている時は、
@@ -691,75 +534,55 @@
値が引用文字の両方を含んでいる場合、どちらかを値を囲むのに使い、属性値に使われている文字を ''' (アポストロフィ) または """
(引用) に置き換えて、 「<例 名前='"'"'>"」
のようにします。
-
-</ja:l>
-
-</ja:pair>
-
If you want to put a comment in your source file,
here's the syntax:
-
-</ja:l>
- <ja:l>
-
源ファイルに注釈を入れたい時は、次の構文の様にします。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
Finally,
XML is case sensitive.
-
-</ja:l>
- <ja:l>
-
五番目に、 XML は大文字と小文字を区別します。
-
-</ja:l>
-
-</ja:pair>
-2. Using the DTD to Write I-Ds and RFCs
+2.
+ I-D や RFC を書くのに DTD を使う
+2.1. XML basics
+2.1. XML basics
+2.1.
+ XML の基礎
<?xml version="1.0"?>
@@ -506,74 +397,54 @@
</rfc>
<outer>
@@ -585,39 +456,27 @@
</outer>
<outer>
@@ -629,45 +488,31 @@
</inner>
<!-- comments can be multiline,
if you wish -->
-
-</ja:l>
- <ja:l>
-
<!-- 注釈行は、必要なら
複数行に出来ます。 -->
Immediately following the "<rfc>" tag is the "front"
element:
-
-</ja:l>
- <ja:l>
-
"<rfc>" タグの直ぐ後に続くのは "front" 要素です。 - -</ja:l> - -</ja:pair> +
+<?xml version="1.0"?> @@ -805,28 +622,20 @@ </rfc>
(Note that in all examples,
indentation is used only for expository purposes.)
-
-</ja:l>
- <ja:l>
-
(全ての例で、字下げは説明のためだけに使っていることに注意して下さい。) - -</ja:l> - -</ja:pair> +
+
- <ja:pair>
-
The "front" element consists of a "title" element,
one or more "author" elements,
a "date" element,
@@ -836,32 +645,28 @@
an optional "abstract" element.
and,
one or more optional "note" elements.
-
-</ja:l>
- <ja:l>
-
"front" 要素は "title" 要素, 1つ以上の "author" 要素, "date" 要素,
1つ以上の省略可能な "area" 要素,
1つ以上の省略可能な "workgroup" 要素,
1つ以上の省略可能な "keyword" 要素,
省略可能な "abstract" 要素,
1つ以上の省略可能な "note" 要素から成ります。
-
-</ja:l>
-
-</ja:pair>
-
The "title" element identifies the title of the document.
Because the title will be used in the headers of the document when formatted
according to
@@ -870,18 +675,12 @@
if the title is more than 42 characters,
then an abbreviation should also be provided,
e.g.,
-
-</ja:l>
- <ja:l>
-
"title" 要素は、文書の題を識別します。題は
-
-[2]
- に従って整形する時に文書の頭に使われるので、題は42文字以上の時は、省略形も与えるべきです。例えば、次のようにします。
-
-</ja:l>
-
-</ja:pair>
+ [2] に従って整形する時に文書の頭に使われるので、題は42文字以上の時は、省略形も与えるべきです。例えば、次のようにします。
+
The "date" element identifies the publication date of the
document.
It consists of a month and a year, e.g.,
-
-</ja:l>
- <ja:l>
-
"date" 要素は文書の出版の日付を示します。次のように月と年から成ります。
-
-</ja:l>
-
-</ja:pair>
+
The "date" element also has an optional day attribute.
-
-</ja:l>
- <ja:l>
-
"date" 要素には省略可能な day 属性もあります。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
The "front" element may contain meta data ――
the content of these elements does not appear in printed versions of
the document.
-
-</ja:l>
- <ja:l>
-
"front" 要素はメタ・データ (内容は文書の印刷版には出現しないもの) も含むことが出来ます。
-
-</ja:l>
-
-</ja:pair>
-
A document has one or more optional "area",
"workgroup" and "keyword" elements, e.g.,
-
-</ja:l>
- <ja:l>
-
文書は1つ以上の省略可能な "area", "workgroup", "keyword"
各要素を次の例の様に持ちます。
-
-</ja:l>
-
-</ja:pair>
+
The "area" elements identify a general category for the
document
(e.g., one of "Applications", "General", "Internet", "Management",
@@ -1199,34 +936,30 @@
while the "workgroup" elements identify the IETF working groups that
produced the document,
and the "keyword" elements identify useful search terms.
-
-</ja:l>
- <ja:l>
-
"area" 要素は文書の一般分類 ("Applications" (応用),
"General" (一般), "Internet", "Management" (経営),
"Operations" (作業), "Routing" (経路), "Security" (保安),
"Transport" (輸送), "User" (利用者)) を示し、
"workgroup" 要素は文書を出した IETF 作業部会を示し、
"keyword" 要素は有用な検索語を示します。
-
-</ja:l>
-
-</ja:pair>
+
A document may have an "abstract" element,
which contains one or more
"t" elements
@@ -1234,24 +967,16 @@
In general,
only a single "t" element is present,
e.g.,
-
-</ja:l>
- <ja:l>
-
文書には "abstract" 要素を使うことが出来て、
- それには1つ以上の
-"t" 要素
-が含められます。通常、次の例の様に、 "t" 要素を1つだけ使います。
-
-</ja:l>
-
-</ja:pair>
+ それには1つ以上の "t" 要素が含められます。通常、次の例の様に、 "t" 要素を1つだけ使います。
+
A document may have one or more "note" elements,
each of which contains one or more
"t" elements
@@ -1297,242 +1018,172 @@
In general,
the "note" element contains text from the IESG,
e.g.,
-
-</ja:l>
- <ja:l>
-
文書には1つ以上の "note" 要素を使うことが出来て、
- それぞれ1つ以上の
-"t" 要素
-が含められます。必須の
+ それぞれ1つ以上の "t" 要素が含められます。必須の
"title" 属性があります。通常、 "note" 要素は IESG
からの文を次の例の様に入れます。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
Note that text relating to the memo's status, copyright notice, or
table of contents is not included in the document's markup ―― this is
automatically inserted by an XML application when it produces either
a text or HTML version of the document.
-
-</ja:l>
- <ja:l>
-
メモの位置付けを説明する文章, 著作権表示,
目次は文書のマーク付けには含めません。これは XML
応用が文書の text 版や HTML 版を生成する時に自動的に挿入されます。
-
-</ja:l>
-
-</ja:pair>
-
If an Internet-Draft is being produced,
then the "ipr" attribute should be present in the "<rfc>"
tag at the beginning of the file.
The value of the attribute should be one of:
-
-</ja:l>
- <ja:l>
-
Internet-Draft が生成される場合に、 "ipr" 属性がファイルのはじめの
"<rfc>"タグに現れるべきです。この属性の値は次のいずれかであるべきです。
-
-</ja:l>
-
-</ja:pair>
+
indicating that the document is in full
conformance with all the provisions of Section 10 of RFC 2026 except that the
right to produce derivative works is not granted; or,
-
-</ja:l>
- <ja:l>
-
文書が、派生的作業の生成が認められていないことを除いて、
- <ja:link>
-
indicating that the document is NOT offered in accordance with
Section 10 of RFC 2026, and the author does not provide the IETF with any rights
other than to publish as an Internet-Draft.
-
-</ja:l>
- <ja:l>
-
文書が
- <ja:link>
-
In the latter case,
a copyright notice will not be automatically inserted during
processing by an XML application.
-
-</ja:l>
- <ja:l>
-
後者の場合では、著作権表示は XML 応用により自動的には挿入されません。
- <ja:note>
-
- <ja:pair>
-
Finally,
if the Internet-Draft is being submitted to an automated process,
then the "docName" attribute should be present in the "<rfc>"
tag at the beginning of the file.
The value of this attribute contains the document (not file) name
associated with this Internet-Draft, e.g.,
-
-</ja:l>
- <ja:l>
-
最後に、 Internet-Draft が自動処理に回された時は、 "docName"
属性がファイルのはじめの "<rfc>" タグ中に出現するべきです。
この属性の値は Internet-Draft につけられた文書 (ファイルでなしに)
の名前で、次の様になります。
-
-</ja:l>
-
-</ja:pair>
+
So,
putting it all together, we have, e.g.,
-
-</ja:l>
- <ja:l>
-
以上をまとめると次の様になります。
-
-</ja:l>
-
-</ja:pair>
+
+
+
The "middle" element contains all the sections of the document
except for the bibliography and appendices:
-
-</ja:l>
- <ja:l>
-
"middle" 要素は参考文献と附属書を除く文書の全ての節から成ります。
-
-</ja:l>
-
-</ja:pair>
+
The "middle" element consists of one or more "section"
elements.
-
-</ja:l>
- <ja:l>
-
"middle" 要素は1つ以上の "section" 要素から成ります。
-
-</ja:l>
-
-</ja:pair>
+
Each "section" element contains a section of the document.
There is a mandatory attribute,
"title",
@@ -1737,20 +1368,14 @@
the "xref" element
,
e.g.,
-
-</ja:l>
- <ja:l>
-
各 "section" 要素は文書の節から成ります。必須の属性 "title"
は節の題を表します。省略可能の属性 "anchor" は
-
-"xref" 要素
-による交差参照に使います。
+ "xref" 要素による交差参照に使います。
次の例を御覧下さい。
-
-</ja:l>
-
-</ja:pair>
+
The "section" element is recursive ――
each contains any number and combination of "t", "figure", and "section"
elements, e.g.,
-
-</ja:l>
- <ja:l>
-
"section" 要素は再帰的で、各々任意の数・組合せで "t",
"figure", "section" 各要素を次の例の如く使います。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
The "t" element contains any number and combination of
paragraphs, lists, and figures.
If a cross-reference is needed to a section, figure, or reference,
@@ -1818,56 +1437,40 @@
the "iref" element
.
-
-</ja:l>
- <ja:l>
-
+ "t" 要素は任意の数・組合せの段落・一覧・図から成ります。節・図・参考文献への交差参照が必要なら、 "xref" 要素
+ を使います。同様に外部参照が必要なら、 "eref"
+ 要素を使います。文章の索引付けには "iref"
+ 要素を使います。
+
The "list" element contains one or more items.
Each item is a "t" element,
allowing for recursion, e.g.,
-
-</ja:l>
- <ja:l>
-
"list" 要素は1つ以上の項目から成ります。各項目は
"t" 要素で、繰り返し可能です。例を御覧あれ:
-
-</ja:l>
-
-</ja:pair>
+
The "list" element has an optional attribute,
"style",
having the value "numbers" (for numeric lists),
@@ -1916,46 +1513,34 @@
otherwise,
the default value is "empty".
-
-</ja:l>
- <ja:l>
-
"list" 要素は省略可能な "style" 属性があって、 "numbers"
(番号つき一覧), "symbols" (記号つき一覧), "hanging" (ぶら下がり一覧),
"empty" (字下げ文) のいずれかの値を取ることが出来ます。
"list" 要素が入れ子になっている時、既定値は一番近い親から取られます。そうでない時は、既定値は "empty" です。
-
-</ja:l>
-
-</ja:pair>
+
When nested within a "hanging list" element,
the "t" element has an optional attribute,
"hangText" that specifies the text to be inserted, e.g.,
-
-</ja:l>
- <ja:l>
-
「ぶら下がり一覧」 要素中で入れ子になっている時、
"t" 要素は省略可能な属性 "hangText" を持ち、挿入される文字列を指定します。次の例を参照して下さい。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
The "figure" element groups an optional "preamble" element,
an "artwork" element,
and an optional "postamble" element together.
@@ -2020,27 +1601,19 @@
There is also an optional "title" attribute that identifies the title
of the figure.
-
-</ja:l>
- <ja:l>
-
"figure" 要素は省略可能な "preamble" 要素,
"artwork" 要素, 省略可能な "postable" 要素をひとまとめにします。
"figure" 要素は省略可能な "anchor" 属性も持っていて、
-
-"xref" 要素
-による交差参照に使うことが出来ます。
+ "xref" 要素による交差参照に使うことが出来ます。
省略可能な "title" 属性というのもあって、図の題を示します。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The "preamble" and "postamble" elements,
if present,
are simply text.
@@ -2057,74 +1630,50 @@
the "iref" element
.
-
-</ja:l>
- <ja:l>
-
"preamble" ・ "postamble" 両要素は、存在する場合、単純な文字列です。
節・図・参考文献への交差参照が必要な場合は、
-
-"xref"
- 要素
-を使います。同様に、外部参照が必要なら、
-
-"eref" 要素
-を使います。文章の索引付けには
-
-"iref" 要素
-を使います。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The "artwork" element,
which must be present,
contains "ASCII artwork".
Unlike text contained in the "t", "preamble", or "postamble" elements,
both horizontal and vertical whitespace is significant in the "artwork"
element.
-
-</ja:l>
- <ja:l>
-
"artwork" 要素は、必ず存在しなければならず、「ASCII 絵」から成ります。
"t", "preamble", "postamble" 各要素中の文字列とは違って、水平・垂直どちらの空白間隔も
"artwork" 要素中では意味を持ちます。
-
-</ja:l>
-
-</ja:pair>
-
So,
putting it all together, we have, e.g.,
-
-</ja:l>
- <ja:l>
-
ということで、全てまとめると、次の例の様になります。
-
-</ja:l>
-
-</ja:pair>
+
which is a very simple example.
-
-</ja:l>
- <ja:l>
-
非常に単純な例でした。
-
-</ja:l>
-
-</ja:pair>
+
If you have artwork with a lot of "<" characters,
then there's an XML trick you can use:
-
-</ja:l>
- <ja:l>
-
沢山の "<" 文字が絵の中にある場合は、このような
XML 魔法を使うことが出来ます。
-
-</ja:l>
-
-</ja:pair>
+
The "<![CDATA[ ... ]]>" construct is called a CDATA
block ―― everything between the innermost brackets is left alone by
the XML application.
-
-</ja:l>
- <ja:l>
-
「<![CDATA[ ... ]]>」 構造は CDATA
塊と呼ばれます。一番内側の括弧の間のものは全て XML 応用に干渉されません。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
Because the "figure" element represents a logical grouping of text
and artwork,
an XML application producing a text version of the document should
@@ -2277,56 +1796,44 @@
characters by 49 lines of content on each page,
XML applications should be prepared to prematurely introduce page
breaks to allow for better visual grouping.
-
-</ja:l>
- <ja:l>
-
"figure" 要素は文書と絵の論理的な集合を表現するので、文書の
text 版を生成する XML 応用は各要素を同一頁中に入れるように策するべきです。
-
-RFC 2223
+ RFC 2223
[2]
-
-
+
が各頁49行の内容で, 69文字を超えるのを認めていないので、
XML 応用はより良い視覚的集合化を行うために予め改頁する準備をしておくべきです。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
Finally,
the "artwork" element has two optional attributes:
"name" and "type".
The former is used to suggest a filename to use when storing the
content of the "artwork" element,
whilst the latter contains a suggestive data-typing for the content.
-
-</ja:l>
- <ja:l>
-
最後に、 "artwork" 要素は2つの省略可能な属性 "name", "type"
を持ちます。前者は "artwork" 要素の内容を保管する時に使うファイル名の案を推すのに使います。後者は内容のデータ型を示すのに使います。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The "xref" element is used to cross-reference sections, figures, and
references.
The mandatory "target" attribute is used to link back to the "anchor"
@@ -2336,127 +1843,88 @@
section 2.1
.
-
-</ja:l>
- <ja:l>
-
"xref" 要素は節・図・参考文献の交差参照に使います。必須の
"target" 属性は "section", "figure", "reference" 要素の
"anchor" 属性に逆接続するのに使います。
- "anchor" および "target" 両属性の値は
-
- section 2.1
-
+ "anchor" および "target" 両属性の値は 2.1節
の字句 (token) 構文に従い書式化されるべきです。
-
-</ja:l>
-
-</ja:pair>
-
If used as an empty element,
e.g.,
-
-</ja:l>
- <ja:l>
-
空要素として使う時は
-
-</ja:l>
-
-</ja:pair>
+
then the XML application inserts an appropriate phrase
during processing,
such as "Section 2.1" or
"<a href="#xml_basics">XML Basics</a>".
-
-</ja:l>
- <ja:l>
-
の様になり、 XML 応用は 「2.1 節」 や
「<a href="#xml_basics">XML の基礎</a>」
のように適切な文字列を処理により挿入します。
-
-</ja:l>
-
-</ja:pair>
+
If used with content, e.g.,
-
-</ja:l>
- <ja:l>
-
内容ありで使う時は
-
-</ja:l>
-
-</ja:pair>
+
then the XML application inserts an appropriate
designation during processing,
such as "RFC 2223[2]" or
@@ -2464,33 +1932,29 @@
Although the XML application decides what "an appropriate designation"
might be,
its choice is consistent throughout the processing of the document.
-
-</ja:l>
- <ja:l>
-
の様になり、 XML 応用は 「RFC 2223[2]」 や
「<a href="#refs.RFC2223">RFC 2223</a>」
のように適切な指示を処理により挿入します。「適切な指示」の内容は
XML 応用が決めますが、選択は当該文書の処理を通じて固定です。
-
-</ja:l>
-
-</ja:pair>
+
The "eref" element is used to reference external documents.
The mandatory "target" attribute is a
@@ -2498,21 +1962,15 @@
[4]
, e.g.,
-
-</ja:l>
- <ja:l>
-
"eref" 要素は、外部文書を参照するのに使います。必須の
- "target" 属性は
-URI
+ "target" 属性は URI
[4]
-
で、次の様に使います。
-
-</ja:l>
-
-</ja:pair>
+
Note that while the "target" attribute is always present,
the "eref" element may be empty, e.g.,
-
-</ja:l>
- <ja:l>
-
"target" 属性は常に必要であり、 "eref" 要素は空であり得ることに注意して下さい。
-
-</ja:l>
-
-</ja:pair>
+
and the XML application inserts an appropriate designation during
processing such as "[9]" or
"<a href="http://invisible.net/">http://invisible.net/</a>".
-
-</ja:l>
- <ja:l>
-
XML 応用は 「[9]」 や
「<a href="http://invisible.net/">http://invisible.net/</a>」
の様に適切な指示を処理の過程で挿入します。
-
-</ja:l>
-
-</ja:pair>
+
The "iref" element
is used to add information to an index.
The mandatory "item" attribute is the primary key the information is stored
under,
whilst the optional "subitem" attribute is the secondary key, e.g.,
-
-</ja:l>
- <ja:l>
-
"iref"
要素は索引に情報を追加するのに使います。必須の属性 "item"
は情報が保管される主鍵で、省略可能な "subitem" 属性は副鍵です。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
Finally, note that the "iref" element is always empty ―― it never
contains any text.
-
-</ja:l>
- <ja:l>
-
最後に、 "iref"
要素は常に空である――どんな文字列も含まないということに注意して下さい。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The "vspace" element,
which may occur only inside the "t" element,
is used by the author to provide formatting guidance to the XML
@@ -2647,44 +2077,32 @@
"blankLines",
that indicates the number of blank lines that should be inserted.
A physical linebreak is specified by using the default value, "0".
-
-</ja:l>
- <ja:l>
-
"vspace" 要素は、 "t" 要素の中にのみ現れることが出来て、著者が
XML 応用に整形の手引きを与えるのに使います。 "blankLines"
属性があり、挿入されるべき空白行の数を示します。物理改行は既定値である
"0" を使って表します。
-
-</ja:l>
-
-</ja:pair>
-
In addition,
the "vspace" element can be used to force a new physical paragraph
within a list item, e.g.,
-
-</ja:l>
- <ja:l>
-
加えて、 "vspace" 要素は次に例示するように、新しい形式段落を一覧項目中に作り出すのに使うことが出来ます。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
An XML application producing a text version of the document should
exercise care when encountering a value for "blankLines" that causes a
pagebreak ――
@@ -2725,36 +2137,26 @@
then no further blank lines should be inserted.
This allows authors to "force" a pagebreak by using an arbitrarily
large value, e.g., "blankLines='100'".
-
-</ja:l>
- <ja:l>
-
文書の text 版を生成する XML 応用は、改頁を起こすような
"breakLines" の値であった時に注意するべきです。
"vspace" 要素が改頁を起こす時は、それ以上空白行を挿入するべきではありません。これにより、著者は任意の大きな値、例えば
「blankLines='100'」 で「強制」改頁させることが出来ます。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
Finally, note that the "vspace" element is always empty ―― it never
contains any text.
-
-</ja:l>
- <ja:l>
-
最後に、 "vspace" 要素は常に空である――文字列を含まないということに注意して下さい。
-
-</ja:l>
-
-</ja:pair>
-
Finally,
the "back" element is used for references and
appendices:
-
-</ja:l>
- <ja:l>
-
最後に、 "back" 要素は参考文献と附属書に使います。
-
-</ja:l>
-
-</ja:pair>
+
The "back" element consists of an optional "references" element,
and,
one or more optional "section" elements.
The "back" element itself is optional,
if your document doesn't have any references or appendices,
you don't have to include it.
-
-</ja:l>
- <ja:l>
-
"back" 要素は省略可能な "references" 要素と、1つ以上の省略可能な
"section" 要素から成ります。 "back" 要素自体は省略可能で、文書に参考文献も附属書もない場合は、含める必要はありません。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
The "references" element contains the document's bibliography.
It contains one or more "reference" elements.
-
-</ja:l>
- <ja:l>
-
"references" 要素は文書の参考文献から成ります。1つ以上の
"reference" 要素から成ります。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
Each "reference" element contains a "front" element and one or more
optional "seriesInfo" elements.
-
-</ja:l>
- <ja:l>
-
各 "references" 要素は "front" 要素と1つ以上の省略可能な
"seriesInfo" 要素から成ります。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
We've already discussed the "front" element back in
section 2.2
.
-
-</ja:l>
- <ja:l>
-
+ "front" 要素については 2.2節
で既に話しました。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The "seriesInfo" element has two attributes,
"name" and "value" that identify the document series and series entry,
respectively.
-
-</ja:l>
- <ja:l>
-
"seriesInfo" 要素は "name", "value" の2つの属性を持ち、それぞれ文書系列と系列項目を特定します。
-
-</ja:l>
-
-</ja:pair>
-
The "reference" element has an optional "anchor"
attribute that is used for cross-referencing with
the "xref" element
, e.g.,
-
-</ja:l>
- <ja:l>
-
"reference" 要素は省略可能な "anchor" 属性を持ち、
- 次の様に使い、
-"xref" 要素
-で交差参照に使うことが出来ます。
-
-</ja:l>
-
-</ja:pair>
+ 次の様に使い、 "xref" 要素で交差参照に使うことが出来ます。
+
- <ja:pair>
-
The "reference" element also has an optional "target"
attribute that is used for external references
(c.f.,
@@ -2962,34 +2317,27 @@
then the XML application should automatically provide an appropriate
default for the "target" attribute
(e.g., "http://example.com/rfcs/rfc2200.txt").
-
-</ja:l>
- <ja:l>
-
"reference" 要素には省略可能な "target" 属性があり、外部参照に使います。
- (cf.
-
- section 2.3.1.5
-) XML 応用は文書の HTML 版を生成する時に
+ (cf. 2.3.1.5節) XML 応用は文書の HTML 版を生成する時に
"target" 属性を使います。しかし、 "seriseInfo" 要素の "name"
属性が値 "RFC" を持つ場合、 XML 応用は自動的に適切な "target"
属性の既定値を用意するべきです。 (例えば
「http://example.com/rfcs/rfc2200.txt」)
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
To include appendices after the bibliography,
simply add more "section" elements.
(For an example,
@@ -2997,82 +2345,65 @@
section 2.4
.)
-
-</ja:l>
- <ja:l>
-
参考文献の後に附属書を含めるには、単に "section"
- 要素を追加するだけです。 (例として、
-
- section 2.4
-
+ 要素を追加するだけです。 (例として、 2.4節
のはじめの例を御覧下さい。)
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The copyright status for the document is not included in the
document's markup ―― this is automatically inserted by an XML
application that produces either a text or HTML version of the document.
-
-</ja:l>
- <ja:l>
-
文書の著作権状態は文書のマーク付けには含めません。
これは文書の text 版か HTML 版を生成する XML
応用により自動的に挿入されます。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
This section concerns itself with applications that operate on
an XML source file.
A lot of XML tools are available,
as are many lists of XML resources,
e.g.,
Cafe con Leche.
-
-</ja:l>
- <ja:l>
-
この節は XML 源ファイルを処理する応用についてです。沢山の
XML 工具が利用可能ですし、沢山の XML 資源の一覧も、例えば
Cafe con Leche
にあります。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
There are two kinds of XML tools: validating and non-validating.
Both check that the source file conforms to the rules given in
@@ -3084,87 +2415,62 @@
a validating tool also reads the DTD referenced by the source file
to make sure that they match.
There are a number of both validating and non-validating tools available.
-
-</ja:l>
- <ja:l>
-
XML 工具には2種類あります: 検証するものと検証しないものです。両者共に、源ファイルが
-
-
- section 2.1
- に挙げた規則に適合するかは確認します。しかし、加えて源ファイルが整形式であるかを確認するため、検証工具は現ファイルが参照している
+ 2.1節 に挙げた規則に適合するかは確認します。しかし、加えて源ファイルが整形式であるかを確認するため、検証工具は現ファイルが参照している
DTD も読んで一致しているか確認します。検証・非検証工具共に多数入手出来ます。
-
-</ja:l>
-
-</ja:pair>
-
There are several XML editors available.
Ideally,
you want an editor that validates.
This has two advantages:
-
-</ja:l>
- <ja:l>
-
XML エディターは幾つか入手可能です。理想的には、検証出来るエディターが良いでしょう。これには2つの利点があります。
-
-</ja:l>
-
-</ja:pair>
+
the editor provides guidance in fleshing-out the document structure;
and,
-
-</ja:l>
- <ja:l>
-
エディターが文書構造に肉付けする手引きを示す
-
-</ja:l>
-
-</ja:pair>
+
the editor validates that the source file matches the rules in the DTD.
-
-</ja:l>
- <ja:l>
-
エディターが源ファイルが DTD の規則と一致しているか検証する
-
-</ja:l>
-
-</ja:pair>
+
There are two major modes in Emacs that support XML:
tdtd and
psgml.
@@ -3174,10 +2480,8 @@
"SGML" or "XML",
then usually all it takes is adding these lines to your ".emacs"
file:
-
-</ja:l>
- <ja:l>
-
Emacs では XML に対応した2つの大モード、
tdtd と
psgml
@@ -3185,113 +2489,89 @@
(外部プログラムを呼び出すことにより) 検証することが出来ます。源ファイルを
Emacs でみて、大モードが 「SGML」 か 「XML」
にならない場合、通常は ".emacs" ファイルに次の行
-
-</ja:l>
-
-</ja:pair>
+
and then restarting Emacs.
If this doesn't work,
try one of the sources above.
-
-</ja:l>
- <ja:l>
-
を加えて、 Emacs を再起動します。これで上手くいかなければ、上記の情報源のいずれかを試してみて下さい。
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
-
The author uses both sgml-mode in Emacs,
and a commercial validating editor,
Clip! version 1.5,
when editing source
files.
-
-</ja:l>
- <ja:l>
-
著者は両 sgml-mode を Emacs で使っていて、商用検証エディター
Clip! version 1.5
を源ファイルを編集するのに使っています。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
If your editor doesn't validate,
then you should run a program to validate the source file.
-
-</ja:l>
- <ja:l>
-
お使いのエディターが検証しないなら、源ファイルを検証するのにプログラムを動かす必要があります。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The author uses
the
AlphaWorks XML parser for this purpose.
It requires that your system have a Java virtual machine.
In addition to Java,
there are validating parsers written in C, Perl, Python, and Tcl.
-
-</ja:l>
- <ja:l>
-
著者は
the
AlphaWorks XML parser をこの目的に使っています。これにはお使いの系統に
Java 仮想機械が必要です。 Java に加え、 C, Perl, Python, Tcl
で書かれた検証解析器があります。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The author has written
the xml2rfc tool,
which reads the source file and produces both a text and HTML version
@@ -3300,50 +2580,40 @@
Note that xml2rfc isn't a validating tool,
so it's a good idea to use either a validating editor or run a stand-alone
validating parser prior to using the tool.
-
-</ja:l>
- <ja:l>
-
著者は源ファイルを読んで文書の text 版と HTML 版の両者を生成する
xml2rfc
工具を書きました。 (このメモは xml2rfc 工具を使って生成しました。)
なお、 xml2rfc は検証工具ではないので、検証エディターや単独検証解析器をこの工具の前に使うのが良いでしょう。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
The XML Style Language (XSL) is used to describe transformations
from the source file into some other structured file.
So,
ideally you should use an XSL-capable formatter to convert an XML source
file to HTML.
-
-</ja:l>
- <ja:l>
-
XML スタイル言語 (XSL) を源ファイルから他の構造のファイルに変形するのを記述するのに使用出来ます。ですから、理想的には XSL が使える formatter
を使って XML 源ファイルを HTML に変換するべきでしょう。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
However,
as of this writing XSL is still in considerable flux.
(Hence,
@@ -3354,137 +2624,106 @@
in the interim,
the author uses the xml2rfc tool for this purpose,
even though this tool doesn't provide much flexibility in its HTML layout.
-
-</ja:l>
- <ja:l>
-
しかしながら、この XSL 書きはまだ流動的と考えられます。
(それ故、このメモには参照は含めませんでした。読者がこの節を読む時には参照はもう古いものになっているでしょうから。)
ですが、その間、著者はこの目的に xml2rfc 工具を使います。
この工具はそれほど HTML 配置に柔軟性を持っていないのですが。
-
-</ja:l>
-
-</ja:pair>
- rfc2629.xslt は、
xml2rfc
工具に含まれています。これを使って巷の XSLT formatter
でも HTML に変換出来ます。
- <ja:pair>
-
Browsers that support either XSL or Cascading Style Sheets (CSS)
are able to view the source file directly.
-
-</ja:l>
- <ja:l>
-
XSL か Cascading Style Sheets (CSS)
に対応した閲覧器を源ファイルを直接見るのに使用出来ます。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
At present,
the author doesn't use any of these browsers,
instead converting source files to either text or HTML.
-
-</ja:l>
- <ja:l>
-
現時点で、著者はその様な閲覧器を使っておらず、代わりに源ファイルを
text か HTML に変換しています。
-
-</ja:l>
-
-</ja:pair>
-
- <ja:pair>
-
As with text editors,
any text-oriented search tool (e.g., grep) can be used on the source file.
However,
there are search tools available that understand structured source.
-
-</ja:l>
- <ja:l>
-
text エディターと共に、どんな text 指向検索工具 (例 grep)
をも源ファイルに対して使うことが出来ます。しかし、構造化された源を理解する検索道具もあります。
-
-</ja:l>
-
-</ja:pair>
-
The author uses
sgrep
version 1.9
for this purpose,
e.g.
-
-</ja:l>
- <ja:l>
-
著者は
sgrep
version 1.9 をこの目的で次の様に使っています。
-
-</ja:l>
-
-</ja:pair>
+
which extracts the title element from the source file.
-
-</ja:l>
- <ja:l>
-
これは title 要素を源ファイルから取り出します。
-
-</ja:l>
-
-</ja:pair>
+
This memo raises no security issues;
however,
according to
@@ -3510,24 +2747,16 @@
your document should contain a section near the end that discusses the
security considerations of the protocol or procedures that are the
main topic of your document, e.g.,
-
-</ja:l>
- <ja:l>
-
+ このメモは安全性問題を起こしません。しかし、 [2]
によると、文書は終わり近くに、文書の主題であるプロトコルや処理の安全性に関しての議論の節を設けるべきです。例:
-
-</ja:l>
-
-</ja:pair>
+
- <ja:pair>
- この DTD のファイル rfc2629.dtd は、
- xml2rfc
- 工具の中にも含まれています。
- <ja:pair>
- この文書 (の原本) は、 RFC 2629
+ で定義された形式に、翻訳文用の要素を XML
+ 名前空間を使って追加して用いています。詳しくは、
+
+ <http://suika.fam.cx/~wakaba/lang/rfc/translation/>
+
+ を御覧下さい。
原文の著作権声明が、訳文についても同様に適用されます。 また、改訳その他の原文の著作権声明に反しない範囲における改変は、一切の許可無く行って構いません。2.2.1. The title Element
+2.2.1. The title Element
+2.2.1.
+ title 要素
<title abbrev="Much Ado about Nothing">
@@ -891,16 +690,16 @@
2.2.3. The date Element
+2.2.3. The date Element
+2.2.3.
+ date 要素
<date month="February" year="1999" />
2.2.4. Meta Data Elements
2.2.4. Meta Data Elements
+2.2.4.
+ メタ・データ要素
+
<area>General</area>
@@ -1188,10 +927,8 @@
<keyword>Extensible Markup Language</keyword>
2.2.5. The abstract Element
+2.2.5. The abstract Element
+2.2.5.
+ abstract 要素
<abstract>
<t>This memo presents a technique for using XML
@@ -1260,10 +985,8 @@
Request for Comments (RFC) series.</t>
</abstract>
-
-</ja:l>
- <ja:l>
-
<abstract>
<t>このメモは、 XML (拡張マーク付け言語) を
@@ -1271,24 +994,22 @@
系列の文書の原形式として使用する手法を説明します。</t>
</abstract>
- 2.2.6. The note Element
+2.2.6. The note Element
+2.2.6.
+ note 要素
<note title="IESG Note">
<t>The IESG has something to say.</t>
</note>
-
-</ja:l>
- <ja:l>
-
<note title="IESG 注記">
<t>IESG は特に言うことはありません。</t>
</note>
- 2.2.7. Status, Copyright Notice, Table of Contents
-2.2.7. Status, Copyright Notice, Table of Contents
+2.2.7.
+ 位置付け, 著作権表示, 目次
+2.2.7.1. Conformance with RFC 2026
+2.2.7.1. Conformance with RFC 2026
+2.2.7.1.
+ RFC 2026 への適合性
- <ja:pair>
-
<rfc ipr="full" docName="draft-mrose-writing-rfcs-01">
@@ -1545,33 +1196,28 @@
2.2.8. Everything in the Front
+2.2.8. Everything in the Front
+2.2.8.
+ Front 全体
+
<front>
<title>Writing I-Ds and RFCs using XML</title>
@@ -1612,10 +1258,9 @@
</abstract>
</front>
-
-</ja:l>
- <ja:l>
-
+
+
<front>
<title>XML を使って I-D や RFC を書く</title>
@@ -1655,10 +1300,8 @@
</abstract>
</front>
-
...
@@ -1698,34 +1335,28 @@
...
2.3.1. The section Element
+2.3.1. The section Element
+2.3.1.
+ section 要素
<section anchor="intro" title="Introduction">
@@ -1761,23 +1386,17 @@
<section title="The Middle">
@@ -1795,14 +1414,14 @@
2.3.1.1. The t Element
-2.3.1.1. The t Element
+2.3.1.1.
+ t 要素
+2.3.1.2. The list Element
+2.3.1.2. The list Element
+2.3.1.2.
+ list 要素
<list style="numbers">
<t>The first item.</t>
@@ -1879,10 +1482,8 @@
</t>
</list>
-
-</ja:l>
- <ja:l>
-
<list style="numbers">
<t>最初の項目。</t>
@@ -1894,16 +1495,12 @@
</t>
</list>
-
<list style="hanging">
<t hangText="full2026:">indicating that the document is in
@@ -1973,10 +1558,8 @@
than to publish as an Internet-Draft.</t>
</list>
-
-</ja:l>
- <ja:l>
-
<list style="hanging">
<t hangText="full2026:">文書が RFC 2026
@@ -1993,22 +1576,20 @@
示します</t>
</list>
- 2.3.1.3. The figure Element
-2.3.1.3. The figure Element
+2.3.1.3.
+ figure 要素
+
<figure anchor="figure_example">
<preamble>So,
@@ -2138,10 +1687,8 @@
<postamble>which is a very simple example.</postamble>
</figure>
-
-</ja:l>
- <ja:l>
-
<figure anchor="figure_example">
<preamble>ということで、全てまとめると、
@@ -2155,53 +1702,37 @@
<postamble>非常に単純な例でした。</postamble>
</figure>
-
<figure>
<preamble>If you have artwork with a lot of "<"
@@ -2217,10 +1748,8 @@
is left alone by the XML application.</postamble>
</figure>
-
-</ja:l>
- <ja:l>
-
<figure>
<preamble>沢山の "<" 文字が絵の中にある場合は、
@@ -2235,36 +1764,26 @@
応用に干渉されません。</postamble>
</figure>
- 2.3.1.4. The xref Element
2.3.1.4. The xref Element
+2.3.1.4.
+ xref 要素
+
according to the token syntax in <xref target="xml_basics" />.
-
-</ja:l>
- <ja:l>
-
<xref target="xml_basics" /> の字句 (token) 構文に従い
-
conforming to <xref target="refs.RFC2223">RFC 2223</xref>.
-
-</ja:l>
- <ja:l>
-
<xref target="refs.RFC2223">RFC 2223</xref> に適合する
- 2.3.1.5. The eref Element
+2.3.1.5. The eref Element
+2.3.1.5.
+ eref 要素
<eref target="http://metalab.unc.edu/xml/">Cafe con Leche</eref>
@@ -2521,124 +1979,96 @@
<eref target="http://invisible.net/" />
2.3.1.6. The iref Element
+2.3.1.6. The iref Element
+2.3.1.6.
+ iref 要素
<iref item="indexing" subitem="how to" />
-
-</ja:l>
- <ja:l>
-
<iref item="索引付け" subitem="方法" />
- 2.3.1.7. The vspace Element
2.3.1.7. The vspace Element
+2.3.1.7.
+ vspace 要素
+
<list style="numbers">
<t>This is list item.
@@ -2694,10 +2112,8 @@
as a separate physical paragraph.</t>
</list>
-
-</ja:l>
- <ja:l>
-
<list style="numbers">
<t>これは一覧の項目です。
@@ -2706,17 +2122,13 @@
しかし表示の際には別の形式段落に見えます。</t>
</list>
-
...
@@ -2796,134 +2192,95 @@
</rfc>
2.4.1. The references Element
2.4.1. The references Element
+2.4.1.
+ references 要素
+
<reference anchor="refs.RFC2200">
@@ -2943,11 +2300,9 @@
</reference>
2.4.2. Appendices
2.4.2. Appendices
+2.4.2.
+ 附属書
+2.4.3. Copyright Status
2.4.3. Copyright Status
+2.4.3.
+ 著作権状態
+3. Processing the XML Source File
3. Processing the XML Source File
+3.
+ XML 源ファイルの処理
+3.1. Editing
+3.1. Editing
+3.1.
+ 編集
(setq auto-mode-alist
(cons (cons "\\.xml$" 'sgml-mode) auto-mode-alist))
3.1.1. Checking
+
3.1.1. Checking
+3.1.1.
+ 確認
+3.2. Converting to Text Format
3.2. Converting to Text Format
+3.2.
+ text 形式に変換する
+3.3. Converting to HTML Format
3.3. Converting to HTML Format
+3.3.
+ HTML 形式に変換する
+3.4. Viewing
-3.4. Viewing
+3.4.
+ 表示
+3.5. Searching
3.5. Searching
+3.5.
+ 検索
+
sgrep -g xml 'ELEMENTS("title") not in ELEMENTS("back")' \
writing-rfcs.xml
<middle>
...
@@ -3542,10 +2771,8 @@
</section>
</middle>
-
-</ja:l>
- <ja:l>
-
<middle>
...
@@ -3557,14 +2784,11 @@
</section>
</middle>
- References
@@ -3630,738 +2854,6 @@
A. The rfc Element
-
- <rfc number="2200"
- obsoletes="2000, 1920, 1880, 1800, ..."
- category="std"
- seriesNo="1">
-
-
-
-
-
-<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [<!ENTITY rfc.number "1234">]>
- B. The RFC DTD
-
-<!--
- DTD for the RFC document series, draft of 99-01-30
- -->
-
-
-<!--
- Contents
-
- DTD data types
-
- The top-level
-
- Front matter
-
- The Body
-
- Back matter
- -->
-
-
-<!--
- DTD data types:
-
- entity description
- ====== ===============================================
- NUMBER [0-9]+
- NUMBERS a comma-separated list of NUMBER
-
- DAY the day of the month, e.g., "1"
- MONTH the month of the year, e.g., "January"
- YEAR a four-digit year, e.g., "1999"
-
- URI e.g., "http://invisible.net/"
-
- ATEXT/CTEXT printable ASCII text (no line-terminators)
-
- TEXT character data
- -->
-
-
-<!ENTITY % NUMBER "CDATA">
-<!ENTITY % NUMBERS "CDATA">
-
-<!ENTITY % DAY "CDATA">
-<!ENTITY % MONTH "CDATA">
-<!ENTITY % YEAR "CDATA">
-
-<!ENTITY % URI "CDATA">
-
-<!ENTITY % ATEXT "CDATA">
-<!ENTITY % CTEXT "#PCDATA">
-
-<!ENTITY % TEXT "#PCDATA">
-
-<!ENTITY rfc.number "2629">
-
-
-<!--
- The top-level
- -->
-
-
-<!--
- attributes for the "rfc" element are supplied by the RFC
- editor. when preparing drafts, authors should leave them blank.
-
- the "seriesNo" attribute is used if the category is, e.g., BCP.
- -->
-<!ELEMENT rfc (front,middle,back?)>
-<!ATTLIST rfc
- number %NUMBER; #IMPLIED
- obsoletes %NUMBERS; ""
- updates %NUMBERS; ""
- category (std|bcp|info|exp|historic)
- "info"
- seriesNo %NUMBER; #IMPLIED
- ipr (full2026|noDerivativeWorks2026|none)
- #IMPLIED
- docName %ATEXT; #IMPLIED>
-
-<!--
- Front matter
- -->
-
-
-<!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,
- abstract?,note*)>
-
-<!-- the "abbrev" attribute is used for headers, etc. -->
-<!ELEMENT title (%CTEXT;)>
-<!ATTLIST title
- abbrev %ATEXT; #IMPLIED>
-
-<!ELEMENT author (organization,address?)>
-<!ATTLIST author
- initials %ATEXT; #IMPLIED
- surname %ATEXT; #IMPLIED
- fullname %ATEXT; #IMPLIED>
-
-<!ELEMENT organization
- (%CTEXT;)>
-<!ATTLIST organization
- abbrev %ATEXT; #IMPLIED>
-
-<!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)>
-
-<!-- at most one of each the city, region, code, and country
- elements may be present -->
-<!ELEMENT postal (street+,(city|region|code|country)*)>
-<!ELEMENT street (%CTEXT;)>
-<!ELEMENT city (%CTEXT;)>
-<!ELEMENT region (%CTEXT;)>
-<!ELEMENT code (%CTEXT;)>
-<!ELEMENT country (%CTEXT;)>
-<!ELEMENT phone (%CTEXT;)>
-<!ELEMENT facsimile (%CTEXT;)>
-<!ELEMENT email (%CTEXT;)>
-<!ELEMENT uri (%CTEXT;)>
-
-<!ELEMENT date EMPTY>
-<!ATTLIST date
- day %DAY; #IMPLIED
- month %MONTH; #REQUIRED
- year %YEAR; #REQUIRED>
-
-<!-- meta-data... -->
-<!ELEMENT area (%CTEXT;)>
-<!ELEMENT workgroup (%CTEXT;)>
-<!ELEMENT keyword (%CTEXT;)>
-
-<!ELEMENT abstract (t)+>
-<!ELEMENT note (t)+>
-<!ATTLIST note
- title %ATEXT; #REQUIRED>
-
-
-<!--
- The body
- -->
-
-
-<!ELEMENT middle (section)+>
-
-<!ELEMENT section (t|figure|section)*>
-<!ATTLIST section
- anchor ID #IMPLIED
- title %ATEXT; #REQUIRED>
-
-<!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|vspace)*>
-<!ATTLIST t
- hangText %ATEXT; #IMPLIED>
-
-<!-- the value of the style attribute is inherited from the closest
- parent -->
-<!ELEMENT list (t+)>
-<!ATTLIST list
- style (numbers|symbols|hanging|empty)
- "empty">
-
-<!ELEMENT xref (%CTEXT;)>
-<!ATTLIST xref
- target IDREF #REQUIRED
- pageno (true|false) "false">
-
-<!ELEMENT eref (%CTEXT;)>
-<!ATTLIST eref
- target %URI; #REQUIRED>
-
-<!ELEMENT iref EMPTY>
-<!ATTLIST iref
- item %ATEXT; #REQUIRED
- subitem %ATEXT; "">
-
-<!ELEMENT vspace EMPTY>
-<!ATTLIST vspace
- blankLines %NUMBER; "0">
-
-<!ELEMENT figure (preamble?,artwork,postamble?)>
-<!ATTLIST figure
- anchor ID #IMPLIED
- title %ATEXT; "">
-
-<!ELEMENT preamble (%TEXT;|xref|eref|iref)*>
-<!ELEMENT artwork (%TEXT;)*>
-<!ATTLIST artwork
- xml:space (default|preserve) "preserve">
-<!ELEMENT postamble (%TEXT;|xref|eref|iref)*>
-
-
-<!--
- Back matter
- -->
-
-
-<!-- sections, if present, are appendices -->
-<!ELEMENT back (references?,section*)>
-
-<!ELEMENT references (reference+)>
-<!ELEMENT reference (front,seriesInfo*)>
-<!ATTLIST reference
- anchor ID #IMPLIED
- target %URI; #IMPLIED>
-<!ELEMENT seriesInfo EMPTY>
-<!ATTLIST seriesInfo
- name %ATEXT; #REQUIRED
- value %ATEXT; #REQUIRED>
-
-
-<!--
- RFC 文書系列用 DTD, 99-01-30 の原案 (の注釈部分和訳)
- -->
-
-
-<!--
- 内容
-
- DTD データ型
-
- 最上位
-
- Front matter
-
- The Body
-
- Back matter
- -->
-
-
-<!--
- DTD データ型:
-
- 実体 説明
- ====== ===============================================
- NUMBER [0-9]+
- NUMBERS 読点(comma)区切りの NUMBER
-
- DAY 月中の日、例えば "1"
- MONTH 年中の月、例えば "January" (1月)
- YEAR 4桁年号、例えば "1999"
-
- URI 例 "http://invisible.net/"
-
- ATEXT/CTEXT 印字可能 ASCII 文字列 (行終端無し)
-
- TEXT 文字データ
- -->
-
-
-<!ENTITY % NUMBER "CDATA">
-<!ENTITY % NUMBERS "CDATA">
-
-<!ENTITY % DAY "CDATA">
-<!ENTITY % MONTH "CDATA">
-<!ENTITY % YEAR "CDATA">
-
-<!ENTITY % URI "CDATA">
-
-<!ENTITY % ATEXT "CDATA">
-<!ENTITY % CTEXT "#PCDATA">
-
-<!ENTITY % TEXT "#PCDATA">
-
-<!ENTITY rfc.number "2629">
-
-
-<!--
- 最上位
- -->
-
-
-<!--
- "rfc" 要素の属性は RFC 編集者により埋められます。
- 原案を用意する際には、著者は空欄にしておくべきです。
-
- "seriesNo" 属性は分類が例えば BCP の時に使います。
- -->
-<!ELEMENT rfc (front,middle,back?)>
-<!ATTLIST rfc
- number %NUMBER; #IMPLIED
- obsoletes %NUMBERS; ""
- updates %NUMBERS; ""
- category (std|bcp|info|exp|historic)
- "info"
- seriesNo %NUMBER; #IMPLIED
- ipr (full2026|noDerivativeWorks2026|none)
- #IMPLIED
- docName %ATEXT; #IMPLIED>
-
-<!--
- Front matter
- -->
-
-
-<!ELEMENT front (title,author+,date,area*,workgroup*,keyword*,
- abstract?,note*)>
-
-<!-- "abbrev" 属性は頭とかに使います。 -->
-<!ELEMENT title (%CTEXT;)>
-<!ATTLIST title
- abbrev %ATEXT; #IMPLIED>
-
-<!ELEMENT author (organization,address?)>
-<!ATTLIST author
- initials %ATEXT; #IMPLIED
- surname %ATEXT; #IMPLIED
- fullname %ATEXT; #IMPLIED>
-
-<!ELEMENT organization
- (%CTEXT;)>
-<!ATTLIST organization
- abbrev %ATEXT; #IMPLIED>
-
-<!ELEMENT address (postal?,phone?,facsimile?,email?,uri?)>
-
-<!-- city, region, code, country 各要素がせいぜい1回出現可能 -->
-<!ELEMENT postal (street+,(city|region|code|country)*)>
-<!ELEMENT street (%CTEXT;)>
-<!ELEMENT city (%CTEXT;)>
-<!ELEMENT region (%CTEXT;)>
-<!ELEMENT code (%CTEXT;)>
-<!ELEMENT country (%CTEXT;)>
-<!ELEMENT phone (%CTEXT;)>
-<!ELEMENT facsimile (%CTEXT;)>
-<!ELEMENT email (%CTEXT;)>
-<!ELEMENT uri (%CTEXT;)>
-
-<!ELEMENT date EMPTY>
-<!ATTLIST date
- day %DAY; #IMPLIED
- month %MONTH; #REQUIRED
- year %YEAR; #REQUIRED>
-
-<!-- メタ・データ・・・ -->
-<!ELEMENT area (%CTEXT;)>
-<!ELEMENT workgroup (%CTEXT;)>
-<!ELEMENT keyword (%CTEXT;)>
-
-<!ELEMENT abstract (t)+>
-<!ELEMENT note (t)+>
-<!ATTLIST note
- title %ATEXT; #REQUIRED>
-
-
-<!--
- 本体
- -->
-
-
-<!ELEMENT middle (section)+>
-
-<!ELEMENT section (t|figure|section)*>
-<!ATTLIST section
- anchor ID #IMPLIED
- title %ATEXT; #REQUIRED>
-
-<!ELEMENT t (%TEXT;|list|figure|xref|eref|iref|vspace)*>
-<!ATTLIST t
- hangText %ATEXT; #IMPLIED>
-
-<!-- style 属性の値は直近の親から継承する -->
-<!ELEMENT list (t+)>
-<!ATTLIST list
- style (numbers|symbols|hanging|empty)
- "empty">
-
-<!ELEMENT xref (%CTEXT;)>
-<!ATTLIST xref
- target IDREF #REQUIRED
- pageno (true|false) "false">
-
-<!ELEMENT eref (%CTEXT;)>
-<!ATTLIST eref
- target %URI; #REQUIRED>
-
-<!ELEMENT iref EMPTY>
-<!ATTLIST iref
- item %ATEXT; #REQUIRED
- subitem %ATEXT; "">
-
-<!ELEMENT vspace EMPTY>
-<!ATTLIST vspace
- blankLines %NUMBER; "0">
-
-<!ELEMENT figure (preamble?,artwork,postamble?)>
-<!ATTLIST figure
- anchor ID #IMPLIED
- title %ATEXT; "">
-
-<!ELEMENT preamble (%TEXT;|xref|eref|iref)*>
-<!ELEMENT artwork (%TEXT;)*>
-<!ATTLIST artwork
- xml:space (default|preserve) "preserve">
-<!ELEMENT postamble (%TEXT;|xref|eref|iref)*>
-
-
-<!--
- Back matter
- -->
-
-
-<!-- sections がある場合、それは附属書 -->
-<!ELEMENT back (references?,section*)>
-
-<!ELEMENT references (reference+)>
-<!ELEMENT reference (front,seriesInfo*)>
-<!ATTLIST reference
- anchor ID #IMPLIED
- target %URI; #IMPLIED>
-<!ELEMENT seriesInfo EMPTY>
-<!ATTLIST seriesInfo
- name %ATEXT; #REQUIRED
- value %ATEXT; #REQUIRED>
-
- C. Acknowledgements
-C.
- 謝辞
-Full Copyright Statement
完全な著作権声明
この翻訳文の形式について
+訳文についての著作権声明
+
+