/usr/share/doc/refdb/refdb-manual/ch07s04.html is in refdb-doc 1.0.2-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Writing risx datasets</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch07.html" title="Chapter 7. Data input" /><link rel="prev" href="ch07s03.html" title="Input filters" /><link rel="next" href="ch07s05.html" title="Writing extended notes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing risx datasets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07s03.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Data input</th><td width="20%" align="right"> <a accesskey="n" href="ch07s05.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect1-writing-risx"></a>Writing risx datasets</h2></div></div></div><p>XML documents using the <a class="ulink" href="http://refdb.sourceforge.net/risx/index.html" target="_top">risx DTD</a> 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.</p><p>This section provides a quick outline of risx datasets. For a description of all available elements and their relationships, please visit the <a class="ulink" href="http://refdb.sourceforge.net/risx/index.html" target="_top">risx documentation</a>.</p><p>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:</p><pre class="programlisting"><?xml version="1.0" encoding="utf-8"?></pre><p>The top-level element of a risx XML document is either <code class="sgmltag-element">ris</code> (if the file provides multiple datasets) or <code class="sgmltag-element">entry</code>, which corresponds to a single dataset. The <code class="sgmltag-element">ris</code> element holds one or more <code class="sgmltag-element">entry</code> elements. The <code class="sgmltag-attribute">type</code> attribute specifies the type of the reference. These are the same types as described above for the RIS <a class="link" href="ch07.html#ris-typetag">TY tag</a>. The <code class="sgmltag-attribute">id</code> and <code class="sgmltag-attribute">citekey</code> 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.</p><p>Each <code class="sgmltag-element">entry</code> element contains up to five subelements, the first three of which provide the bibliographic information proper. risx distinguishes three levels of bibliographic information. Each <code class="sgmltag-element">entry</code> can specify one or more of these levels:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>The <code class="sgmltag-element">part</code> element corresponds to the analytical level of bibliographic information. This element specifies the information of a work that has been published as a part of a publication. This can be a journal article in a periodical, or a chapter in a book. The <code class="sgmltag-element">part</code> element usually contains information about the authors and the title of the part, as well as volume, issue, and page information.</p></li><li class="listitem"><p>The <code class="sgmltag-element">publication</code> element corresponds to the monographic level. This is essentially an individual item that you can find on the shelves of a library, like a book or a journal. The <code class="sgmltag-element">publication</code> element contains information about the authors/editors and the title of the items.</p></li><li class="listitem"><p>The <code class="sgmltag-element">set</code> element corresponds to the series level. This provides information about individual items that have been published as a part of a series, like a book about cats within a series of books about mammals. This element usually adds the information about the title of the series and the series editors.</p></li></ul></div><p>Please refer to the <a class="ulink" href="http://refdb.sourceforge.net/risx/index.html" target="_top">risx documentation</a> for further details about the structure of these elements.</p><p>The <code class="sgmltag-element">libinfo</code> element contains the local "housekeeping" information of a particular user. Each dataset may contain <code class="sgmltag-element">libinfo</code> elements of one or more users who are specified with the <code class="sgmltag-attribute">user</code> attribute. Use this element to specify the notes, the reprint status, and the availability information.</p><p>The <code class="sgmltag-element">contents</code> element specifies, you've guessed right, the contents of the reference, i.e. an abstract and an unlimited number of keywords for indexing purposes.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch07.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Input filters </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Writing extended notes</td></tr></table></div></body></html>
|