/usr/share/doc/refdb/refdb-manual/ch10s05.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 3 4 5 6 | <?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>Create RTF 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="ch10.html" title="Chapter 10. Bibliographies" /><link rel="prev" href="ch10s04.html" title="Create LaTeX/BibTeX bibliographies" /><link rel="next" href="ch10s06.html" title="Using custom stylesheets to process documents with bibliographies" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Create RTF bibliographies</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch10s04.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Bibliographies</th><td width="20%" align="right"> <a accesskey="n" href="ch10s06.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-create-rtf-bib"></a>Create RTF bibliographies</h2></div></div></div><p>Rich Text Format (RTF) is a plain-text format understood by most word processors. While RefDB does not integrate into the menu bar of <span class="application">M$ Word</span> or <span class="application">OpenOffice</span>, it still allows you to add bibliographies to word processor documents saved as RTF files. This is a one-way process which leaves your original document untouched. You can edit the compound document and save it to native word processor formats like <code class="filename">.doc</code> or <code class="filename">.odt</code>, but you'll have to start over with the RTF document as soon as you add, change, or remove citations. Therefore the following sequence (which will be familiar to the SGML/XML and LaTeX folks) is recommended when using RefDB to create bibliographies for word processor documents:</p><div class="procedure"><ol class="procedure" type="1"><li class="step"><p class="title"><strong>Author your document</strong></p><p>Write the contents of your document until you're <span class="emphasis"><em>really done</em></span>. Use the citation format described further down. It does not matter which file format you use at this stage, as long as you can export it to RTF in the end.</p></li><li class="step"><p class="title"><strong>Save your document in RTF format</strong></p><p>Now save your document as a RTF file. There may be an extra menu entry called <span class="guimenuitem">Export</span> but usually you can just select the file format in the <span class="guimenuitem">Save as...</span> dialog.</p></li><li class="step"><p class="title"><strong>Create and insert the bibliography</strong></p><p>The exact procedure will be described below. The <a class="link" href="re22.html" title="runbib">runbib</a> command creates a bibliography file, and the <a class="link" href="re26.html" title="refdbrtf">refdbrtf</a> tool combines the source document and the bibliography file to a new compound RTF document. Note that neither your word processor document nor the RTF copy are altered by this procedure.</p></li><li class="step"><p class="title"><strong>Import and finalize your document</strong></p><p>You can now open the compound RTF document using your word processor and add final touches (like adding images which you don't need during the authoring step). You can save the document in a word processor format, print it, or export it as a PDF file.</p></li></ol></div><p>As with <a class="link" href="ch10s03.html" title="Create SGML and XML bibliographies">SGML and XML documents</a>, RTF documents can be maintained in a simple fashion using a <a class="link" href="re21.html" title="refdbnd">refdbnd</a>-created Makefile. The more complex way of running the involved tools manually essentially parallels the way used for SGML and XML documents and will not be elaborated here.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-create-rtf"></a>Create a RTF document for use with RefDB</h3></div></div></div><p>In contrast to SGML and XML documents, there is nothing special about RTF documents that you can use with RefDB. You should still run <a class="link" href="re21.html" title="refdbnd">refdbnd</a> and select "rtf" as a document type. This will generate a suitable Makefile and a skeleton RTF document. You can open that with your favourite word processor, or copy an existing RTF document and save it under the same name.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-cite-rtf"></a>Create citations in word processor documents</h3></div></div></div><p>RefDB recognizes a simple plain-text citation format in RTF documents. Citations are enclosed in square brackets. Inside a citation, each reference is again enclosed in square brackets. References are identified by their citation keys, followed by one of "-X", "-A", and "-Y" to denote regular citations, author-only citations, or year-only citations, respectively (the RefDB low-level tools handle the first vs. subsequent occurrence issue silently for you, therefore there is no need for "-S" and "-Q" although these are valid too). The following text snippet shows some citations:</p><pre class="programlisting">
...was shown[[Miller1999-X]]. This was confirmed by other groups
as well [[Doe2000-X][Jones2000-X]]. However, [[Nerd2002-A]] challenged this
view in a recent work[[Nerd2002-Y]]...
</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-process-rtf"></a>Process RTF documents</h3></div></div></div><p>As word processor documents lack the separation between content and formatting, there is usually no transformation required to read or print a document. However, as the processing requirements from RefDB's point of view are not any different between RTF and XML documents, RefDB still has to transform your RTF document - to yet another RTF document. While doing so, it massages your in-text citations into appropriately formatted links to the bibliographic entries, and appends a formatted bibliographic listing. All you need to do is to run <span class="command"><strong>make</strong></span>. This will create the output file <code class="filename">foo.refdb.rtf</code> from your project file <code class="filename">foo.rtf</code>.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch10s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch10.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch10s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Create LaTeX/BibTeX bibliographies </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Using custom stylesheets to process documents with bibliographies</td></tr></table></div></body></html>
|