XML Base （第 2 版）

3.1. ~URI参照の符号化法と~escape法

`xml:base^a 属性の値は Legacy Extended IRI （ LEIRI ）であり，~URIに許容されない文字も包含し得る。 （しかしながら、 LEIRI に許容される一部の文字には，~XML文字として合法でないものがあり、それらの文字は `xml:base^a の値に現れることはない。） ◎ The value of an xml:base attribute is a Legacy Extended IRI (LEIRI) and may contain characters not allowed in URIs. (However, some characters allowed in LEIRIs are not legal XML characters, and cannot therefore appear in xml:base values.)

~percent-符号化法は，アリな限り処理~連鎖の後方で生じるとする原則に則って、要素の基底~URIへの~accsessを供する応用は，~escapeせずに値を計算して返すベキである。 ◎ In accordance with the principle that percent-encoding must occur as late as possible in the processing chain, applications which provide access to the base URI of an element should calculate and return the value without escaping.

<?xml version="1.0"?>
<e1 xml:base="http://example.org/wine/">
  <e2 xml:base="rosé"/>
</e1>

4.1. RFC 3986 との関係

`RFC-3986$r は、文書の中に埋込まれる基底~URIについての情報を供している。 基底~URIを決定する規則は、優先度の高い順に，次のように要約できる 【~~参照】 ： ◎ RFC 3986 [RFC 3986] provides for base URI information to be embedded within a document. The rules for determining the base URI can be summarized as follows (highest priority to lowest):

1. 文書の内容に埋込まれた基底~URI。 ◎ The base URI is embedded in the document's content.
2. `the encapsulating entity^en （~message, 文書, `none^en【？】のいずれか）の基底~URI。 ◎ The base URI is that of the encapsulating entity (message, document, or none).
3. `the entity^en の検索取得-時に利用した~URI。 ◎ The base URI is the URI used to retrieve the entity.
4. 応用の文脈によって定義される基底~URI。 ◎ The base URI is defined by the context of the application.

注記： 上の第 2 項, 第 3 項に現れる語 “`entity^en” は、 `RFC-3986$r のそれを指す。 この文書の他所における “実体【 `entity^en 】” は~XMLのそれを指す。 ◎ Note: The term "entity" in points #2 and #3 above uses the RFC 3986 meaning of the term. Elsewhere in this document the term "entity" is used in the XML sense.

この文書は、~XML文書の事例に限定して，基底~URI情報を埋込むための第 1 項の規則の詳細を指定する。 ◎ This document specifies the details of rule #1 for embedding base URI information in the specific case of XML documents.

4.2. 基底~URI情報の粒度

~XML文書~内に現れる相対~URIは常に、［ 要素, 文書~実体, 外部~実体 ］のいずれかに相対的に解決される。 属性ごと, 文字ごと, 実体ごと などの，より細かい粒度については、何も用意されていない。 ［ 内部~実体（内部~subset, 外部~DTDのどちらで宣言されたかを問わず）／ 外部~実体の中の `freestanding^en ~text（要素で括られていない~text） ］は、その実体~参照~用の視野~内とは別々の基底~URIを設定するものと見なされる。 ◎ Relative URIs appearing in an XML document are always resolved relative to either an element, a document entity, or an external entity. There is no provision for finer granularity, such as per-attribute, per-character, or per-entity base information. Neither internal entities, whether declared in the internal subset or in an external DTD, nor freestanding text (text not enclosed in an element) in an external entity, are considered to set a base URI separate from the base URI in scope for the entity reference.

［ 文書~実体／外部~実体 ］の基底~URIは、 `RFC-3986$r の規則により決定される。 すなわち，基底~URIは、その［ 文書~実体／外部~実体 ］の検索取得-時に利用した~URIになる。 ◎ The base URI of a document entity or an external entity is determined by RFC 3986 rules, namely, that the base URI is the URI used to retrieve the document entity or external entity.

要素の基底~URIは次のいずれかになる： ◎ The base URI of an element is:

1. 要素は `xml:base^a 属性を有するならば、それに指定されている~URI。 ◎ the base URI specified by an xml:base attribute on the element, if one exists, otherwise
2. 他の場合，要素を包含する［ 文書~実体／外部~実体 ］の中に要素の親~要素はあるならば、その親~要素の基底~URI。 ◎ the base URI of the element's parent element within the document entity or external entity, if one exists, otherwise
3. 他の場合，要素を包含する［ 文書~実体／外部~実体 ］の基底~URI。 ◎ the base URI of the document entity or external entity containing the element.

注記： したがって， `xml:base^a 属性により指定された基底~URIは、 `xml:base^a 属性を有する他の要素に遭遇するまで，同じ実体の中の子孫~要素に継承されることになる。 ◎ Note: It follows that the base URI specified by an xml:base attribute is inherited by descendant elements within the same entity until another element with an xml:base attribute is encountered.

要素が `xml:base^a 属性を有していて，その値は妥当でない Legacy Extended IRI である場合、要素の基底~URIは，応用~依存とする。 ◎ The base URI of an element bearing an xml:base attribute with a value that is not a valid Legacy Extended IRI is application dependent.

4.3. ~URIと基底~URIとの照合-法

~XML文書~内に与えられた相対~URIに対応する基底~URIは、次に従って決定される： ◎ The base URI corresponding to a given relative URI appearing in an XML document is determined as follows:

• ~text内容に現れる~URI参照~用の基底~URIは、その~textを包含する要素の基底~URIになるとする。 ◎ The base URI for a URI reference appearing in text content is the base URI of the element containing the text.
• `xml:base^a 属性に現れる~URI参照~用の基底~URIは、その属性を有する要素を `E^V, `E^V を包含する［ 文書~実体／外部~実体 ］を `D^V とするとき，［ `D^V 内に `E^V の親~要素 `P^V が存在するならば `P^V の基底~URI ／ 他の場合は `D^V の基底~URI ］とする。 ◎ The base URI for a URI reference appearing in an xml:base attribute is the base URI of the parent element of the element bearing the xml:base attribute, if one exists within the document entity or external entity, otherwise the base URI of the document entity or external entity containing the element.
• 他の属性の値に現れる~URI参照~用の基底~URIは、属性の既定~値†に現れる場合も含め，その属性を有する要素の基底~URIとする。 ◎ The base URI for a URI reference appearing in any other attribute value, including default attribute values, is the base URI of the element bearing the attribute.
• 処理命令 `PI^V の内容に現れる~URI参照~用の基底~URIは、 `PI^V を包含する［ 文書~実体／外部~実体 ］を `D^V とするとき，［ `D^V 内に `PI^V の親~要素 `P^V が存在するならば `P^V の基底~URI ／ 他の場合は `D^V の基底~URI ］とする。 ◎ The base URI for a URI reference appearing in the content of a processing instruction is the base URI of the parent element of the processing instruction, if one exists within the document entity or external entity, otherwise the base URI of the document entity or external entity containing the processing instruction.

【† 属性の既定~値 — おそらく， Attribute Defaults により指定されるもの — ~DTD等における宣言を通して、属性の省略-時にその属性がとるものとされる値 — を指す。 】

注記： `xml:base^a の属性~値が — ~XML文書~実体~内に直に供される代わりに — 属性の既定~値を通して供されている場合、この属性が在ることにより期待されない結果に導き得る。 一例として，外部~実体におけるその種の宣言は、非妥当性検証~XML処理器に基づく~softwareからは読取られないかもしれない。 XML Schema のような外部の仕組みを通して，属性の既定~値を与えた場合、期待されない結果に導き得る。 応用において妥当性検証~処理器が利用されていたとしても、~infosetの作成-後の属性の既定~値の追加により， `xml:base^a 属性と [base URI] ~infoset~propとが同期cしなくなり得る。 これらの理由から、 `xml:base^a の値は、~XML文書~instanceにおいて直に供されるか, あるいは~DTDの内部~subsetにて宣言される属性の既定~値を通して供されるベキである。 ◎ Note: The presence of xml:base attributes might lead to unexpected results in the case where the attribute value is provided, not directly in the XML document entity, but via a default attribute. For instance, such a declaration in an external entity might not be read by software which is based on a non-validating XML processor. Defaulting attributes through an external mechanism such as XML Schema may also lead to unexpected results; even if a validating processor is used by the application, the addition of defaulted attributes subsequent to creation of the infoset can cause xml:base attributes to get out of sync with the [base URI] infoset property. For these reasons, xml:base values should be provided either directly in the XML document instance or via default attributes declared in the internal subset of the DTD.

4.4. 同じ文書への参照の解釈

`RFC-3986$r は、一定の相対~URI参照，特に［ 空~文字列, および `#fragment^c 形のもの ］を，同じ文書への参照 として定義している。 同じ文書への参照に対する参照外し（ `dereferencing^en ）は特別に取扱われる。 しかしながら、それらを `xml:base^a 属性の値に利用しても，参照外しを孕むことはない — ~XMLBase処理器は、通例の仕方で解決するべきである。 特に、 `xml:base=""^c としても，基底~URIは 包含している文書の~URIに設定し直されることはない。 ◎ RFC 3986 defines certain relative URI references, in particular the empty string and those of the form #fragment, as same-document references. Dereferencing of same-document references is handled specially. However, their use as the value of an xml:base attribute does not involve dereferencing, and XML Base processors should resolve them in the usual way. In particular, xml:base="" does not reset the base URI to that of the containing document.

注記： 一部の既存の処理器は、~~実際にこれらの `xml:base^a 値を，基底~URIをそれを包含する文書に設定し直すものとして扱うので、そのような値は利用しないことが強く奨励される。 ◎ Note: Some existing processors do treat these xml:base values as resetting the base URI to that of the containing document, so the use of such values is strongly discouraged.