Writing risx datasets

XML documents using the risx DTD are an alternative way to add datasets to RefDB databases. You can use your favourite SGML/XML editor to edit these datasets. You can also use DSSSL or XSLT scripts to transform bibliographic data available as SGML or XML documents to risx.

This section provides a quick outline of risx datasets. For a description of all available elements and their relationships, please visit the risx documentation.

As usual, start the document with the processing instructions, followed by the document type declaration. Make sure to include the character encoding if it is different from the default (UTF-8). The other encodings supported by RefDB are UTF-16, ISO-8859-1, and US-ASCII. The first line might then read:

<?xml version="1.0" encoding="utf-8"?>

The top-level element of a risx XML document is either ris (if the file provides multiple datasets) or entry, which corresponds to a single dataset. The ris element holds one or more entry elements. The type attribute specifies the type of the reference. These are the same types as described above for the RIS TY tag. The id and citekey attributes specify a numeric ID (which will only be used if you update references) and a citation key, respectively. The latter should be all uppercase if you intend to use the references with SGML documents.

Each entry element contains up to five subelements, the first three of which provide the bibliographic information proper. risx distinguishes three levels of bibliographic information. Each entry can specify one or more of these levels:

Please refer to the risx documentation for further details about the structure of these elements.

The libinfo element contains the local "housekeeping" information of a particular user. Each dataset may contain libinfo elements of one or more users who are specified with the user attribute. Use this element to specify the notes, the reprint status, and the availability information.

The contents element specifies, you've guessed right, the contents of the reference, i.e. an abstract and an unlimited number of keywords for indexing purposes.