/usr/share/doc/refdb/refdb-manual/ch18.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>Chapter 18. RIS and risx format specifications</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="pt05.html" title="Part V. Programmer's manual" /><link rel="prev" href="ch17s05.html" title="The table POSITION" /><link rel="next" href="ch18s02.html" title="The risx DTD" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 18. RIS and risx format specifications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch17s05.html">Prev</a> </td><th width="60%" align="center">Part V. Programmer's manual</th><td width="20%" align="right"> <a accesskey="n" href="ch18s02.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="chapter-ris-risx-format"></a>Chapter 18. RIS and risx format specifications</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="ch18.html#idp67187024">The RefDB RIS implementation</a></span></dt><dt><span class="sect1"><a href="ch18s02.html">The risx DTD</a></span></dt></dl></div><p>In general, RefDB tries to stick as closely as possible to the RIS format specification of the <a class="ulink" href="http://www.risinc.com" target="_top">Reference Manager</a> software version 8 (this is the most recent version I was working with). This chapter briefly recalls the general syntax of RIS and risx files and the few differences in the implementation between Reference Manager and RefDB.</p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp67187024"></a>The RefDB RIS implementation</h2></div></div></div><p>Import from Reference Manager and similar bibliographic databases as well as export should work in general, although it is not always loss-free due to the varying degree of support for the full RIS specification. This chapter briefly summarizes the differences between the Reference Manager RIS specification and what RefDB uses.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>In contrast to the mainly Windows-based bibliographic databases, RefDB expects the RIS files with UNIX line endings (LF = 0x0A). Most online sources allow to download the files in this format. The RefDB package also contains a <a class="link" href="re18.html" title="refdb_dos2unix"><code class="filename">refdb_dos2unix</code></a> shell script which converts the line endings from DOS format to UNIX format (you may use your favourite perl or whatever program instead, of course).</p></li><li class="listitem"><p>In Reference Manager, the number of authors/editors/series authors per reference is limited to 255. Although this may not have any practical consequences, RefDB does not have this restriction.</p></li><li class="listitem"><p>The same holds true for keywords. In RefDB the number of keywords per reference is not limited.</p></li><li class="listitem"><p>Some of the tags defined in the RIS format specification have synonyms. RefDB does not use these randomly upon output of RIS datasets, but uses a defined subset. This subset may be a different one than Reference Manager uses. This should have no practical consequences for the data integrity, although this means that after shuffling datasets between the two databases different synonymous tags may be used.</p></li><li class="listitem"><p>The BT/T2 field is limited to 16KB in Reference Manager. It is limited to 64KB in RefDB.</p></li><li class="listitem"><p>A couple of fields in a Reference Manager database have either <span class="quote">“<span class="quote">no practical length limit</span>”</span> or the length limit is not specified at all. As these field lengths are not exactly given in SI units, I can just list what the corresponding limits in RefDB are: PY/Y1, Y2 are limited to 255 characters starting from the first slash (i.e. excluding the year information), TI/T1/CT, IS/CP, BT/T2, T3, AD are limited to 64KB, AB and N1 are limited to 16MB. I assume that none of these poses a <span class="quote">“<span class="quote">practical length limit</span>”</span>. If you should plan to exceed these limits, you can of course recompile refdbd and use up to the maximum field length that the database server offers (e.g. 4GB in MySQL).</p></li></ul></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch17s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch18s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The table POSITION </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> The risx DTD</td></tr></table></div></body></html>
|