/usr/share/doc/refdb/refdb-manual/ch05s05.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>Add, edit, or delete bibliography styles</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="ch05.html" title="Chapter 5. refdbd administration" /><link rel="prev" href="ch05s04.html" title="Configure the application server" /><link rel="next" href="ch05s06.html" title="Logging data" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Add, edit, or delete bibliography styles</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch05s04.html">Prev</a> </td><th width="60%" align="center">Chapter 5. refdbd administration</th><td width="20%" align="right"> <a accesskey="n" href="ch05s06.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect1-add-bibstyles"></a>Add, edit, or delete bibliography styles</h2></div></div></div><p>This task is currently restricted to the system administrators in order to prevent users overwriting each others bibliography styles. A more appropriate solution will be implemented later to allow users uploading their own styles.</p><p>Use the refdba command <a class="link" href="re06.html#app-a-command-addstyle" title="addstyle"><span class="command"><strong>addstyle</strong></span></a> to add one or more bibliography style files to the database. Existing styles with the same name will be overwritten without a warning, so you should check with the <a class="link" href="re06.html#app-a-command-liststyle" title="liststyle">liststyle</a> command before you go ahead.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The name of a bibliography style is encoded in the XML file. The filename of the bibliography style is irrelevant here. Use <span class="command"><strong>grep STYLENAME</strong></span> to see which bibliography styles are defined in a file and check with the <a class="link" href="re06.html#app-a-command-liststyle" title="liststyle">liststyle</a> command whether they're already defined in the database.</p></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>refdb uses a non-validating parser to load bibliography styles into the database. It is your responsibility to validate the files before you add them. Adding invalid styles may have undesired and unpredictable results.</p></div><p>The refdba command <a class="link" href="re06.html#app-a-command-getstyle" title="getstyle"><span class="command"><strong>getstyle</strong></span></a> retrieves one or more bibliography styles as XML documents. In order to edit an existing bibliography style, simply retrieve the style with the <span class="command"><strong>getstyle</strong></span> command, edit the XML document as necessary, and add it again with the <a class="link" href="re06.html#app-a-command-addstyle" title="addstyle"><span class="command"><strong>addstyle</strong></span></a> command. As stated above, this will overwrite the existing style definition.</p><p>Use the refdba command <a class="link" href="re06.html#app-a-command-deletestyle" title="deletestyle"><span class="command"><strong>deletestyle</strong></span></a> to remove one or more bibliography styles from the database. The argument for this command is a Unix regular expression. All styles whose name match the regular expression will be deleted.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch05s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch05s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Configure the application server </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Logging data</td></tr></table></div></body></html>
|