
JReference (version see VERSION.txt)

This package consists of the following file:

  mysql.jar       -> Java MySQL ODBC driver
  aelfred.jar     -> XML parser
  sax.jar         -> SAX interface to XML parser

  INSTALL         -> Installation notes
  LICENSE         -> License of references.jar (only, license of other jar files is
                     given in those jar files)

  jreferences.dtd -> Document Type Definition to which the references.dbx file must
                     comply

  More information can be found at the JReference homepage:

    http://www.openscience.org/~egonw/jreference/

  The expected DocBook references file must look like this (an example
  is included in this distribution):

<?xml version="1.0"?>
<bibliography>
  <title>References</title>

  <bibliodiv><title>Journals</title>
 
    <biblioentry>
      <abbrev>JCODE</abbrev>
      <title>Full Title of Journal</title>
      <titleabbrev>J.Abbrev.</titleabbrev>
    </biblioentry>

  </bibliodiv>

  <bibliodiv><title>Articles</title>
  
    <biblioentry>
      <biblioset relation="journal"><abbrev>JCODE</abbrev></biblioset>
      <biblioset relation="article">
	<title>Article's Title</title>
	<authorgroup>
          <author>
	    <firstname>First</firstname>
	    <surname>Author</surname>
	  </author>
          <author>
	    <firstname>Second</firstname>
	    <surname>Author</surname>
	  </author>
	</authorgroup>
	<volumenum>journal_volume</volumenum>
	<pagenums>244-255</pagenums>
	<pubdate>1992</pubdate>
      </biblioset>
    </biblioentry>

 </bibliodiv>
</bibliography>

  
  You can use NumberReferences to autonumber references, given a document with the following syntax:

<article>

  <jref:mode>number</jref:mode>

  <!-- this would result in [1] like numbering. List of possibilities:

       Number                [1], [2] etc
       NumberSuperScript     <superscript>1</superscript> etc
       ArticleCode           [Steinbeck99] etc
       DocBookRefs           <xref linkend="ART_Steinbeck99"/>

    -->

  <artheader>
    <title>Test Article</title>
    <author><firstname>Egon</firstname><surname>Willighagen</surname></author>
    <date> 3 May 2000</date>
  </artheader>
 
  <section>
    <title>Some section</title>
    <para>This is a text with a reference<jref:ref id="Steinbeck99"/>.</para>
  </section>
 
  <jref:reflist/>
 
</article>

  Like with GetReferences, these references are taken from a ODBC database.
  NumberReferences recognizes these two macro's:

  jref:ref     -> place a reference here. The element is replaced by <superscript>#</superscript>.
  jref:reflist -> place the list of references here. References are stored in a seperate section.

  Try for example:

     make number 

  This runs NumberReferences on the input.dbx document in the distribution. (Replace the article
  code by a code which is given in your database.)

-----------------------

Egon Willighagen (August 15th 2000)
