/usr/share/doc/refdb/refdb-manual/ch08s10.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>Use pdfroot</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="ch08.html" title="Chapter 8. Reference management" /><link rel="prev" href="ch08s09.html" title="Character encoding issues" /><link rel="next" href="ch08s11.html" title="Interaction with external applications" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Use pdfroot</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch08s09.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Reference management</th><td width="20%" align="right"> <a accesskey="n" href="ch08s11.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-pdfroot"></a>Use pdfroot</h2></div></div></div><p>The <code class="varname">pdfroot</code> variable allows you to store the paths to PDF or Postscript offprints of your references in a more efficient and more flexible way than a full path.</p><p>The L1 field of a reference can hold the path to an electronic version of the document. This path will be converted into a link in the HTML output, and the neat plan is to open the document the link points to with a simple mouseclick. If you just store the full path of this document, something like <code class="filename">file:///home/markus/literature/5503.pdf</code>, you may run into problems fairly soon: If you have to reorganize the folder structure in your directory tree, all paths in the database would be incorrect. If you access the database from a different computer as the one that physically stores your offprints, you will be out of luck with these paths as well.</p><p>The idea is to store the invariable part of the path in the reference entry and any variable part of the path in the <code class="varname">pdfroot</code> variable. The <code class="varname">pdfroot</code> variable can be set either in your configuration file or with a command line option. Consider e.g. the following situation: You decide for some obscure reason to store the offprints in subdirectories according to the publication year. The full paths will thus be something like <code class="filename">/home/markus/literature/1999/2345.pdf</code> and <code class="filename">/home/markus/literature/2001/6213.ps</code>. The partial paths in the L1 field of the reference entry could then be set to <code class="filename">file://1999/2345.pdf</code> and <code class="filename">file://2001/6213.ps</code>, whereas the correct value for the <code class="varname">pdfroot</code> would be <code class="filename">/home/markus/literature/</code>. Simple concatenation by RefDB will then result in the proper full path.</p><p>If you now decide to rearrange your hard drive, all you need to do is to set <code class="varname">pdfroot</code> properly, as long as you don't change the directory structure below <code class="filename">/literature</code> (if you do <span class="emphasis"><em>that</em></span>, you shoot yourself in the foot anyway).</p><p>If you want to access your offprints from a different computer, you have several options:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>You can mount the directory tree that actually holds the data. If the computer that stores your offprints e.g. exports <code class="filename">/home</code> as an NFS share, you could mount that to <code class="filename">/mnt</code> on your local computer. Then you can set <code class="varname">pdfroot</code> to <code class="filename">/mnt/markus/literature/</code> to access your offprints.</p></li><li class="listitem"><p>You can store the offprints in a location that is accessible with an internet protocol like <acronym class="acronym">HTTP</acronym> or <acronym class="acronym">FTP</acronym>. In that case it is most practical to just store the full URL in the L1 field, as in <code class="filename">http://some.machine/literature/Miller1999.pdf</code>.</p></li></ul></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch08s09.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch08.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch08s11.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Character encoding issues </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Interaction with external applications</td></tr></table></div></body></html>
|