<?xml version="1.0" encoding="utf-8"?>
<!--Copyright TEI Consortium. 
Licensed under the GNU General Public License. 
See the file COPYING for details
$Date$

$Id$
-->
<macroSpec xmlns="http://www.tei-c.org/ns/1.0" module="tei" n="User Extensions" xml:id="TEIEXTD" type="pe" ident="TEI.extensions.dtd">
  <desc>supplies the name of a file containing any local modifications required to the TEI DTDs.</desc>
  <desc version="2008-04-05" xml:lang="ja">
TEIが用意したDTDに加える変更点を含むファイル名を示す．</desc>
  <content/>
  <remarks>
    <p>The contents of the file indicated by this entity are embedded
    in a  TEI DTD immediately before the DTD fragments (modules)
requested by the user are embedded.  By default,
the entity expands to the empty string; the user can override this
default by declaring the entity in the DTD subset with an appropriate
value. Typically
this will take the form
<?tei winita?><eg><![CDATA[<!ENTITY % TEI.extensions.dtd SYSTEM 'project.dtd' >]]></eg>
where <ident type="file">project.dtd</ident> is the name of a file
containing additional element or attribute declarations. These
declarations may include references to any of the TEI-defined classes,
datatypes, or macros described in chapter <ptr target="#ST"/>   </p>
    <p>This macro is used only by the XML DTD 
customization mechanism defined in TEI P4. The recommended method of
TEI customization at P5, irrespective of schema language, is to define an ODD.</p>
  </remarks>
  <remarks xml:lang="ja">
    <p>
当該エンティティで示されたファイルの中身は，DTDの中では，モジュールを
導入する前に埋め込む必要がある．
デフォルトでは，当該エンティティは，空文字として展開される．
すなわち，
利用者は，当該エンティティを必要な値で宣言することにより，デフォルト値
を上書きすることが出来る．
例えば，以下の場合では，<ident type="file">project.dtd</ident>は，
追加する要素宣言・属性宣言を含むファイル名を示している．

<?tei winita?>
<eg><![CDATA[

<!ENTITY % TEI.extensions.dtd SYSTEM 'project.dtd' >
]]></eg>

この種の宣言は，TEI規定のクラス，データ型，マクロなどへの参照を含むこ
 とも可能である<ptr target="#ST"/>．
</p>
    <p>
このマクロは，TEI P4で規定されているDTD修正機能で使われるものである．
TEI P5では，修正を行う場合，使用するスキーマ言語に関係なく，ODDを定義
 することが推奨方法になっている．
</p>
  </remarks>
  <listRef>
    <ptr target="#STOV"/>
  </listRef>
</macroSpec>
