/usr/share/doc/refdb/refdb-manual/ch10s06.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 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | <?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>Using custom stylesheets to process documents with bibliographies</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="ch10.html" title="Chapter 10. Bibliographies" /><link rel="prev" href="ch10s05.html" title="Create RTF bibliographies" /><link rel="next" href="ch11.html" title="Chapter 11. RefDB SRU interface" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Using custom stylesheets to process documents with bibliographies</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch10s05.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Bibliographies</th><td width="20%" align="right"> <a accesskey="n" href="ch11.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-use-custom-stylesheets"></a>Using custom stylesheets to process documents with bibliographies</h2></div></div></div><p>The RefDB stylesheets handle the oddities of formatting your bibliographies. The stock DocBook or TEI stylesheets handle the remainder of your documents. What if the formatting of the latter is not to your liking? To this end, the recommended way is to use stylesheet driver files which override those parameters, or entire sections, of the stylesheets which you need modified. Now, processing documents containing RefDB bibliographies with regular DocBook or TEI driver files won't do you any good as you'll lose the journal-specific citation and bibliography support. However, you can easily design driver files which accomplish the task at hand.</p><p><a class="link" href="re21.html" title="refdbnd">refdbnd</a>-created Makefiles contain hooks to use custom driver files; if you prefer to run the transformations manually, these Makefiles will also tell you how. The relevant Makefile section looks like this:</p><pre class="programlisting">
# options to use customized RefDB driver files, if any
fodriveropt = -a custom-fo.xsl
htmldriveropt = -b custom-html.xsl
xhtmldriveropt = -c custom-xhtml.xsl
</pre><p>As shown here, you can pass options to <a class="link" href="re22.html" title="runbib">runbib</a> which specify custom driver files. You can keep those in the same directory as the document itself, or specify a relative or full path. Your custom driver files <span class="emphasis"><em>must</em></span> include the appropriate RefDB stylesheets, not the stock DocBook or TEI stylesheets, like this (shown for the fo driver file):</p><pre class="programlisting">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
<xsl:import href="/usr/local/share/refdb/xsl/docbk-refdb-xsl/docbk-fo/docbk-refdb-fo.xsl"/>
<!-- your customizations here -->
</xsl:stylesheet>
</pre></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch10s05.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="ch11.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Create RTF bibliographies </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 11. RefDB SRU interface</td></tr></table></div></body></html>
|