NAME

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

SYNOPSIS

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

OPTIONS

       -c config_file
           Configuration file.  If this file is absent, some defaults are used.  See below for
           its format.

       -C 1|0
           Whether to canonicalize names in the output (1) or not (0).  By default, 1.

       -e  If 1 (default), add empty doi if a doi cannot be found.  This prevents repeated
           searches for the same entries if you add new entries to the file.  Calling "-e 0"
           suppresses this behavior.

       -f  Force checking doi number even if one is present

       -o output
           Output file.  If this option is not used, the name for the output file is formed by
           adding "_doi" to the input file

DESCRIPTION

       The script reads a BibTeX file.  It checks whether the entries have DOIs.  If not, it
       tries to contact http://www.crossref.org to get the corresponding DOI.  The result is a
       BibTeX file with the fields "doi=..." added.

       The name of the output file is either set by the -o option or is derived by adding the
       suffix "_doi" to the output file.

       Every BibTeX record in the input is parsed, using BibTeX::Parser, but only the ones that
       do not have the "doi" field (or "mrnumber" or "zblnumber" for the sibling scripts) are
       processed. These entries without the requested field are written back, as described in
       BibTeX::Parser::Entry.

       The bib records that are not processed (because they already have the requested field) are
       written back as-is, without any reformatting.

       There are (were?) two options for making queries with Crossref: free account and paid
       membership. In the first case you still must register with Crossref and are limited to a
       small number of queries, see the agreement at
       "http://www.crossref.org/01company/free_services_agreement.html". In the second case you
       have a username and password, and can use them for automatic queries. I am not sure
       whether the use of this script is allowed for the free account holders. At any rate, if
       you want to add DOIs to a large number of entries, you should register as a paid member.

CONFIGURATION FILE

       The configuration file relates to the Crossref queries, and is mostly self-explanatory: it
       has comments (starting with "#") and assginments in the form

          $field = value ;

       The important parameters are $mode ('free' or 'paid'), $email (for free users) and
       $username & $password for paid members.

EXAMPLES

          bibdoiadd -c bibdoiadd.cfg -o - citations.bib > result.bib
          bibdoiadd -c bibdoiadd.cfg -o result.bib citations.bib

AUTHOR

       Boris Veytsman

COPYRIGHT AND LICENSE

       Copyright (C) 2014-2024 Boris Veytsman

       This is free software.  You may redistribute copies of it under the terms of the GNU
       General Public License <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to
       the extent permitted by law.

                                            2024-09-02                               bibdoiadd(1)