/usr/share/doc/refdb/refdb-manual/ch10s02.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>Manage bibliography styles</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="ch10.html" title="Chapter 10. Bibliographies" /><link rel="next" href="ch10s03.html" title="Create SGML and XML bibliographies" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Manage bibliography styles</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch10.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Bibliographies</th><td width="20%" align="right"> <a accesskey="n" href="ch10s03.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-manage-bibstyles"></a>Manage bibliography styles</h2></div></div></div><p>Bibliography styles are defined as XML documents. Each document contains one or more bibliography styles for a particular journal or publisher. The bibliography styles need to be added to the RefDB database before they can be applied to your documents. The bibliography style controls, among others, characteristics like:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Numerical vs. author/year vs. citation key citation style</p></li><li class="listitem"><p>Bibliography sorting order (as it appears in the text vs. alphabetical or sorted by ascending or descending publication dates)</p></li><li class="listitem"><p>Formatting of author names: First and middle initial with or without periods, with or without spaces, before or after the surname</p></li><li class="listitem"><p>Appearance of name, volume, and issue number of journals (bold, underlined, italics)</p></li><li class="listitem"><p>Formatting of the bibliographic listing: indentation, font sizes.</p></li></ul></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The extensive formatting specifications of the RefDB bibliography styles are almost wasted on BibTeX bibliographies currently. You still need one of the native BibTeX styles to do the actual formatting until RefDB bibliography styles can be exported as BibTeX styles. The current implementation uses only the formatting information of the journal name to allow either the full name or one of the abbreviations to appear in the bibliography. So for the <span class="emphasis"><em>current</em></span> implementation you can get away with just two simple styles that define only the journal name formatting for the <span class="quote">“<span class="quote">GEN</span>”</span> publication type. These can be found as <code class="filename">bibtex-abbrev.xml</code> and <code class="filename">bibtex-full.xml</code> in the <code class="filename">style</code> directory of the source distribution.</p></div><p>It is admittedly no easy task to write correct bibliography styles from scratch. It may be easier to pick a similar style (if there is one) and modify it to your needs. In this section you will find a brief overview how a bibliograpy style is put together. For more detailed information, please peruse the separate <a class="ulink" href="http://refdb.sourceforge.net/citestylex/index.html" target="_top">documentation of the CiteStyle XML DTD</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp64316992"></a>Write or modify a bibliography style file</h3></div></div></div><p>It is recommended to use a validating XML editor like Emacs/nXML to write bibliography styles using the CiteStyle XML DTD. This ensures that you end up with a valid style that won't confuse RefDB. If you edit styles with a simpler editor, please run the resulting file through a validating parser like onsgmls or xmllint before adding it to your main database.</p><p>The <code class="sgmltag-element">CITESTYLE</code> element defines a bibliography style for one particular journal or publisher. You can group several styles in one file with the <code class="sgmltag-element">STYLESET</code> wrapper element.</p><p>Each <code class="sgmltag-element">CITESTYLE</code> element contains exactly four top-level elements (<a class="xref" href="ch10s02.html#fig-citestyleschema" title="Figure 10.1. Schematic representation of a CITESTYLE element">Figure 10.1, “Schematic representation of a <code class="sgmltag-element">CITESTYLE</code> element”</a>). The <code class="sgmltag-element">STYLENAME</code> defines the name of this style. For the sake of simplicity this could be identical with the name of the journal or publisher whose bibliography style it defines, e.g. <span class="quote">“<span class="quote">J.Biol.Chem.</span>”</span> or <span class="quote">“<span class="quote">Elsevier</span>”</span>. The <code class="sgmltag-element">REFSTYLE</code> element contains the style definitions for the various publication types that can appear in a bibliography, like books, journals, or personal communications. A special case is the type <span class="quote">“<span class="quote">GEN</span>”</span> which defines a default bibliography style that is applied whenever no specific definition is available for the requested type. Although the DTD does not enforce this, it is strongly recommended to define a <span class="quote">“<span class="quote">GEN</span>”</span> definition for each bibliography style. The <code class="sgmltag-element">CITSTYLE</code> element defines the citation style, i.e. the appearance of the citations in the main text. Finally, the <code class="sgmltag-element">BIBSTYLE</code> element defines the properties of the bibliographic listing.</p><div class="figure"><a id="fig-citestyleschema"></a><p class="title"><strong>Figure 10.1. Schematic representation of a <code class="sgmltag-element">CITESTYLE</code> element</strong></p><div class="figure-contents"><div class="mediaobject"><img src="refdbmanualfig4.png" alt="Schematic representation of a CITESTYLE element" /></div></div></div><br class="figure-break" /><p>Each definition for a publication type in turn is basically an ordered list of the elements that make up the rendered bibliographic entry, like authorlists, publication dates, titles, and so on. You can arrange them in any order you like. All available elements can hold a <code class="sgmltag-element">PRECEEDING</code> and a <code class="sgmltag-element">FOLLOWING</code> element which define strings that are inserted before and after the corresponding element, respectively. This can be used to place punctuation characters or brackets wherever such a non-empty element occurs. A special element is <code class="sgmltag-element">SEPARATOR</code> which usually also contains punctuation characters. This element is always inserted even if the preceeding or following element is empty.</p><p>The styles also reflect the three-level representation of the bibliographic data themselves. For a discussion of this representation see the description of the <a class="link" href="ch07s04.html" title="Writing risx datasets">risx</a> format. When you write a bibliographic style, you have to make sure to pick the correct level, as indicated with the <code class="sgmltag-attribute">role</code> attribute, for the author lists and the titles. E.g. a chapter entry would typically have <code class="sgmltag-element">AUTHORLIST</code> and <code class="sgmltag-element">TITLE</code> elements with the <code class="sgmltag-attribute">role</code> attribute set to "PART" to display the chapter author and title, respectively, and additionally <code class="sgmltag-element">AUTHORLIST</code> and <code class="sgmltag-element">TITLE</code> elements with the <code class="sgmltag-attribute">role</code> attribute set to "PUB" to render the editor and the title of the whole book, respectively. </p><p>The <code class="sgmltag-element">CITSTYLE</code> element can define three different styles for citations: <code class="sgmltag-element">INTEXTDEF</code> for regular citations as well as <code class="sgmltag-element">AUTHORONLY</code> and <code class="sgmltag-element">YEARONLY</code> for citations that keep the authors in the flow of the text. These elements are equivalent to the definition of a publication type in the <code class="sgmltag-element">REFSTYLE</code> element.</p><p>Please peruse the separate documentation for the <a class="ulink" href="http://refdb.sourceforge.net/docs.html" target="_top">CiteStyle XML DTD</a> for the details about the individual elements, and feel free to consult the styles shipped with RefDB for further guidance.</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>The RefDB project also provides a tool to create citation styles interactively. The <span class="command"><strong>refdb-ms</strong></span> Perl script is part of the RefDB sources.</p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch10.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="ch10s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 10. Bibliographies </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Create SGML and XML bibliographies</td></tr></table></div></body></html>
|