/usr/share/doc/refdb/refdb-manual/ch08s11.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 | <?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>Interaction with external applications</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="ch08.html" title="Chapter 8. Reference management" /><link rel="prev" href="ch08s10.html" title="Use pdfroot" /><link rel="next" href="ch09.html" title="Chapter 9. Notes management" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Interaction with external applications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch08s10.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Reference management</th><td width="20%" align="right"> <a accesskey="n" href="ch09.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp68217344"></a>Interaction with external applications</h2></div></div></div><p>RefDB has been designed to be as modular and as lightweight as possible. This means that you need some external applications for various purposes. This chapter briefly discusses how you can simplify your work with these external applications.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp68218768"></a>Editor</h3></div></div></div><p>If you want to modify references in your database or write new entries from scratch, you need some suitable editor. <a class="ulink" href="http://refdb.sourceforge.net/emacs.html" target="_top">Emacs</a> and <a class="ulink" href="http://refdb.sourceforge.net/vim.html" target="_top">vim</a> can directly interact with RefDB using special modes or support files. Any other editor will do as well as long as it creates the correct line endings: RefDB wants a plain Unix-style LF (0x0A), not a DOS-style CR LF (0x0D 0x0A). The prime contenders are <span class="application">vi</span> and <span class="application">Emacs</span> which are available on almost any Unix-style operating system as well as on Windows. For the Windows platform there are also a number of free- and shareware editors which let you select the line endings.</p><p>Creating new references is straightforward: Type them in, save them, and use refdbc to upload them. If you want to edit existing references in your database, you download them with the <a class="link" href="re11.html#app-c-command-getref" title="getref"><span class="command"><strong>getref</strong></span></a> command to a disk file. Open this file with your editor, edit the contents, and save the file again for uploading. If you want to edit several references in a row, you can simply reuse the filename for downloading, then refresh the buffer in your editor (e.g. <span class="keycap"><strong>C-x C-f RET</strong></span> in Emacs). After saving the changes, simply recall the last upload command in refdbc with the <span class="keycap"><strong>up</strong></span> key and press <span class="keycap"><strong>Enter</strong></span>.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Some editors like <a class="ulink" href="http://refdb.sourceforge.net/emacs.html" target="_top">Emacs</a> and <a class="ulink" href="http://refdb.sourceforge.net/vim.html" target="_top">vim</a> support RefDB by means of add-on packages.</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp68230176"></a>Viewer</h3></div></div></div><p>While a pager will do in many cases to view the query results, a web browser is a nice alternative. The RefDB command <a class="link" href="re11.html#app-c-command-getref" title="getref"><span class="command"><strong>getref</strong></span></a> can generate HTML output at your request with the <code class="option">-t html</code> option. Save the output to a file and view this file with your favourite web browser. When you run the next query, reuse the filename and hit the <span class="guibutton">reload</span> button of your browser to display the new results.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>A web browser is also a convenient way to print references.</p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch08s10.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="ch09.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Use pdfroot </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. Notes management</td></tr></table></div></body></html>
|