<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE document PUBLIC "-//CNX//DTD CNXML 0.5 plus MathML//EN" "http://cnx.rice.edu/cnxml/0.5/DTD/cnxml_mathml.dtd">
<document xmlns="http://cnx.rice.edu/cnxml" xmlns:md="http://cnx.rice.edu/mdml/0.4" xmlns:bib="http://bibtexml.sf.net/" xmlns:m="http://www.w3.org/1998/Math/MathML" id="m11215">
  <name>CNXML Reference Extensions (日本語 - Japanese)</name>
  <metadata>
  <md:version>1.6</md:version>
  <md:created>2005/08/25 16:41:36.895 GMT-5</md:created>
  <md:revised>2005/08/25 16:42:31.428 GMT-5</md:revised>
  <md:authorlist>
      <md:author id="jago">
      <md:firstname>Adan</md:firstname>
      
      <md:surname>Galvan</md:surname>
      <md:email>jago@rice.edu</md:email>
    </md:author>
      <md:author id="takaryo">
      <md:firstname>Hironori</md:firstname>
      
      <md:surname>Takaryo</md:surname>
      <md:email>s043105@ishikawa-nct.ac.jp</md:email>
    </md:author>
  </md:authorlist>

  <md:maintainerlist>
    <md:maintainer id="takaryo">
      <md:firstname>Hironori</md:firstname>
      
      <md:surname>Takaryo</md:surname>
      <md:email>s043105@ishikawa-nct.ac.jp</md:email>
    </md:maintainer>
  </md:maintainerlist>
  
  <md:keywordlist>
    <md:keyword>bibtexml</md:keyword>
    <md:keyword>definition</md:keyword>
    <md:keyword>glossary</md:keyword>
  </md:keywordlist>

  <md:abstract>A module describing the use of bibtexml with cnxml, as well as as introduction to the glossary tag.</md:abstract>
</metadata>

  <content>		
    <section id="introduction">
      <name>はじめに</name>
      <para id="intro_me">　著者や編集者として、あなたは時々、実際はテキストに現れないドキュメント内の追加情報を含める方法が必要になるかもしれません。この情報はglossary、bibliographic referenceを含むかもしれません。このタイプの情報を含める方法はたくさんありますが、私たちの目的のために、私たちは<code>glossary</code>という名前の新しいCNXMLタグを作成することを選びました。そして、リファレンスのためにbibteXMLと呼ばれるXML言語を使用することを選びました。以下でその2つを説明します。また私はglossayとbibteXMLファイルの例を、このドキュメントのソースに含めました。ページの下までスクロールし、例がどのように表されているか見てください。
      </para>
      <section id="introbibtex">
	<name>BibteXML</name>
	<para id="p1">
	<quote type="block" src="http://freshmeat.net/projects/bibtexml/?topic_id=87">
	  "BibteXML is a bibliography DTD for XML that expresses the
	  content model of BibTeX, the bibliographic system for use
	  with LaTeX. It provides conversion tools for tagging your
	  bibliographic data in XML, or export it to HTML or native
	  BibTeX syntax, saving typing time."
	  </quote>
　平たく言えば、bibtexmlがポピュラーで広く受け入れられたlatex extension bibtexのXMLバージョンであることを、これは意味しています。<code>author</code>や<code>editor</code>などのsemanticタグを使うそれらのドキュメントで、リファレンスをマークアップすることができます。
	</para>
      </section>
      <section id="introglossary">
	<name>Glossaryタグ</name>
	<para id="p2">　テキストブックにはよく、巻末に用語のリスト（索引）があります。同じように、<code>glossary</code>タグはモジュールの最後に、定義のリストを含みます。これは<code>term</code>タグを用いて、これらの定義にリンクしています（<cnxn target="linking_to_definitions"/>を見てください）。
	  
	</para>
      </section>
    </section>

    <section id="gloosarymore">
      <name>Glossaryを含める</name>
      <para id="cnxml_glossary">　CNXMLドキュメントにglossaryを含めるのは簡単です。<cnxn document="m9000">Basic CNXML
	Tutorial</cnxn>では構造は通常以下のようになっていると述べられています。

	<list id="structure">
		<name>Document</name>
		<item><code>name</code></item>
		<item><code>metadata</code>(optional)</item>
		<item><code>content</code></item>
	</list>

　glossaryを追加したいとき、構造は以下に合わせて変化するでしょう。

	<list id="structure2">
		<name>Document</name>
		<item><code>name</code></item>
		<item><code>metadata</code>(optional)</item>
		<item><code>content</code></item>
		<item><code>glossary</code></item>
	</list>
　glossaryタグの内部では、追加したいだけ定義を追加することができます。definitionタグについての詳しい情報は、<link src="http://cnx.rice.edu/technology/cnxml/0.5/spec">CNXML 0.5 specification</link>を見てください。
      </para>

      <example id="glossary_example">
	<name>Glossary Example</name>
	<para id="glossary_examplepara">
	  Following is an example of the code necessary to add a
	  glossary with one definition.
	  <code type="block">
<![CDATA[<glossary>
  <definition id='quardef'>
    <term>quarter</term>
    <meaning><name>Meaning Name</name>One fourth of something.</meaning>
    <example id='def'>
      <para id='par'>
	"He cut the pie into quarters and gave all four people a
	piece."
      </para>
    </example>
    <meaning>25 cents, a quarter of a dollar.</meaning>
    <example id='def2'>
      <para id='par2'>
	"The drink cost a quarter."
      </para>
    </example>
    <example id='def3'>
      <para id='par3'>
	"She picked up a roll of quarters so that she could do
	laundry."
      </para>
    </example>
  </definition>
</glossary>]]>
	  </code>
	</para>
      </example>

      <example id="linking_to_definitions">
	<name>Linking to Definitions in a Glossary</name>
	<para id="linkingdef">
	  Often, one will need to refer to a definition in the
	  glossary. To do this, one can use the <code>term</code>
	  tag. By putting the <code>src</code> attribute in the term
	  tag, one can link to a definition. Simply set the value of
	  the <code>src</code> attribute to the <code>id</code> of the
	  definition in the glossary, and that term will automatically
	  become a link to the definition in the glossary. Shown below
	  is an example of the term tag being used to link to the
	  definition in the <cnxn target="glossary_example">definition
	  example</cnxn>:
	  <code type="block">
	    <![CDATA[<term src='#quardef'>quarter</term>]]>
	  </code>
	</para>
      </example>
    </section>      

    <section id="including_bibtexml">
      <name>BibteXMLを含める</name>
      <para id="cnxml_bibtexml">　CNXMLドキュメントにbibteXMLリファレンスセクションを含めるのは簡単です。<cnxn document="m0000">Basic CNXML
	Tutorial</cnxn>では構造は通常以下のようになっていると述べられています。

	<list id="structure3">
		<name>Document</name>
		<item><code>name</code></item>
		<item><code>metadata</code>(optional)</item>
		<item><code>content</code></item>
	</list>
　bibteXMLリファレンスセクションを追加したいとき、構造は以下に合わせて変化するでしょう。

	<list id="structure4">
		<name>Document</name>
		<item><code>name</code></item>
		<item><code>metadata</code>(optional)</item>
		<item><code>content</code></item>
		<item><code>glossary</code></item>
		<item><code>file</code></item>
	</list>
	<note>
　glossary、bibteXML、もしくは両方のファイルを含めることは可能です。唯一の制限は、両方のファイルを入れる場合、glossaryが先にならないといけないことです。
	</note>
　<code>file</code>タグはbibteXML言語のルートのタグです。fileタグ内部では、図書目録の異なった種類に対応する他のタグを追加することができます。図書目録に関する例を以下に示します。
      </para>
      <example id="bibtex_example">
	<name>BibteXML Example</name>
	<para id="bibtex_examplepara">
	  <code type="block">
<![CDATA[<bib:file>
  <bib:entry id="esbensen">
    <bib:book>
      <bib:author>Kim Esbensen; Tonje Midtgaard; Suzanne Schonkopf</bib:author>
      <bib:title>Multivariate Analysis in Practice</bib:title>
      <bib:publisher>Camo AS</bib:publisher>
      <bib:year>1994</bib:year>
      <bib:address>Trondheim</bib:address>
    </bib:book>
  </bib:entry>

  <bib:entry id="martens.nes">
    <bib:book>
      <bib:author>Harald Martens; Tormod Nas</bib:author>
      <bib:title>Multivariate Calibration</bib:title>
      <bib:publisher>John Wiley &amp; Sons Ltd.</bib:publisher>
      <bib:year>1989</bib:year>
      <bib:address>Chichester</bib:address>
    </bib:book>
  </bib:entry>
</bib:file>]]>
	  </code>
	  <note>例のコードの各タグは、ネームスペースプリフィックスで始まっています。bibteXMLの場合では、プリフィックスは<code>bib:</code>です。
	  </note>
	</para>
      </example>

      <example id="linking_to_bibliography">
	<name>Linking to Bibliography</name>
	<para id="linkingbib">
	  You will want to refer to an entry in the bibliography. To
	  do this, one can use the <code>cite</code> tag. By putting
	  the <code>src</code> attribute in the cite tag, one can link
	  to a bibliographic entry. Simply set the value of the
	  <code>src</code> attribute to the <code>id</code> of the
	  <code>bib:entry</code>, and that reference will automatically
	  become a link to the bibliographic entry. Shown below
	  is an example of the cite tag being used to link to the
	  bibliography in <cnxn target="bibtex_example"/>:
	  <code type="block">
	    <![CDATA[<cite src='#esbensen'>Multivariate Analysis in Practice</cite>]]>
	  </code>
	</para>
      </example>
      <section id="bibteXMLtags">
	<name>BibteXMLタグ</name>
	<para id="bibteXMLtagspara">　<cnxn target="bibtex_example"/>を見ることによって、bibteXML内で使用可能なタグの種類を見ることができます。以下に、bibteXMLタグの使用についての簡単な説明をします。より詳しい情報は、<link src="http://bibtexml.sourceforge.net/">BibteXMLホームページ</link>を見てください。</para>
	<section id="file">
	  <name>File</name>
	  <para id="file_para">　<code>file</code>タグはbibteXML言語のルートタグです。それは図書目録の始まりを指示しています。
	  </para>
	  <para id="file_para2">
	<name>Children</name>
　<code>file</code>タグは1つ以上の<code><cnxn target="entry">entry</cnxn></code>タグを含まなければなりません。
	  </para>
	</section>
	<section id="entry">
	  <name>Entry</name>
	  <para id="entry1">
　<code>entry</code>タグは個々の参照の始まりを指示しています。
	  </para>
	  <para id="entry2">
	<name>Children</name>
　<code>entry</code>タグは以下のcontainersを1つ含まなければなりません。

	    <list id="entry_children">
		<item>article</item>
		<item>book</item>
		<item>booklet</item>
		<item>manual</item>
		<item>techreport</item>
		<item>mastersthesis</item>
		<item>phdthesis</item>
		<item>inbook</item>
		<item>incollection</item>
		<item>proceedings</item>
		<item>inproceedings</item>
		<item>conference</item>
		<item>unpublished</item>
		<item>misc</item>
	</list>
</para>
	</section>

	<section id="containers">
	  <name>Containers</name>
	  <para id="contain_para">　<code>entry</code>で使用可能な各子要素（article、book、bookletなど）は、その特定の種類のentryに関するメタデータのcontainersです。
	  </para>
	  <para id="container_children">
	<name>Children</name>
　containerタグはbibteXML<code><cnxn target="metadata_tags">metadata</cnxn></code>タグの異なった結合を含まなければなりません。詳しい情報は、<link src="http://bibtexml.sourceforge.net/">BibteXMLホームページ</link>.を見てください。
	  </para>
	</section>
	<section id="metadata_tags">
	  <name>BibteXML Metadata Tags</name>
	  <para id="para1meta">　<code><cnxn target="entry">entry</cnxn></code>の可能な子要素としてリストアップされたすべての子要素は、metadataタグを含むことができます。これれのmetadataタグを以下にリストアップされます。
	    <list id="meta_list">
		<name>Metadata Tag List</name>
		<item>address</item>
		<item>author</item>
		<item>booktitle</item>
		<item>chapter</item>
		<item>edition</item>
		<item>editor</item>
		<item>howpublished</item>
		<item>institution</item>
		<item>journal</item>
		<item>month</item>
		<item>note</item>
		<item>number</item>
		<item>organization</item>
		<item>pages</item>
		<item>publisher</item>
		<item>school</item>
		<item>series</item>
		<item>title</item>
		<item>type</item>
		<item>volume</item>
		<item>year</item>
	</list>
</para>
	  <para id="para2meta">
	<name>Children</name>
　すべてのmetadataタグはユニコードのテキストを含むことができます。</para>
	</section>
      </section>
    </section>
  </content>

   <glossary>
    <definition id="quardef">
      <term>quarter</term>
      <meaning><name>Meaning Name</name>One fourth of something.</meaning>
      <example id="def">
	<para id="par">
	  "He cut the pie into quarters and gave all four people a
	  piece."
	</para>
      </example>
      <meaning>25 cents, a quarter of a dollar.</meaning>
      <example id="def2">
	<para id="par2">
	  "The drink cost a quarter."
	</para>
      </example>
      <example id="def3">
	<para id="par3">
	  "She picked up a roll of quarters so that she could do
	  laundry."
	</para>
      </example>
    </definition>
  </glossary>
  
   <bib:file>
	      <bib:entry id="esbensen">
      <bib:book>
	<bib:author>Kim Esbensen; Tonje Midtgaard; Suzanne Schonkopf</bib:author>
	<bib:title>Multivariate Analysis in Practice</bib:title>
	<bib:publisher>Camo AS</bib:publisher>
	<bib:year>1994</bib:year>
	<bib:address>Trondheim</bib:address>
      </bib:book>
    </bib:entry>

    <bib:entry id="martens.nes">
      <bib:book>
	<bib:author>Harald Martens; Tormod Nas</bib:author>
	<bib:title>Multivariate Calibration</bib:title>
	<bib:publisher>John Wiley &amp; Sons Ltd.</bib:publisher>
	<bib:year>1989</bib:year>
	<bib:address>Chichester</bib:address>
      </bib:book>
    </bib:entry>
  </bib:file>

</document>
