/usr/share/doc/refdb/refdb-manual/ch10.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 10. Bibliographies</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="pt03.html" title="Part III. User manual" /><link rel="prev" href="ch09s06.html" title="To share or not to share extended notes" /><link rel="next" href="ch10s02.html" title="Manage bibliography styles" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 10. Bibliographies</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch09s06.html">Prev</a> </td><th width="60%" align="center">Part III. User manual</th><td width="20%" align="right"> <a accesskey="n" href="ch10s02.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="chapter-bibliographies"></a>Chapter 10. Bibliographies</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="ch10.html#sect-biblio-quickstart">Quickstart guide</a></span></dt><dt><span class="sect1"><a href="ch10s02.html">Manage bibliography styles</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch10s02.html#idp64316992">Write or modify a bibliography style file</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch10s03.html">Create SGML and XML bibliographies</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch10s03.html#sect-refdbnd-shortcut">Keeping it simple with refdbnd</a></span></dt><dt><span class="sect2"><a href="ch10s03.html#sect-low-level-bibliographies">Bibliographies, the hard way</a></span></dt><dt><span class="sect2"><a href="ch10s03.html#sect3-customize-bib">How to use custom stylesheets</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch10s04.html">Create LaTeX/BibTeX bibliographies</a></span></dt><dt><span class="sect1"><a href="ch10s05.html">Create RTF bibliographies</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch10s05.html#sect-create-rtf">Create a RTF document for use with RefDB</a></span></dt><dt><span class="sect2"><a href="ch10s05.html#sect-cite-rtf">Create citations in word processor documents</a></span></dt><dt><span class="sect2"><a href="ch10s05.html#sect-process-rtf">Process RTF documents</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch10s06.html">Using custom stylesheets to process documents with bibliographies</a></span></dt></dl></div><p>The bibliography is the <span class="emphasis"><em>really</em></span> hard part of writing a scientific manuscript or a thesis, much harder than generating the data in the first place. This is why RefDB tries to help you with this task as much as possible.</p><p>RefDB's job is to provide two kinds of information:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>the bibliographic data</p></li><li class="listitem"><p>styling information according to a bibliography and citation style</p></li></ul></div><p>If the default rendering of citations and bibliographies in the DocBook or TEI stylesheets is appropriate for your purposes, you can get away with using RefDB as a source for raw bibliographies. However, if your output is supposed to match the requirements of a particular journal or publisher, you'll need the styling information as well. There are literally thousands of possible combinations for the formatting of authors, titles, journal names, page and date informations, and almost each of these possiblilities has been adopted by at least one journal or publisher as the one and only citation and bibliography style. The format of the RefDB bibliography styles is described in the first section. The next section will then explain how you generate bibliographies and format your documents.</p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect-biblio-quickstart"></a>Quickstart guide</h2></div></div></div><p>These are the essential steps to publish documents with formatted citations and a formatted bibliography:</p><div class="procedure"><ol class="procedure" type="1"><li class="step"><p>Load one or more bibliography styles into your RefDB database, using the <a class="link" href="re06.html#app-a-command-addstyle" title="addstyle">addstyle</a> command (this is usually done automatically during post-installation setup, see <a class="link" href="re09.html" title="refdb-init">refdb-init</a>).</p></li><li class="step"><p>The bibliography will eventually be available as a separate file (see below). SGML and XML documents have to <a class="link" href="ch10s03.html#sect-prepare-doc" title="Prepare the document">include</a> this file, either as an external entity or via xinclude. LaTeX or RTF documents need no special care at this point.</p></li><li class="step"><p>Insert citations into your document, preferrably using the <a class="link" href="ch10s03.html#sect-short-notation" title="Short notation">short notation</a> for SGML/XML documents. LaTeX documents use the regular bibtex commands, whereas RTF uses a <a class="link" href="ch10s05.html#sect-cite-rtf" title="Create citations in word processor documents">plain-text citation format</a>.</p></li><li class="step"><p>Run the appropriate commands to create the bibliography and to transform the document. For <a class="link" href="ch10s03.html#sect-refdbnd-shortcut" title="Keeping it simple with refdbnd">SGML, XML, and RTF documents</a> this may be as easy as running <span class="command"><strong>make pdf</strong></span>, whereas LaTeX users have to run <a class="link" href="ch10s05.html" title="Create RTF bibliographies">one extra command</a> in addition to the usual bibtex procedure.</p></li></ol></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch09s06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch10s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">To share or not to share extended notes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Manage bibliography styles</td></tr></table></div></body></html>
|