STEP 2: XML DTDからの移行（パラメタ実体あり）

• 要素内容モデルの中で用いられるパラメタ実体
  • 概要
  • 使用できる生け垣モデル
  • occurs属性
  • hedgeRefとhedgeRuleの 順番
  • 自分自身を参照しないこと
  • emptyの用途
  • noneの用途
• 属性リスト宣言の中で用いられるパラメタ実体
  • 概要
  • refとattPoolの順番
  • 複数のref要素
  • 自分自身を参照しないこと
• まとめ

要素内容モデルの中で用いられるパラメタ実体

概要

<hedgeRule label="foo"> ...element content model... </hedgeRule>

このように定義したhedgeRuleを参照するには，<hedgeRef label="foo"/>と書きます．このhedgeRef要素は，hedgeRuleの中で指定された要素生け垣モデルで置き換えられます．
以下の例では，要素型docのためのelementRuleの生け垣モデルからhedgeRuleを参照しています．このelementRuleは，STEP 1の先頭にあるモジュールにあったものを書き換えて，title以外の部分をhedgeRuleで記述したものです．

<hedgeRule label="doc.body"> <ref label="para" occurs="*"/> </hedgeRule> <elementRule role="doc"> <sequence> <ref label="title"/> <hedgeRef label="doc.body"/> </sequence> </elementRule>

doc.bodyへの参照は次のように展開されます．

<elementRule role="doc"> <sequence> <ref label="title"/> <ref label="para" occurs="*"/> </sequence> </elementRule>

この例では，elementRuleの中からhedgeRuleを参照しましたが，hedgeRuleの中からも同様に可能です．

使用できる生け垣モデル

<hedgeRule label="mixed.param"> <mixed> <choice occurs="*"> <ref label="em"/> <ref label="strong"/> <choice> </mixed> </hedgeRule> <hedgeRule label="string.param" type="string"/>

hedgeRefと混在生け垣モデルを併用するときは，hedgeRuleの中でmixedを使うのではなく，hedgeRefをmixedで括ってelementRuleの中に書きます．その例を次に示します．混在生け垣モデルはphraseを参照しており，phraseはhedgeRuleで記述されています．

<hedgeRule label="phrase"> <choice> <ref label="em"/> <ref label="strong"/> <choice> </hedgeRule> <elementRule role="p"> <mixed> <hedgeRef label="phrase" occurs="*"/> </mixed> </elementRule>

occurs属性

<hedgeRule label="bar"> <sequence occurs="+" > <ref label="foo1"/> <ref label="foo2"/> </sequence> </hedgeRule> <elementRule role="foo"> <hedgeRef label="bar" occurs="*"/> </elementRule>

この例をDTDで表現すれば，パラメタ実体の展開がどう行われるべきかは明らかです．

<!ENTITY % bar "(foo1, foo2)+"> <!-- original --> <!ELEMENT foo (%bar;)*> <!-- expanded --> <!ELEMENT foo ((foo1, foo2)+)*>

上の例を展開した結果を次に示します．展開のときに，一つしか子供を持たないchoice要素が導入されていることに注意して下さい．これは，hedgeRef要素にあったoccurs="*"を引き継いでいます．

<elementRule role="foo"> <choice occurs="*"> <sequence occurs="+" > <ref label="foo1"/> <ref label="foo2"/> </sequence> </choice> </elementRule>

hedgeRefとhedgeRuleの 順番

<elementRule role="doc"> <sequence> <ref label="title"/> <hedgeRef label="doc.body"/> </sequence> </elementRule> <hedgeRule label="doc.body"> <ref label="para" occurs="*"/> </hedgeRule>

自分自身を参照しないこと

<hedgeRule label="bar"> <choice> <ref label="title"/> <hedgeRef label="bar" occurs="*"/> </choice> </hedgeRule>

次の例では，bar1のための生け垣モデルの中でbar2を参照しており，bar2のための生け垣モデルの中でbar1を参照しています．したがって，エラーになります．

<hedgeRule label="bar1"> <hedgeRef label="bar2" occurs="*"/> </hedgeRule> <hedgeRule label="bar2"> <choice> <ref label="title"/> <hedgeRef label="bar1"/> </choice> </hedgeRule>

emptyの用途

<hedgeRule label="frontMatter"> <empty/> </hedgeRule> <elementRule role="section"> <sequence> <ref label="title"/> <hedgeRef label="frontMatter"/> <ref label="para" occurs="*"/> </sequence> </elementRule>

このモジュールを再利用する人は，frontMatterの記述をカスタマイズすることによって，sectionの構造を変更できます．

noneの用途

<hedgeRule label="local-block-class"> <none/> </hedgeRule> <hedgeRule label="block-class"> <choice> <ref label="para"/> <ref label="fig"/> <hedgeRef label="local-black-class"/> </choice> </hedgeRule>

このモジュールを再利用する人は，local-block-classの記述をカスタマイズすることによって，block-classの内容を変更できます．

属性リスト宣言の中で用いられるパラメタ実体

概要

<attPool role="foo"> ...attribute definitions... </attPool>

このように定義したattPoolを参照するには，属性定義の並びの先頭に<ref role="foo"/> と書きます．このref要素は，attPoolの中で指定された属性定義の並びで置き換えられます．
以下の例では，要素型titleのためのtag要素からattPoolを参照しています．このtagは，STEP 1の先頭にあるモジュールにあったものを書き直したものです．多くの要素型に共通するrole属性が，common.attというattPoolに記述されています．

<attPool role="common.att"> <attribute name="class" type="NMTOKEN"/> </attPool> <tag name="title"> <ref role="common.att"/> <attribute name="number" required="true" type="integer"/> </tag>

ref要素は次のように展開されます．

<tag name="title"> <attribute name="class" type="NMTOKEN"/> <attribute name="number" required="true" type="integer"/> </tag>

この例では，tagの中からattPoolを参照しましたが，attPoolの中からも同様に可能です．

refとattPoolの順番

<tag name="title"> <ref role="common.att"/> <attribute name="number" required="true" type="integer"/> </tag> <attPool role="common.att"> <attribute name="role" type="NMTOKEN"/> </attPool>

複数のref要素

<attPool role="common.att"> <ref role="common-req.att"/> <ref role="common-opt.att"/> </attPool> <attPool role="common-req.att"> <attribute name="role" type="NMTOKEN" required="true"/> </attPool> <attPool role="common-opt.att"> <attribute name="id" type="NMTOKEN"/> </attPool>

自分自身を参照しないこと

<attPool role="bar1"> <ref role="bar2"/> <attribute name="id" type="NMTOKEN"/> </attPool> <attPool role="bar2"> <ref role="bar1"/> </attPool>

まとめ