Connexions

You are here: Home » Content » CNXML Reference Extensions (日本語 - Japanese)
Content Actions

CNXML Reference Extensions (日本語 - Japanese)

Module by: Adan Galvan, Hironori Takaryo Based on: CNXML Reference Extensions ： Adan Galvan

Summary: A module describing the use of bibtexml with cnxml, as well as as introduction to the glossary tag.

はじめに

　著者や編集者として、あなたは時々、実際はテキストに現れないドキュメント内の追加情報を含める方法が必要になるかもしれません。この情報はglossary、bibliographic referenceを含むかもしれません。このタイプの情報を含める方法はたくさんありますが、私たちの目的のために、私たちはglossaryという名前の新しいCNXMLタグを作成することを選びました。そして、リファレンスのためにbibteXMLと呼ばれるXML言語を使用することを選びました。以下でその2つを説明します。また私はglossayとbibteXMLファイルの例を、このドキュメントのソースに含めました。ページの下までスクロールし、例がどのように表されているか見てください。

BibteXML

"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." [source]
　平たく言えば、bibtexmlがポピュラーで広く受け入れられたlatex extension bibtexのXMLバージョンであることを、これは意味しています。authorやeditorなどのsemanticタグを使うそれらのドキュメントで、リファレンスをマークアップすることができます。

Glossaryタグ

　テキストブックにはよく、巻末に用語のリスト（索引）があります。同じように、glossaryタグはモジュールの最後に、定義のリストを含みます。これはtermタグを用いて、これらの定義にリンクしています（例 2を見てください）。

Glossaryを含める

　CNXMLドキュメントにglossaryを含めるのは簡単です。Basic CNXML Tutorialでは構造は通常以下のようになっていると述べられています。
    Document
  • name
  • metadata(optional)
  • content
　glossaryを追加したいとき、構造は以下に合わせて変化するでしょう。
    Document
  • name
  • metadata(optional)
  • content
  • glossary
　glossaryタグの内部では、追加したいだけ定義を追加することができます。definitionタグについての詳しい情報は、CNXML 0.5 specificationを見てください。
例 1: Glossary Example 
Following is an example of the code necessary to add a glossary with one definition. 
<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>
例 2: Linking to Definitions in a Glossary 
Often, one will need to refer to a definition in the glossary. To do this, one can use the term tag. By putting the src attribute in the term tag, one can link to a definition. Simply set the value of the src attribute to the id 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 definition example: 
	    <term src='#quardef'>quarter</term>

BibteXMLを含める

　CNXMLドキュメントにbibteXMLリファレンスセクションを含めるのは簡単です。Basic CNXML Tutorialでは構造は通常以下のようになっていると述べられています。
    Document
  • name
  • metadata(optional)
  • content
　bibteXMLリファレンスセクションを追加したいとき、構造は以下に合わせて変化するでしょう。
    Document
  • name
  • metadata(optional)
  • content
  • glossary
  • file
注意: 　glossary、bibteXML、もしくは両方のファイルを含めることは可能です。唯一の制限は、両方のファイルを入れる場合、glossaryが先にならないといけないことです。
　fileタグはbibteXML言語のルートのタグです。fileタグ内部では、図書目録の異なった種類に対応する他のタグを追加することができます。図書目録に関する例を以下に示します。
例 3: BibteXML Example 
<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>
注意: 例のコードの各タグは、ネームスペースプリフィックスで始まっています。bibteXMLの場合では、プリフィックスはbib:です。
例 4: Linking to Bibliography 
You will want to refer to an entry in the bibliography. To do this, one can use the cite tag. By putting the src attribute in the cite tag, one can link to a bibliographic entry. Simply set the value of the src attribute to the id of the bib:entry, 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 例 3: 
	    <cite src='#esbensen'>Multivariate Analysis in Practice</cite>

BibteXMLタグ

　例 3を見ることによって、bibteXML内で使用可能なタグの種類を見ることができます。以下に、bibteXMLタグの使用についての簡単な説明をします。より詳しい情報は、BibteXMLホームページを見てください。

File

　fileタグはbibteXML言語のルートタグです。それは図書目録の始まりを指示しています。
Children 　fileタグは1つ以上のentryタグを含まなければなりません。

Entry

　entryタグは個々の参照の始まりを指示しています。
Children 　entryタグは以下のcontainersを1つ含まなければなりません。
  • article
  • book
  • booklet
  • manual
  • techreport
  • mastersthesis
  • phdthesis
  • inbook
  • incollection
  • proceedings
  • inproceedings
  • conference
  • unpublished
  • misc

Containers

　entryで使用可能な各子要素（article、book、bookletなど）は、その特定の種類のentryに関するメタデータのcontainersです。
Children 　containerタグはbibteXMLmetadataタグの異なった結合を含まなければなりません。詳しい情報は、BibteXMLホームページ.を見てください。

BibteXML Metadata Tags

　entryの可能な子要素としてリストアップされたすべての子要素は、metadataタグを含むことができます。これれのmetadataタグを以下にリストアップされます。
    Metadata Tag List
  • address
  • author
  • booktitle
  • chapter
  • edition
  • editor
  • howpublished
  • institution
  • journal
  • month
  • note
  • number
  • organization
  • pages
  • publisher
  • school
  • series
  • title
  • type
  • volume
  • year
Children 　すべてのmetadataタグはユニコードのテキストを含むことができます。
用語集
quarter:
1. Meaning Name: One fourth of something.
例:  
"He cut the pie into quarters and gave all four people a piece."
2. 25 cents, a quarter of a dollar.
例:  
"The drink cost a quarter."
例:  
"She picked up a roll of quarters so that she could do laundry."
References
  1. Kim Esbensen; Tonje Midtgaard; Suzanne Schonkopf. (1994). Multivariate Analysis in Practice. Trondheim: Camo AS.
  2. Harald Martens; Tormod Nas. (1989). Multivariate Calibration. Chichester: John Wiley & Sons Ltd.

Comments, questions, feedback, criticisms?

Discussion forum

Send feedback