/usr/share/doc/refdb/refdb-manual/ch14s02.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>Reference data output formats</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="ch14.html" title="Chapter 14. Tools for reference and notes management" /><link rel="prev" href="re19.html" title="refdb_latex2utf8txt" /><link rel="next" href="ch14s03.html" title="Extended notes output formats" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Reference data output formats</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re19.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Tools for reference and notes management</th><td width="20%" align="right"> <a accesskey="n" href="ch14s03.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect-output-formats"></a>Reference data output formats</h2></div></div></div><p>refdbd implements several standard backends for data output. You can select them with the <code class="option">-t</code> option of the <a class="link" href="re11.html#app-c-command-getref" title="getref"><span class="command"><strong>getref</strong></span></a> command in refdbc. Remember that all backends just send data. It is your decision what you want to do with the information. You can either view the data on the screen or pipe them to another application or write them to a disk file.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74517008"></a>scrn</h3></div></div></div><p>The screen backend provides a basic data output for viewing in a terminal, preferably through a pager. By default, the reference ID, the publication year, the authors, the title, and the source information are displayed. You can use the <code class="option">-s</code> option to additionally display the abstract (AB or N2), the notes (N1), the reprint info (RP), the address (AD), the publisher (PB), the city (CY), the ISSN/ISBN (SN), the URL (UR), and the user (U1 through U5) and misc (M1 through M3) fields. In addition, the pseudo-field codes NX (all notes) and LX (all links, including UR and DOI) can be used. To specify several fields, simply concatenate the field codes, as in <code class="option">-s ADPBRP</code>. <code class="option">-s ALL</code> will display all available fields.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-getref-output-html"></a>html</h3></div></div></div><p>The html backend works just like the scrn backend, but encodes this information in a <acronym class="acronym">HTML</acronym> text. This comes in handy if you would like to view the results of your queries in a web browser rather than in a terminal window. This is also the easiest way to obtain fairly nice-looking printed output of your reference data. You simply use the <code class="option">-o</code> switch to write the results of your queries to a file, reusing the same filename for each query. After each query you just have to hit the reload button of your browser to view the results of the most recent query.</p><p>The visual appearance of the generated HTML files can be customized using CSS files. The URL of the CSS file must be specified with the refdbc <code class="option">-G</code> command-line option or by setting the configuration variable <code class="varname">cssurl</code>. The global configuration file <code class="filename">/usr/local/etc/refdb/refdbcrc</code> is preconfigured with a <code class="varname">cssurl</code> entry pointing to the default CSS file installed in <code class="filename">/usr/local/share/refdb/css</code>. If you want a different appearance, it might be prudent to create a copy of this CSS file and customize it as you see fit. The following element classes can be customized. In most cases, the class name reflects the database field to be formatted:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>H1.h1</p></li><li class="listitem"><p>H2.id</p></li><li class="listitem"><p>P.title</p></li><li class="listitem"><p>P.authors</p></li><li class="listitem"><p>P.abstract</p></li><li class="listitem"><p>P.note</p></li><li class="listitem"><p>P.address</p></li><li class="listitem"><p>P.city</p></li><li class="listitem"><p>P.publisher</p></li><li class="listitem"><p>P.m1, P.m2, P.m3</p></li><li class="listitem"><p>P.u1, P.u2, P.u3, P.u4, P.u5</p></li><li class="listitem"><p>P.url</p></li><li class="listitem"><p>EM.periodical</p></li><li class="listitem"><p>EM.volume</p></li><li class="listitem"><p>EM.issue</p></li><li class="listitem"><p>EM.page</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74542160"></a>xhtml</h3></div></div></div><p>This is a variant of the html output which creates valid XML output according to the <a class="ulink" href="http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" target="_top">XHTML V1.0 Transitional DTD</a>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74544336"></a>ris</h3></div></div></div><p>This is identical to the input format. Use it to export references to other reference management systems.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74545776"></a>risx</h3></div></div></div><p>Retrieves the data as an XML document using the <a class="link" href="ch07s04.html" title="Writing risx datasets">risx DTD</a>. Use it to edit references or to create backups of your databases. The default output includes a docline and an internal subset declaring some common entities. This format works ok for DTD-based processing systems. If you require namespaced output for further processing with schema-based tools, use the <code class="option">-n</code> option to declare a namespace prefix.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74548624"></a>mods</h3></div></div></div><p>This backend retrieves the data as an XML document using the <a class="ulink" href="http://www.loc.gov/standards/mods" target="_top">MODS</a> schema. This is another useful exchange format for bibliographic data. Use the <code class="option">-n</code> option to retrieve namespaced output with the given namespace prefix.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74551312"></a>bibtex</h3></div></div></div><p>This backend provides output formatted for use as a bibtex reference database. This can be used with the <span class="application">tex</span> and <span class="application">bibtex</span> applications to create bibliographies for documents written with Donald Knuth's famous <a class="ulink" href="http://www.tug.org" target="_top">TeX</a> typesetting system. The <code class="option">-s</code> option cannot be used with this backend and will be ignored.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74555504"></a>db31</h3></div></div></div><p>The DocBook SGML backend formats the query result as a <code class="sgmltag-element">bibliography</code> element in a SGML document using the DocBook DTD. RefDB outputs an appropriate doctype string at the beginning of the data. The string is commented out so the contents can be directly inserted into a larger document by some processing application. If you need the data as a standalone document, simply use a script to uncomment the first line. The <code class="option">-s</code> option cannot be used with this backend and will be ignored. This option is called <span class="quote">“<span class="quote">db31</span>”</span> to distinguish it from any later additions that may be necessary due to possible incompatibilities in new DocBook versions. It just means that the SGML that this backend creates should work with DocBook V.3.1 or later unless a new backend will be added.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74558864"></a>db31x</h3></div></div></div><p>The output is essentially the same as with the preceeding backend but you'll get a DocBook XML document instead. The default output works for DTD-based processing with DocBook XML versions 4.x. If you need namespaced output for schema-based processing, use the <code class="option">-n</code> option to define a namespace prefix.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74560912"></a>db50x</h3></div></div></div><p>This backend outputs schema-based DocBook V5. The default output declares a default namespace. You can use the <code class="option">-n</code> option to define a namespace prefix which will be used in all elements.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74562864"></a>teix</h3></div></div></div><p>The TEI XML backend formats the query results as a TEI P4 <code class="sgmltag-element">listBibl</code> element. RefDB outputs an appropriate processing instruction and doctype string at the beginning of the data. The string is commented out so the contents can be directly inserted into a larger document by some processing application. If you need the data as a standalone document, simply use a script to uncomment the first line. The <code class="option">-s</code> option cannot be used with this backend and will be ignored.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp74565520"></a>tei5x</h3></div></div></div><p>This backend outputs schema-based TEI P5. The default output declares a default namespace. You can use the <code class="option">-n</code> option to define a namespace prefix which will be used in all elements.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re19.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch14.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch14s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">refdb_latex2utf8txt </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Extended notes output formats</td></tr></table></div></body></html>
|