Skip to content Skip to navigation Skip to collection information

OpenStax_CNX

You are here: Home » Content » Connexions Tutorial and Reference (Japanese version) » CNXML Reference Extensions

Navigation

Recently Viewed

This feature requires Javascript to be enabled.
 

CNXML Reference Extensions

Module by: Adan Galvan, Hironori Takaryo, Connexions. E-mail the authors

Based on: CNXML Reference Extensions by Adan Galvan

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

Warning:

This module contains Connexions documentation which is out-of-date. The contents of this module are provided here for historical purposes only and should not be considered accurate for the current version of the Connexions website. The current (English-language) version of this module can be located at http://cnx.org/content/m11215/latest/. If you have any additional questions or cannot find the answer to your question, please contact techsupport@cnx.org and we will be happy to assist in any way we can.

If you would like to assist Connexions by helping us update this module with an appropriate translation from the current English version, please contact us at cnx@cnx.org as we would appreciate your help with improving our support for non-English-speaking users.

はじめに

 著者や編集者として、あなたは時々、実際はテキストに現れないドキュメント内の追加情報を含める方法が必要になるかもしれません。この情報は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バージョンであることを、これは意味しています。authoreditorなどのsemanticタグを使うそれらのドキュメントで、リファレンスをマークアップすることができます。

Glossaryタグ

 テキストブックにはよく、巻末に用語のリスト(索引)があります。同じように、glossaryタグはモジュールの最後に、定義のリストを含みます。これはtermタグを用いて、これらの定義にリンクしています(Example 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を見てください。

Example 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>
	  

Example 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

Note:

 glossary、bibteXML、もしくは両方のファイルを含めることは可能です。唯一の制限は、両方のファイルを入れる場合、glossaryが先にならないといけないことです。
 fileタグはbibteXML言語のルートのタグです。fileタグ内部では、図書目録の異なった種類に対応する他のタグを追加することができます。図書目録に関する例を以下に示します。

Example 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>
	  

Note:

例のコードの各タグは、ネームスペースプリフィックスで始まっています。bibteXMLの場合では、プリフィックスはbib:です。

Example 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 Example 3:


	    <cite src='#esbensen'>Multivariate Analysis in Practice</cite>
	  

BibteXMLタグ

 Example 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タグはユニコードのテキストを含むことができます。

Glossary

quarter:
1. Meaning Name: One fourth of something.

Example:

"He cut the pie into quarters and gave all four people a piece."

2. 25 cents, a quarter of a dollar.

Example:

"The drink cost a quarter."

Example:

"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.

Collection Navigation

Content actions

Download:

Collection as:

PDF | EPUB (?)

What is an EPUB file?

EPUB is an electronic book format that can be read on a variety of mobile devices.

Downloading to a reading device

For detailed instructions on how to download this content's EPUB to your specific device, click the "(?)" link.

| More downloads ...

Module as:

PDF | EPUB (?)

What is an EPUB file?

EPUB is an electronic book format that can be read on a variety of mobile devices.

Downloading to a reading device

For detailed instructions on how to download this content's EPUB to your specific device, click the "(?)" link.

| More downloads ...

Add:

Collection to:

My Favorites (?)

'My Favorites' is a special kind of lens which you can use to bookmark modules and collections. 'My Favorites' can only be seen by you, and collections saved in 'My Favorites' can remember the last module you were on. You need an account to use 'My Favorites'.

| A lens I own (?)

Definition of a lens

Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

Who can create a lens?

Any individual member, a community, or a respected organization.

What are tags? tag icon

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

| External bookmarks

Module to:

My Favorites (?)

'My Favorites' is a special kind of lens which you can use to bookmark modules and collections. 'My Favorites' can only be seen by you, and collections saved in 'My Favorites' can remember the last module you were on. You need an account to use 'My Favorites'.

| A lens I own (?)

Definition of a lens

Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

Who can create a lens?

Any individual member, a community, or a respected organization.

What are tags? tag icon

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

| External bookmarks