New upstream release.
[debian/jabref-plugin-oo.git] / OOPlugin-jabref.php
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4 <head>
5   <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
6   <title>OpenOffice plugin for JabRef</title>
7   <link href="css/style.css" rel="stylesheet" type="text/css" />
8 </head>
9
10 <body>
11   <div id="main">
12     <div id="container">
13
14       <?php include("navigation.php"); ?>
15
16       <h1>OpenOffice plugin for JabRef</h1>
17
18       <h2>Introduction</h2>
19
20       <p>This plugin offers an interface for inserting citations and formatting a Bibliography in an OpenOffice writer document from JabRef.</p>
21
22       <h2>How to use the plugin</h2>
23
24       <p>The plugin can be used with JabRef 2.4 or newer. If your JabRef version doesn't have a plugin manager (versions 2.4.x), you need to put the plugin jar file in a directory named <code>plugins</code> below the directory where the JabRef jar file is installed (typically under <code>C:\Program files\Jabref 2.x</code> if you are running under Windows). The plugin should be loaded next time you start JabRef, and an item named <b>OpenOffice.org panel</b> should appear in JabRef's <b>Plugins</b> menu.</p>
25
26       <p>The plugin should work with OpenOffice versions 2.4.x and 3.x, provided it is installed with Java support (this is usually the case on Windows, while in some Linux distributions you need to install a separate package named <code>openoffice.org-java-common</code> or something similar).</p>
27
28       <h2>Updates</h2>
29       <ul>
30         <li>2010-06-03: Version 0.8: Style file format now allows optional double quotes aroung property values.</li>
31         <li>2010-05-12: Version 0.7.4: Added a couple of new citation properties: AuthorLastSeparatorInText and MultiCiteChronological</li>
32         <li>2010-03-04: Version 0.7.3: Added support for &lt;smallcaps&gt; tag to indicate small caps in reference list. Several bug fixes.</li>
33         <li>2010-02-02: Version 0.7.2: Added MaxAuthorsFirst property to override MaxAuthors the first time each citation appears.</li>
34         <li>2009-10-07: Version 0.7.1: Several important bug fixes.</li>
35         <li>2009-08-26: Version 0.7: BibTeX fields are now preprocessed to handle LaTeX \textit and \textbf commands and character sequences. <b>NOTE: it is no longer necessary to run FormatChars on fields.</b></li>
36         <li>2009-08-23: Version 0.6: Improved handling of undefined BibTeX keys. Added option to not sync automatically when adding citation.</li>
37         <li>2009-08-05: Version 0.5: Fixed connection problem on Mac. Fixed bug in merge function.</li>
38         <li>2009-06-03: Version 0.4: Added support for superscript/subscript tags in reference list, subscripted citations and different brackets for numbering in the reference list.</li>
39         <li>2009-05-17: Version 0.3: Added MinimumGroupingCount property. Some GUI changes.</li>
40         <li>2009-04-02: Version 0.2.1: Fixed bug in sorting of reference list.</li>
41         <li>2009-03-01: Version 0.2: Better sorting of citations in captions, tables and footnotes.</li>
42         <li>2009-02-25: Version 0.1.9: Added support for bold/italic citation markers, and for citations in table cells and footnotes.</li>
43         <li>2008-12-21: Version 0.1.2: Added invisible citations. Merged citations are now sorted.</li>
44         <li>2008-11-19: Version 0.1.1: Improved handling of OpenOffice shutdown and reconnect.</li>
45         <li>2008-10-25: Version 0.1: User interface improvements. Can now select which Writer document to work with.</li>
46         <li>2008-10-19: Version 0.0.9: Enabled connection to OpenOffice.org 3. Streamlined connection process.</li>
47         <li>2008-09-03: Version 0.0.8: No major changes, but packaged with JabRef 2.4.</li>
48         <li>2008-02-20: Version 0.0.7: New interface for style selection. Styles can now specify paragraph format.</li>
49         <li>2008-02-13: Version 0.0.6: Sorting and grouping of number citation markers.</li>
50         <li>2008-02-06: Version 0.0.5: Modified style file format. Fixed bug in handling names with elements like "van der".</li>
51         <li>2008-01-09: Version 0.0.4: Style file is now automatically reloaded if modified.</li>
52         <li>2007-12-17: Version 0.0.3: From this version, we bypass OO's built-in bibliographic system.</li>
53         <li>2007-12-04: Version 0.0.2</li>
54         <li>2007-12-01: Version 0.0.1</li>
55       </ul>
56
57       <h2>Downloads</h2>
58
59       <p><a href="plugins/net.sf.jabref.oo.ooplugin-0.8.jar">The plugin.</a></p>
60
61       <p><a href="plugins/JabRef-oo-0.8-src.zip">Plugin source code.</a> The source code tree includes four OpenOffice.org jars and JabRef 2.6. The plugin is built using an included Ant build file.</p>
62
63       <p><a href="plugins/example_style_file.jstyle">Example style file</a></p>
64
65       <p>The plugin is distributed under the terms of the GNU <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">General Public License</a>, version 2 or later.</p>
66
67       <h2>Using the OpenOffice interface</h2>
68
69       <p>To communicate with OpenOffice, the OO plugin must first connect to a running OpenOffice instance. You need to start OpenOffice and enter your document before connecting from JabRef. The plugin needs to know the location of your OpenOffice executable (<b>soffice.exe</b> on Windows, and <b>soffice</b> on other platforms), and the directory where several OpenOffice jar files reside. If you connect by clicking the <b>Connect</b> button, the plugin will try to automatically determine these locations. If this does not work, you need to connect using the <b>Manual connect</b> button, which will open a window asking you for the needed locations.</p>
70
71       <p>After the connection has been established, you can insert citations by selecting one or more entries in JabRef and using the <b>Push to OpenOffice</b> button in the dropdown menu of JabRef's toolbar, or by using the appropriate button in the OpenOffice plugin panel in the side pane. This will insert citations for the selected entries at the current cursor position in the OpenOffice document, and update the bibliography to contain the full reference.</p>
72
73       <p><b>Note:</b> JabRef does not use OpenOffice's built-in bibliography system, because of the limitations of that system. A document containing citations inserted from JabRef will not generally be compatible with other reference managers such as Bibus and Zotero.</p>
74
75       <p>Two different types of citations can be inserted - either a citation in parenthesis, "(Author 2007)", or an in-text citation, "Author (2007)". This distinction is only meaningful if author-year citations are used instead of numbered citations, but the distinction will be preserved if you switch between the two styles.</p>
76
77       <p>If you modify entries in JabRef after inserting their citations into OpenOffice, you will need to synchronize the bibliography. The <b>Sync OO bibliography</b> button will update all entries of the bibliography, provided their BibTeX keys have not been altered (JabRef encodes the BibTeX key into the reference name for each citation to keep track of which BibTeX key the original JabRef entry has).</p>
78
79       <h2>The style file</h2>
80
81       <p>You need to select a style file before connecting to OpenOffice - an external file which is selected using a standard file dialog. The style file defines the format of citations and the format of the bibliography. You can use standard JabRef export formatters to process entry fields before they are sent to OpenOffice. Through the style file, the intention is to give as much flexibility in citation styles as possible.</p>
82
83       <p>Here is an example style file:</p>
84 <pre>
85 NAME
86 Example style file for JabRef-oo plugin.
87
88 JOURNALS
89 Journal name 1
90 Journal name 2
91
92 PROPERTIES
93 Title="References"
94 IsSortByPosition="false"
95 IsNumberEntries="false"
96 ReferenceParagraphFormat="Default"
97 ReferenceHeaderParagraphFormat="Heading 1"
98
99 CITATION
100 AuthorField="author/editor"
101 YearField="year"
102 MaxAuthors="3"
103 MaxAuthorsFirst="3"
104 AuthorSeparator=", "
105 AuthorLastSeparator=" &amp; "
106 EtAlString=" et al."
107 YearSeparator=" "
108 InTextYearSeparator=" "
109 BracketBefore="["
110 BracketAfter="]"
111 BracketBeforeInList="["
112 BracketAfterInList="]"
113 CitationSeparator="; "
114 UniquefierSeparator=","
115 GroupedNumbersSeparator="-"
116 MinimumGroupingCount="3"
117 FormatCitations="false"
118 ItalicCitations="false"
119 BoldCitations="false"
120 SuperscriptCitations="false"
121 SubscriptCitations="false"
122 MultiCiteChronological="false"
123
124 LAYOUT
125 article=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
126 (&lt;b&gt;\year\uniq&lt;/b&gt;). &lt;i&gt;\title&lt;/i&gt;, \journal \volume\begin{pages} :
127 \format[FormatPagesForHTML]{\pages}\end{pages}.
128
129 book=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}\begin{editor}
130 \format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.)\end{editor},
131 &lt;b&gt;\year\uniq&lt;/b&gt;. &lt;i&gt;\title&lt;/i&gt;. \publisher, \address.
132
133 incollection=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
134 (&lt;b&gt;\year\uniq&lt;/b&gt;). &lt;i&gt;\title&lt;/i&gt;. In: \format[AuthorLastFirst,
135 AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), &lt;i&gt;\booktitle&lt;/i&gt;, \publisher.
136
137 inbook=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
138 (&lt;b&gt;\year\uniq&lt;/b&gt;). &lt;i&gt;\chapter&lt;/i&gt;. In: \format[AuthorLastFirst,
139 AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), &lt;i&gt;\title&lt;/i&gt;, \publisher.
140
141 phdthesis=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
142 (&lt;b&gt;\year\uniq&lt;/b&gt;). &lt;i&gt;\title&lt;/i&gt;, \school.
143
144 default=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
145 (&lt;b&gt;\year\uniq&lt;/b&gt;). &lt;i&gt;\title&lt;/i&gt;, \journal \volume\begin{pages} :
146 \format[FormatPagesForHTML]{\pages}\end{pages}.
147
148 </pre>
149
150         <p>(Note that the layout for each entry type must be constrained to a single line in the style file - above, the lines are broken up to improve readability.)</p>
151
152                         <h3>Global properties</h3>
153
154         <p>The <b>PROPERTIES</b> section describes global properties for the bibliography.
155         The following table describes the available properties:
156
157                         <table border=1 rules=none>
158                         <tr>
159                         <td><b>Property</b></td>
160                         <td><b>Type</b></td>
161                         <td><b>Default value</b></td>
162                         <td><b>Description</b></td>
163                         </tr>
164                         <tr>
165                         <td>IsNumberEntries</td>
166                         <td>boolean</td>
167                         <td><code>false</code></td>
168                         <td>Determines the type of citations to use. If <code>true</code>, number citations will be
169                         used. If <code>false</code>, author-year citations will be used.</td>
170                         </tr>
171                         <tr>
172                         <td>IsSortByPosition</td>
173                         <td>boolean</td>
174                         <td><code>false</code></td>
175                         <td>Determines how the bibliography is sorted. If true, the entries
176           will be sorted according to the order in which they are cited. If false, the entries will be
177          sorted alphabetically by authors.</td>
178                         </tr>
179                         <tr>
180                         <td>ReferenceParagraphFormat</td>
181                         <td>string</td>
182                         <td><code>Default</code></td>
183                         <td>Gives the name of the paragraph format to be used for the reference list. This format
184                         must be defined in your OpenOffice document.</td>
185                         </tr>
186                         <tr>
187                         <td>ReferenceHeaderParagraphFormat</td>
188                         <td>string</td>
189                         <td><code>Heading 1</code></td>
190                         <td>Gives the name of the paragraph format to be used for the headline of the reference list. 
191                         This format must be defined in your OpenOffice document.</td>
192                         </tr>
193                         <tr>
194                         <td>Title</td>
195                         <td>string</td>
196                         <td><code>Bibliography</code></td>
197                         <td>The text to enter as the headline of the reference list.</td>
198                         </tr>
199                         </table></p>
200                         
201                         <h3>Citation properties</h3>
202
203         <p>The <b>CITATION</b> section describes the format of the citation markers inserted into the text.
204         
205         <p>The following table gives a brief description of all the available citation properties. Properties that are not
206                   given in the style file will keep their default value.
207                   
208                   <table border=1 rules=none>
209                         <tr>
210                         <td><b>Property</b></td>
211                         <td><b>Type</b></td>
212                         <td><b>Default value</b></td>
213                         <td><b>Description</b></td>
214                         </tr>
215                         <tr>
216                         <td>AuthorField</td>
217                         <td>string</td>
218                         <td><code>author/editor</code></td>
219                         <td>BibTeX field containing author names. Can specify fallback field, e.g. <code>author/editor</code></td>
220                         </tr>
221                         <tr>
222                         <td>AuthorLastSeparator</td>
223                         <td>string</td>
224                         <td><code> & </code></td>
225                         <td>Text inserted between the two last author names.</td>
226                         </tr>
227                         <tr>
228                         <td>AuthorLastSeparatorInText</td>
229                         <td>string</td>
230                         <td>&nbsp;</td>
231                         <td>If specified, this propery overrides <code>AuthorLastSeparator</code> for in-text citations such as
232                         <code>Smith & Jones (2001)</code>.</td>
233                         </tr>
234                         <tr>
235                         <td>AuthorSeparator</td>
236                         <td>string</td>
237                         <td><code>, </code></td>
238                         <td>Text inserted between author names except the last two.</td>
239                         </tr>
240                         <tr>
241                         <td>BoldCitations</td>
242                         <td>boolean</td>
243                         <td><code>false</code></td>
244                         <td>If <code>FormatCitations</code> is on, controls whether citations should be bold.</td>
245                         </tr>
246                         <tr>
247                         <td>BracketAfter</td>
248                         <td>string</td>
249                         <td><code>]</code></td>
250                         <td>The closing bracket of citations.</td>
251                         </tr>
252                         <tr>
253                         <td>BracketAfterInList</td>
254                         <td>string</td>
255                         <td>]</td>
256                         <td>The closing bracket for citation numbering in the reference list.</td>
257                         </tr>
258                         <tr>
259                         <td>BracketBefore</td>
260                         <td>string</td>
261                         <td><code>[</code></td>
262                         <td>The opening bracket of citations</td>
263                         </tr>
264                         <tr>
265                         <td>BracketBeforeInList</td>
266                         <td>string</td>
267                         <td>[</td>
268                         <td>The opening bracket for citation numbering in the reference list.</td>
269                         </tr>
270                         <tr>
271                         <td>CitationSeparator</td>
272                         <td>string</td>
273                         <td><code>; </code></td>
274                         <td>Text inserter between items when a citation contains multiple entries, e.g. <code>[Smith 2001; Jones 2002]</code></td>
275                         </tr>
276                         <tr>
277                         <td>EtAlString</td>
278                         <td>string</td>
279                         <td><code> et al. </code></td>
280                         <td>Text inserted after author names when not all authors are listed, e.g. <code>[Smith et al. 2001]</code></td>
281                         </tr>
282                         <tr>
283                         <td>FormatCitations</td>
284                         <td>boolean</td>
285                         <td><code>false</code></td>
286                         <td>Determines whether formatting should be applied to citations. If true, formatting is controlled by
287                         properties like <code>BoldCitations</code>, <code>ItalicCitations</code>, <code>SubscriptCitations</code> 
288                         and <code>SuperscriptCitations</code>.</td>
289                         </tr>
290                         <tr>
291                         <td>GroupedNumbersSeparator</td>
292                         <td>string</td>
293                         <td><code>-</code></td>
294                         <td>Text inserted between numbers when numbered citations are grouped, e.g. <code>[4-6]</code></td>
295                         </tr>
296                         <tr>
297                         <td>InTextYearSeparator</td>
298                         <td>string</td>
299                         <td><code> </code></td>
300                         <td>Text inserted between author names and starting bracket before year in in-text citations.</td>
301                         </tr>
302                         <tr>
303                         <td>ItalicCitations</td>
304                         <td>boolean</td>
305                         <td><code>false</code></td>
306                         <td>If <code>FormatCitations</code> is on, controls whether citations should be in italics.</td>
307                         </tr>
308                         <tr>
309                         <td>MaxAuthors</td>
310                         <td>integer</td>
311                         <td><code>3</code></td>
312                         <td>The maximum number of authors to list in a citation that has appeared earlier in the document.</td>
313                         </tr>
314                         <tr>
315                         <td>MaxAuthorsFirst</td>
316                         <td>integer</td>
317                         <td><code>3</code></td>
318                         <td>The maximum number of authors to list in a citation when appearing for the first time.</td>
319                         </tr>
320                         <tr>
321                         <td>MinimumGroupingCount</td>
322                         <td>integer</td>
323                         <td><code>3</code></td>
324                         <td>The minimum number of consecutive entries a citation should contain before the numbers are grouped, 
325                         e.g. <code>[4-6]</code> vs. <code>[4; 5; 6]</code>.</td>
326                         </tr>
327                         <tr>
328                         <td>MultiCiteChronological</td>
329                         <td>boolean</td>
330                         <td><code>true</code></td>
331                         <td>If <code>true</code>, multiple entries in the same citation are sorted chronologically, otherwise
332                         they are sorted alphabetically.</td>
333                         </tr>
334                         <td>SubscriptCitations</td>
335                         <td>boolean</td>
336                         <td><code>false</code></td>
337                         <td>If <code>FormatCitations</code> is on, controls whether citations should be in subscript.</td>
338                         </tr>
339                         <td>SuperscriptCitations</td>
340                         <td>boolean</td>
341                         <td><code>false</code></td>
342                         <td>If <code>FormatCitations</code> is on, controls whether citations should be in superscript.</td>
343                         </tr>
344                         <tr>
345                         <td>UniquefierSeparator</td>
346                         <td>string</td>
347                         <td><code>, </code></td>
348                         <td>Text inserted between letters used to differentiate citations with similar authors and year. E.g.
349                         the text between <code>a</code> and <code>b</code> in <code>[Smith 2001a, b]</code>.</td>
350                         </tr>
351                         <tr>
352                         <td>YearField</td>
353                         <td>string</td>
354                         <td><code>year</code></td>
355                         <td>The BibTeX field to get publication year from.</td>
356                         </tr>
357                         <tr>
358                         <td>YearSeparator</td>
359                         <td>string</td>
360                         <td><code> </code></td>
361                         <td>Text inserted between author names and year in parenthesis citations such as <code>[Smith 2001]</code>.</td>
362                         </tr>
363                         
364                         </table></p>
365
366         If numbered entries are used, the <code>BracketBefore</code> and <code>BracketAfter</code> properties
367         are the most important - they define which characters the citation number is wrapped in. The citation is composed
368         as follows:<br />
369             <code>[BracketBefore][Number][BracketAfter]</code><br />
370         where [Number] is the number of the citation, determined according to the ordering of the bibliography and/or
371         the position of the citation in the text. If a citation refers to several entries, these will be separated
372         by the string given in the property <code>CitationSeparator</code> (for instance, if <code>CitationSeparator</code>=;,
373         the citation could look like <code>[2;4;6]</code>). If two or more of the entries have a series of consecutive
374         numbers, the numbers can be grouped (for instance <code>[2-4]</code> for 2, 3 and 4 or <code>[2;5-7]</code> for
375         2, 5, 6 and 7). The property <code>GroupedNumbersSeparator</code> (default <code>-</code>) determines which string separates the first and last
376         of the grouped numbers. The integer property <code>MinimumGroupingCount</code> (default 3) determines what number of
377         consecutive numbers are required before entries are grouped. If <code>MinimumGroupingCount</code>=3, the numbers
378         2 and 3 will not be grouped, while 2, 3, 4 will be. If <code>MinimumGroupingCount</code>=0, no grouping will be
379         done regardless of the number of consecutive numbers.
380         </p>
381         <p>If numbered entries are not used, author-year citations will be created based on the citation properties.
382         A parenthesis citation is composed as follows:<br />
383             <code>[BracketBefore][Author][YearSeparator][Year][BracketAfter]</code><br />
384         where [Author] is the result of looking up the field or fields given in the <code>AuthorField</code> property,
385         and formatting a list of authors. The list can contain up to <code>MaxAuthors</code> names - if more are present,
386         the list will be composed as the first author plus the text specified in the property <code>EtAlString</code>.
387         If the property <code>MaxAuthorsFirst</code> is given, it overrides <code>MaxAuthors</code> the first time each
388         citation appears in the text.</p>
389         <p>If several, slash-separated, fields are given in the <code>AuthorField</code> property, they will be looked up
390         successively if the first field is empty for the given BibTeX entry. In the example above, the "author" field will
391         be used, but if empty, the "editor" field will be used as a backup.</p>
392         <p>The names in the author list will be separated by the text given by the <code>AuthorSeparator</code>
393         property, except for the last two names, which will be separated by the text given by <code>AuthorLastSeparator</code>.
394         If the property <code>AuthorLastSeparatorInText</code> is given, it overrides the former for citations of the in-text
395         type. This makes it possible to get citations like <code>(Olsen &amp; Jensen, 2008)</code> and <code>Olsen and Jensen (2008)</code>
396         for the same style.
397         </p>
398         <p>[Year] is the result of looking up the field or fields given in the [YearField] property.</p>
399         <p>An in-text citation is composed as follows:<br />
400             <code>[Author][InTextYearSeparator][BracketBefore][Year][BracketAfter]</code><br />
401         where [Author] and [Year] are resolved in exactly the same way as for the parenthesis citations.
402         </p>
403         <p>If two different cited sources have the same authors and publication year, and author-year citations are used,
404         their markers will need modification in order to be distinguishable. This is done automatically by appending a
405         letter after the year for
406         each of the publications; 'a' for the first cited reference, 'b' for the next, and so on.
407         For instance, if the author "Olsen" has two cited papers from 2005, the citation markers will be modified to
408         <code>(Olsen, 2005a)</code> and <code>(Olsen, 2005b)</code>. In the bibliography
409         layout, the placement of the "uniquefier" letter is indicated explicitly by inserting the virtual field
410         <code>uniq</code>.</p>
411         <p>If several entries that have been "uniquefied" are cited together, they will be grouped in the citation
412         marker. For instance, of the two entries in the example above are cited together, the citation marker will
413         be <code>(Olsen, 2005a, b)</code> rather than <code>Olsen, 2005a; Olsen, 2005b)</code>. The grouped uniquefier
414         letters (a and b in our example) will be separated by the string specified by the <code>UniquefierSeparator</code>
415         property.
416         </p>
417         <p>Author-year citations referring more than one entry will by default be sorted chronologically. If you wish them
418         to be sorted alphabetically, the citation property <code>MultiCiteChronological</code> should be set to <code>false.</code>.</p>
419         <p>The property <code>FormatCitations</code> determines whether the citation markers should be formatted with
420         regards to italics, boldness, superscript and subscript. If <code>FormatCitations</code> is false, no such formatting
421         will be done. If true, the citations will be italicized or not depending on the <code>ItalicCitations</code> property, set to bold
422         or not depending on the <code>BoldCitations</code> property, and similar for the <code>SuperscriptCitations</code> and
423         <code>SubscriptCitations</code> properties.</p>
424
425                           
426         <h3>Reference list layout</h3>
427         
428         <p>The <b>LAYOUT</b> section describes how the bibliography entry for each entry type in JabRef
429         should appear. Each line should start with either the name of a BibTeX entry type, or the word
430         <code>default</code>, followed by a '='. The <code>default</code> layout will be used for all
431         entry types for which an explicit layout hasn't been given.</p>
432         <p>The remainder of each line defines the layout, with normal text and spaces appearing literally
433         in the bibliography entry. Information from the BibTeX entry is inserted by adding <code>\field</code> markers
434         with the appropriate field name (e.g. <code>\author</code> for inserting the author names). Formatting
435         information for the field can be included here, following JabRef's standard export layout syntax.
436         Refer to <a href="http://jabref.sourceforge.net/help/CustomExports.php">JabRef's documentation on custom export filters</a>
437         for more information about which formatters are available.</p>
438         <p>If author-year citations are used, you have to explicitly specify the position of the "uniquefier" letter
439         that is added to distinguish similar-looking citations. This is done by including a marker for the virtual field
440         <code>uniq</code>, typically right after the year (as shown in the example style file). The <code>uniq</code>
441         field is automatically set correctly for each entry before its reference text is laid out.
442         </p>
443         <p>To indicate formatting in the bibliography, you can use the HTML-like tag pairs &lt;b&gt; &lt;/b&gt;,
444          &lt;i&gt; &lt;/i&gt;,  &lt;sup&gt; &lt;/sup&gt; and  &lt;sub&gt; &lt;/sub&gt; to specify bold text,
445          italic text, superscript and subscript, respectively.</p>
446         <p>If you are using numbered citations, the number for each entry will be automatically inserted at the start
447         of each entry in the reference list. By default, the numbers will be enclosed in the same brackets defined for
448         citations. The optional citation properties <code>BracketBeforeInList</code> and
449         <code>BracketAfterInList</code> override <code>BracketBefore</code> and <code>BracketAfter</code> if set. These
450         can be used if you want different types of brackets (or no brackets) in the reference list. Note that these need
451         not be brackets as such - they can be any combination of characters.</p>
452
453       <h2>Known issues</h2>
454
455       <ul>
456         <li>When running with JabRef versions older than 2.6, institutional authors wrapped in braces, e.g. <code>{World Bank}</code>, are handled as if no braces were added. This happens because the OO-specific formatter, which removes the braces, can only be run after (instead of before) all other formatters in JabRef 2.6 or newer.</li>
457         <li>Make sure to save your Writer document in OpenDocument format (odt). Saving to Word format will lose your reference marks.</li>
458         <li>There is currently no support for footnote based citations.</li>
459         <li>The cursor may be poorly positioned after inserting a citation.</li>
460         <li>Copy-pasting the example style file directly from this page can give an unparseable file. To avoid this, instead download the example file from the link in the download section.</li>
461       </ul>
462
463       <h2>Contact</h2>
464
465       <p>If you have tested this plugin, and want to give your feedback, or if you want to contribute to the development of the plugin, please contact me at the e-mail address mortenalver at users.sourceforge.net.</p>
466
467     </div>
468     <?php include("footer.php"); ?>
469   </div>
470
471 </body>
472 </html>