1bibdoiadd(1)                   CROSSREF LIBRARY                   bibdoiadd(1)
2
3
4

NAME

6       bibdoiadd.pl - add DOI numbers to papers in a given bib file
7

SYNOPSIS

9       bibdoiadd [-c config_file] [-C 1|0] [-e 1|0] [-f] [-o output] bib_file
10

OPTIONS

12       -c config_file
13           Configuration file.  If this file is absent, some defaults are
14           used.  See below for its format.
15
16       -C 1|0
17           Whether to canonize names in the output (1) or not (0).  By
18           default, 1.
19
20       -e  If 1 (default), add empty doi if a doi cannot be found.  This
21           prevents repeated searches for the same entries if you add new
22           entries to the file.  Calling "-e 0" suppresses this behavior.
23
24       -f  Force checking doi number even if one is present
25
26       -o output
27           Output file.  If this option is not used, the name for the output
28           file is formed by adding "_doi" to the input file
29

DESCRIPTION

31       The script reads a BibTeX file.  It checks whether the entries have
32       DOIs.  If not, it tries to contact http://www.crossref.org to get the
33       corresponding DOI.  The result is a BibTeX file with the fields
34       "doi=..." added.
35
36       The name of the output file is either set by the -o option or is
37       derived by adding the suffix "_doi" to the output file.
38
39       There are two options for making queries with Crossref: free account
40       and paid membership.  In the first case you still must register with
41       Crossref and are limited to a small number of queries, see the
42       agreement at
43       "http://www.crossref.org/01company/free_services_agreement.html".  In
44       the second case you have a username and password, and can use them for
45       automatic queries.  I am not sure whether the use of this script is
46       allowed for the free account holders.  Anyway if you try to add DOI to
47       a large number of entries, you should register as a paid member.
48

CONFIGURATION FILE

50       The configuration file is mostly self-explanatory: it has comments
51       (starting with "#") and assginments in the form
52
53          $field = value ;
54
55       The important parameters are $mode ('free' or 'paid'), $email (for free
56       users) and $username & $password for paid members.
57

EXAMPLES

59          bibdoiadd -c bibdoiadd.cfg -o - citations.bib > result.bib
60          bibdoiadd -c bibdoiadd.cfg -o result.bib citations.bib
61

AUTHOR

63       Boris Veytsman
64

66       Copyright (C) 2014-2017  Boris Veytsman
67
68       This is free software.  You may redistribute copies of it under the
69       terms of the GNU General Public License
70       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the
71       extent permitted by law.
72
73
74
75                                  2017-11-26                      bibdoiadd(1)
Impressum