/usr/share/doc/refdb/refdb-manual/ch07s05.html is in refdb-doc 1.0.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | <?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 extended notes</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.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="ch07s04.html" title="Writing risx datasets" /><link rel="next" href="ch07s06.html" title="Input data mangling" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing extended notes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07s04.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Data input</th><td width="20%" align="right"> <a accesskey="n" href="ch07s06.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-write-extended-notes"></a>Writing extended notes</h2></div></div></div><p>Both the RIS and the risx formats allow to keep user-supplied notes of unlimited length with each dataset. This is a great way to keep additional explanatory information along with the hard bibliographic data, but this approach is still somewhat limited.</p><p>Extended notes are kept separately from the reference data, but there is a mechanism to link each note to an unlimited number of references, author names, keywords, or periodical names. Possible applications of this feature include:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Write a note about a topic and link it to all references relevant to this topic</p></li><li class="listitem"><p>Keep biographic data or alternative (mis)spellings with author/editor names</p></li><li class="listitem"><p>Store the impact factor, the official web page, or your personal access information to the restricted part of that web page along with a journal name</p></li><li class="listitem"><p>Explain alternative spellings or synonyms of keywords</p></li></ul></div><p>Searching for notes is similar to searching for references. Notes may have keywords, keys, and a title attached to them to easily find them. In addition, you can search for notes that link to a particular reference, author, keyword, or periodical. The inverse works as well: you can search for references that are linked to particular notes.</p><p>Extended notes are XML documents according to the <a class="ulink" href="http://refdb.sourceforge.net/xnote/index.html" target="_top">xnote DTD</a>. The structure of these documents is simple enough to do without a separate 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:</p><pre class="programlisting"><?xml version="1.0" encoding="utf-8"?></pre><p>If you want to write several extended notes in a file, start with an <code class="sgmltag-element">xnoteset</code> element. Each individual extended note is kept in an <code class="sgmltag-element">xnote</code> element. This element carries up to four optional attributes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="sgmltag-attribute">id</code>
</span></dt><dd><p>An unique identifier supplied by the database engine. This attribute is ignored if you add a new note, but it is respected if you update an existing note.</p></dd><dt><span class="term">
<code class="sgmltag-attribute">citekey</code>
</span></dt><dd><p>This is a unique short title or tag which identifies a note unambiguously but is more convenient to remember than the id. If you do not supply a citekey, refdbd will create one based on the username and the date.</p></dd><dt><span class="term">
<code class="sgmltag-attribute">user</code>
</span></dt><dd><p>This is the name of the user that owns the note. If you do not supply a name, refdbd will use the name of the current user, which is most likely what you need anyway.</p></dd><dt><span class="term">
<code class="sgmltag-attribute">date</code>
</span></dt><dd><p>This is a timestamp (YYYY-MM-DD). refdbd will insert the current date if you do not supply this attribute.</p></dd></dl></div><p>An extended note consists of an optional <code class="sgmltag-element">title</code>, the contents proper encoded in a <code class="sgmltag-attribute">content</code> element, zero or more <code class="sgmltag-element">keyword</code> elements, and zero or more <code class="sgmltag-element">link</code> elements. The <code class="sgmltag-element">title</code> is a short description of the note. The <code class="sgmltag-element">keyword</code>s serve the same purpose as in references.</p><p>The <code class="sgmltag-element">content</code> element contains the note proper. The contents of the <code class="sgmltag-element">content</code> element is stored by refdbd as is. It may be plain text or markup. The element uses the following optional attributes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="sgmltag-attribute">type</code>
</span></dt><dd><p>This description of the content type may be used by processing applications to render the contents properly. Store e.g. the MIME type or the name of a DTD/Schema in this attribute.</p></dd><dt><span class="term">
<code class="sgmltag-attribute">xml:lang</code>
</span></dt><dd><p>This attribute specifies the language of the contents.</p></dd></dl></div><p>The <code class="sgmltag-element">link</code> element is used to link the note to one or more references, keywords, author names, or periodicals. The empty element uses two attributes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="sgmltag-attribute">type</code>
</span></dt><dd><p>The type of the link target. This may be one of reference, refid, author, keyword, journalfull, journalabbrev, journalcustabbrev1, journalcustabbrev2.</p></dd><dt><span class="term">
<code class="sgmltag-attribute">target</code>
</span></dt><dd><p>This attribute specifies the database object that the note should be linked to. In the case of a reference, use the ID (type refid) or citation key (type reference). In all other cases, use the name of the author, keyword, or periodical, respectively.</p></dd></dl></div><p>An example set of extended notes is installed into <code class="filename">/usr/local/share/refdb/examples</code>.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07s04.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="ch07s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Writing risx datasets </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Input data mangling</td></tr></table></div></body></html>
|