externalRef 要素

外部スキーマをマクロとして参照する要素

外部スキーマを、まるごとマクロとして参照、埋め込みを行うための要素です。
常に空要素。中身はありません。
grammar 要素の子要素として記述することは出来ません。
include 要素が grammar 要素を最上位要素としたスキーマを取り込むのに対し、 externalRef 要素は、それ以外の要素 (主にパターン関聯要素)が最上位要素であるスキーマを参照するのに用いられます。
ref 要素と同様、要素／属性名の定義の中では使用できません。
一応、最上位要素としても記述できます。意味があるのかどうかはともかく、取り敢えず可能です。

各論

属性に関する説明

外部スキーマ名を href 属性で指定します。値は URI です。
共通属性 ns, xmlns:xxx, datatypeLibrary 各属性が使用できます。例えば、外部ファイルへの参照を行う場合、名前空間やデータ型の再定義をしたい際に使用出来ます (ただし、参照先で既に定義されている場合は、そちらが優先されます)。

取り込まれる外部スキーマについて

ref 要素との違いは、 define 要素の中身を指定するか外部スキーマの内容を指定するかの違いだけで、原則として機能は全く同一です。

つまり、 externalRef 要素で参照される外部スキーマの書式は、 define 要素の中身と成り得る書式と同一である必要があります。具体例に関しては後述します。

記述例

externalRef を使用した例

schema1.rng

<?xml version="1.0"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">

<start>
 <element name="drinkshop">
   <externalRef href="schema2.rng"/> <!-- 外部スキーマの参照 -->
 </element>
</start>

</grammar>

schema2.rng (最上位要素は大抵パターン関聯要素 ; ここでは choice 要素)

<?xml version="1.0"?>
<choice xmlns="http://relaxng.org/ns/structure/1.0">
 <element name="favoriteItem">
  <text/>
 </element>
 <element name="regularItem">
  <text/>
 </element>
</choice>

externalRef 要素を使わない場合

schema1.rng は、以下の記述と同一になります (強調部分は、 externalRef 要素によって取り込まれた記述)。

<?xml version="1.0"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">

<start>
 <element name="drinkshop">
  <choice>
   <element name="favoriteItem">
    <text/>
   </element>
   <element name="regularItem">
    <text/>
   </element>
  </choice>
 </element>
</start>

</grammar>