/usr/share/doc/refdb/refdb-manual/ch01s06.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>Bibliography tool features</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="ch01.html" title="Chapter 1. Introduction" /><link rel="prev" href="ch01s05.html" title="Reference management features" /><link rel="next" href="ch01s07.html" title="Credits" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Bibliography tool features</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s05.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="ch01s07.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp66244848"></a>Bibliography tool features</h2></div></div></div><p>Bibliography support is currently implemented for DocBook SGML and XML documents, TEI and TEILite XML documents, and for LaTeX documents.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp66246176"></a>SGML and XML</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>RefDB scans your input document for citations and generates a bibliography which contains the cited references. You can include this bibliography into your document and process it with RefDB's tools to obtain formatted citations and bibliographies.</p></li><li class="listitem"><p>RefDB creates bibliographies for DocBook (SGML, DTD-based XML, and schema-based XML), TEI (DTD-based XML and schema-based XML), and bibtex.</p></li><li class="listitem"><p>The implementation of the SGML/XML citations and bibliographies is "non-destructive", i.e. switching from one bibliographic output format to a different one is limited to re-creating the bibliography and transforming your document again.</p><p>Alternatively you may use a short notation for your citations that makes do with a minimum of markup. The short notation needs an additional (but fully reversible) preprocessing step before bibliographies and formatted output can be created.</p></li><li class="listitem"><p>RefDB uses <span class="quote">“<span class="quote">cooked</span>”</span> bibliography output to provide full control over the formatting. This somewhat blurs the distinction between structure and formatting but it is the most efficient way to handle the task of formatting bibliographies and citations. The TEI bibliography output is even worse as it heavily abuses the all-purpose <code class="sgmltag-element">seg</code> element as a wrapper where the elements intended for a particular purpose do not allow a <span class="quote">“<span class="quote">cooked</span>”</span> use.</p></li><li class="listitem"><p>Alternatively you can request <span class="quote">“<span class="quote">raw</span>”</span> bibliography output. In this case you can either rely on the default bibliography formatting provided by the stock DocBook or TEI stylesheet, or you resort to other bibliography formatting tools.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp66255616"></a>LaTeX</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>The BibTeX output integrates seamlessly with the LaTeX/BibTeX tools, so there is only one additional command to run on your way from the LaTeX source to the finished document.</p></li><li class="listitem"><p>RefDB creates a BibTeX bibliography file based on the information in a <code class="filename">.aux</code> file. The latter is created by <span class="command"><strong>latex</strong></span> from the LaTeX source document. This intermediate bibliography file serves as the input file for <span class="command"><strong>bibtex</strong></span>. So instead of keeping all your references in a flat text file, RefDB will create a short bibliography file with the references that your particular document requires.</p></li><li class="listitem"><p>RefDB performs only a very limited amount of formatting for those items which are not well supported in BibTeX (e.g. with BibTeX you need two separate bibliography files if you switch from a format that uses abbreviated journal names to a format that requires the full names). All other formatting is left to the LaTeX/BibTeX system.</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="ch01s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Reference management features </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Credits</td></tr></table></div></body></html>
|