=head1 NAME

isi2bib - script to generate BibTeX entries from Web of Science

=head1 SYNOPSIS

isi2bib [-longlabels]

isi2bib [-longlabels] < file

=head1 DESCRIPTION

These are Perl script to generate entries for a BibTeX bibliography
database from the search results of ISI Web of Science. ISI Web of
Science (http://isiknowledge.com/) is an effective (non-free) search
engine for scientific publications.

The idea is that you search the paper that you want in your BibTeX
database with this search engine. Use the Full search - General Search.
Usually, typing the authors will give you a reference to the
paper. There are three ways to proceed:

=over 3

=item 1

Mark the result on WoS (click checkbox, click "submit marks") and
proceed with the next reference. When finished, click "marked list"
and then "export to reference software". These exported references can
be fed into isi2bib.

=item 2

Copy and paste the output from your web browser into this perl
script and it will generate a well-formatted BibTeX-entry, which you
can paste into your BibTeX database.

=item 3

Use the isi2bib program as a CGI gateway on a web server. Change the
configuration lines at the top of the script and use the template
"online.html". If you put the script online, I would appreciate it if
you acknowledge me.

=back

See examples below.

It uses a nonstandard bibTeX field, `abstract'. I use the BibTeX style
file `index.bst' and the LaTeX file `overview.tex' to generate an
overview of everything that is in the bibTeX database, with some notes
to remind me what the paper was about.

A Perl script to generate entries for a BibTeX bibliography database
from the search results of ISI Web of Science.

Author: Han-Kwang Nienhuys (han-kwang.nienhuys AT chemphys.lu.se)

=head1 REQUIREMENTS

=over 4

=item * Perl 5.x

=item * A subscription to Web of Science

=back

=head1 INSTALLATION

Change the variable $newbibfile in isi2bib to wherever you store
your bibliographic information. xisi2bib does not require any
modification.

Check that the first line of the scripts points to the perl
executable. I assume that you run Linux or some other Unix-like
system; under Windows, you probably have to do some more effort, but
that's not my expertise

Put the script somewhere in your path.

=head1 EXAMPLE 1 (FROM MARKED REFERENCES)

On WoS: Marked references, export to reference software, save to a
file refs.txt, which looks like (without leading spaces on the lines):

  FN ISI Export Format
  VR 1.0
  AU Doe, JTM
     Smith, B
     Jones, S
  TI Photoinduced charge creation in some novel materials
  BP 678
  EP 901
  JI J. Chem. Phys
  PY 1987
  VL 123
  IS 10
  AB lorem ipsum
  ER

  (more records may follow)
  
At the command line:

  $xisi2bib < refs.txt

The output:
  
  @Article{doe87,
    author = {J.T.M. Doe and B. Smith and S. Jones},
    title = {Photoinduced charge creation in some novel materials},
    journal = {J. Chem. Phys},
    volume = {123},
    number = {10},
    pages = {678--901},
    year = {1987},
    entrydate = {2003/03/28},
    abstract = {lorem ipsum},
  }
 

=head1 EXAMPLE 2 (DIRECTLY FROM SEARCH RESULTS)

Search results in Web of Science:

  Doe JTM, Smith B, Jones S
  Photoinduced charge creation in some novel materials
  J CHEM PHYS 123 (4-5): 678-901 AUG 8 1987

At the command line:
  
   $isi2bib
   Paste data below (WoS export format (multiple)
   or from search results (1 entry at a time)
   End with 2 empty lines or EOF.
   Doe JTM, Smith B, Jones S              
   Photoinduced charge creation in some novel materials
   CHEM PHYS LETT 123 (4-5): 678-901 AUG 8 1987
   
   
   Abstract (empty line to finish)
   
   
   @Article{doe87,
     author = {J. T. M. Doe and B. Smith and S. Jones},
     title = {Photoinduced charge creation in some novel materials},
     journal = {Chem Phys Lett},
     volume = {123},
     pages = {678--901},
     year = {1987},
     entrydate = {2003/09/16},
     abstract = {},
   }
