Introduction As an author/editor, you will often times need a way to include additional information in a document that does not actually appear in the flow of text. This information may include a glossary, and bibliographic references. There are many ways to include this type of information, but for our purposes, we have chosen to create a new CNXML tag named glossary, and have chosen to use an xml language called bibteXML for references. The two are described below. I have also included the glossary and bibteXML file examples in the source of this document. Scroll to the bottom of the page to see how these examples would be rendered.

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." In plain language, this means that bibtexml is an XML version of the popular and widely accepted latex extension bibtex. One can markup references in their document using semantic tags such as author and editor. More info will be provided below.

The 'Glossary' Tag Often in textbooks there will be a list of definitions included at the end of the book. In the same way, the glossary tag will contain a list of definitions that will be included at the end of a module. One can link to these definitions using the term tag (see ).

Including a Glossary It is very easy to include a glossary in your CNXML document. In the Basic CNXML Tutorial it is stated that the structure usually resembles the following: Document name metadata(optional) content When one wishes to add a glossary the structure will change to match the following: Document name metadata(optional) content glossary Inside of the glossary tag one can add as many definitions as one wishes. For more information on the definition tag, see the CNXML 0.5 specification. Glossary Example Following is an example of the code necessary to add a glossary with one definition.



  
    quarter
    Meaning NameOne fourth of something.
    
      
	"He cut the pie into quarters and gave all four people a
	piece."
      
    
    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."
      
    
  
]]>

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:


	    quarter]]>

Including BibteXML It is very easy to include a bibteXML reference section in your CNXML document. In the Basic CNXML Tutorial it is stated that the structure usually resembles the following: Document name metadata(optional) content When one wishes to add a bibteXML reference section the structure will change to match the following: Document name metadata(optional) content glossary file It is possible to include either a glossary or a bibteXML file or both. The only restriction is that if you include both the glossary must precede the bibteXML file. The file tag is the root tag of the bibteXML language. Inside of the file tag one will add other tags that correspond to the different type of bibliographical references. An example of a bibliography is given below: BibteXML Example



  
    
      Kim Esbensen; Tonje Midtgaard; Suzanne Schonkopf
      Multivariate Analysis in Practice
      Camo AS
      1994
      Trondheim
    
  

  
    
      Harald Martens; Tormod Nas
      Multivariate Calibration
      John Wiley & Sons Ltd.
      1989
      Chichester
    
  
]]>

Each tag in the example code begins with a namespace prefix. In the case of bibteXML, the prefix is bib:. 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 :


	    Multivariate Analysis in Practice]]>

BibteXML Tags By looking at one can see the types of tags that are available for use in bibteXML. Below I will attempt to give a brief explanation on the use of some of the bibteXML tags. For more information and the complete specification please see BibteXML Homepage.

File The file tag is the root tag of the bibteXML language. It denotes the beginning of the bibliography. Children The file tag must contain one or more entry tags.

Entry The entry tag denotes the beginning of an individual bibliographical reference. Children The entry must contain one of the following containers: article book booklet manual techreport mastersthesis phdthesis inbook incollection proceedings inproceedings conference unpublished misc

Containers Each of the possible children of entry (article, book, booklet, etc.) are containers for metadata on that specific type of entry. Children Every container tag must contain a different combination of bibteXML metadata tags. For more information on exactly which children a specific container may possess, please see the BibteXMLHomepage.

BibteXML Metadata Tags Every child listed as a possible child of entry can contain metadata tags. These metadata tags are now listed. 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 Every metadata tag can contain unicode text.