DTD

対語表XML用�のDTDは、dtd/glossary.dtdで、その内容は以下に�なります。

<!ELEMENT glossary (alphabet+ | term+)>
<!ELEMENT alphabet (term+)>
<!ATTLIST alphabet initial CDATA #REQUIRED>
<!ELEMENT term (en, ja, category, spec?, note?, erratum*, link?)>
<!ELEMENT en (#PCDATA)>
<!ELEMENT ja (#PCDATA)>
<!ELEMENT category (#PCDATA)>
<!ELEMENT spec (#PCDATA)>
<!ATTLIST spec name CDATA #REQUIRED>
<!ELEMENT note (#PCDATA)>
<!ELEMENT erratum (#PCDATA)>
<!ELEMENT link (#PCDATA)>
<!ATTLIST link href CDATA #REQUIRED>

これ�により、対語表XMLは、以下のようになります。

<?xml version="1.0" encoding="Shift_JIS"?>
<!DOCTYPE glossary SYSTEM "dtd/glossary.dtd">

<glossary>
  <alphabet initial="A">
    <term>
      <en>absolute property</en>
      <ja>絶対プロパティ</ja>
      <category>XSL</category>
      <spec name="JIS">絶対特性</spec>
    </term>
    <term>
      ：
    </term>

      ：

  </alphabet>

  <alphabet initial="B">
      ：
  </alphabet>

      ：

  <alphabet initial="Z">
      ：
  </alphabet>
</glossary>

XMLファイル自体�は、シフトJIS(SHIFT-JIS)で保存します。ルート要素はglossaryで、その子供要素としてalphabetを持ちます�。alphabet要素には必ずinitial属性を指定しなければ�ならず、その値としてAからZのうち1つのアルファベットを指定しま�す。つまり、頭文字がinitial要素で指定されたアルファベット�で始まる英単語毎に、alphabet要素にまとめるようになってい�ます。

各alphabet要素は、子供要素としてtermを持ち�ます。term要素が、1つ1つの対語の詳細情報となります。term要素内の各要素は、以下のような情報を指定します。

en [必�須]

対語訳に登録する英語を指定します。

ja [必須]

en要素で指定した英語の対語となる日本語を指定します。

category [必須]

この英語が用いられる仕様や分類を指定します。ま�た、対語訳は、複数存在する日本Apache XMLプロジェクトの�サブプロジェクトで共通で使用するため、その意味での分類を指定する�こともあります。

値は特に規定されていませんが、以下のような情�報を入れると良いです。

• 該当するW3Cの仕様

  例えば、XML、XSL、XPath、HTML、SOAPなど

• The Apache XML Projectのサブプロジェクト名

  例えば、FOP、Cocoon、Axis、Forrestなど

• The Apache XML Projectのサブプロジェクトで関連する仕様

  例えば、PDF、PS、RFCなど

• The Apache Software Foundation内のプロジェクトやサブプロジ�ェクト

  例えば、Apache、Jakarta、Tomcat

• Javaに関連する分類

  例えば、Java、J2EEなど

• その他�、日本Apache XMLプロジェクトに関連する分類

spec [任意]

対語訳に登録する日本語が、category要素で指�定した仕様や分類で使用されている日本語と異なる場合に指定します。

日本Apache XMLプロジェクトでは、基本的には、category要素で指定した仕様の日本語版に合わせるようにしますが、そ�のcategory要素で指定した仕様の日本語に無理がある場合など�は、日本Apache XMLプロジェクトで使用する日本語をja要�素に、category要素で使用されている日本語を本要素に記載し�ます。

note [任意]

注意書き、単語の意味や説明を記載し�ます。単語の意味や説明をしっかりと記載すれば、対語訳でなく辞書と�して使用できるようになるでしょうが、気が向いたら記載する程度で良�く、本要素は特に必要ないです)。

erratum [任意]

対�語訳として適していない日本語を記載します。erratum要素は、term要素内に複数指定することができます。

link [任意]

対語訳を決める際の元となった資料を指定します。link要素に�は必ずhref属性を指定しなければならず、資料のURLを指定しま�す。