Project

General

Profile

Download (2.73 KB) Statistics
| Branch: | Tag: | Revision:
1
<h3>Reference Part</h3>
2

    
3
<p>The reference part follows the syntax: <code>{separator}{authorship{,}}{titleEditionVolume}{:}{detail}{.}{year}</code></p>
4

    
5
<p>Zoological new combinations should not have a reference part, since in zoology, it is not common 
6
to mention the new combination reference.</p>
7

    
8
<h4>Separator</h4>
9

    
10
<p>The separator between the reference part and the preceding authorship may be a comma , or 
11
an <pre> in </pre> (surrounded by whitespaces). The comma indicates a book whereas the <code>in</code> stands either 
12
for a journal article or a book section. If the <code>in</code> is not followed by a comma, the parser 
13
interprets the reference as an article; otherwise, as a book section. Reference type parsing 
14
should be improved in future.</p>
15

    
16
<h4>Reference Authorship</h4>
17

    
18
<p>An author is only available for book sections. Articles and book sections are differentiated 
19
from each other by comparing the first four words that follow the separator. If these words 
20
include a comma and the words before the comma are likely to represent an author, the reference 
21
is recognized as a book section. Otherwise, it will be treated as an article. In both cases, 
22
a warning is thrown that differentiation is not possible.</p>
23

    
24
<h4>TitleEditionVolume</h4>
25

    
26
<p>The TitleEditionVolume part includes the title itself as well as optional edition part 
27
and volume parts. The title itself allows most character combinations but care must be taken 
28
if a <code>:</code> is included as this is the separator for the subsequent detail part. Special characters 
29
like <code>&amp;</code> and <code>-</code> are only allowed if preceded and followed immediately by ordinary characters. 
30
Ordinary brackets are allowed. Edition and volume are separated by whitespace if only one 
31
of them exists. If both exist the later is separated by a comma. Both are optional, so all 
32
four of the following formats are valid:</p>
33

    
34
<pre>
35
Sp. Pl.
36
Sp. Pl. ed. 3
37
Sp. Pl. ed. 3, 4
38
Sp. Pl. 4
39
</pre>
40

    
41
<p>As can be seen, the edition is recognized by a preceding <code>ed.</code>, whereas the volume is just 
42
a number (or a number followed by another number in brackets - e.g. <code>4(5)</code> ).</p>
43

    
44
<p>The detail part is separated by a column <code>:</code> from the preceding titleEditonVolume part and 
45
is separated from the year by <code>.</code> (botanical names only). A number of typical detail information 
46
is recognized as either pure page numbers (<code>345</code>) or ranges (<code>345-348</code>). Page numbers may be 
47
preceded by <code>p.</code>(e.g. <code>p. 345</code>) or <code>pp.</code>(e.g. <code>pp. 345-348</code>). Abbreviations indicating special parts of a 
48
reference such as <code>fig.</code> or <code>tab.</code> are recognized as well. Roman numbers are not detected 
49
at the moment.</p>
50

    
(5-5/5)