NAME

isi2bibtex - convert ISI database files to BibTeX format


SYNOPSIS

isi2bibtex [OPTIONS] inputfile [outputfile]

If no output file is specified, inputfile.bib is used.

Records are appended if the output file exists.


DESCRIPTION

Isi2bibtex converts an ISI (Institute for Scientific Information) bibliographic database file to a BibTeX file for use in TeX and LaTeX documents. Both formats hold bibliographic data on scientific and other academic documents.

(In the UK, the ISI databases are commonly known as 'BIDS' or 'MIMAS WoS')

Another way to do the same job isi2bibtex does is with bp, which has the advantage of converting between many different bibliographic formats and character sets. If you don't want that, isi2bibtex understands BIDS standard format in addition to the others, and is stand-alone and so presumably easier to get working.


Options

-h, --help display help and exit

-v, --version display version information and exit

-q, --quiet no informational output

-a, --abstract include abstract in output file

-c, --check make some checks on field contents (default)

-n, --nocheck don't make checks on field contents


Input databases

Although isi2bibtex was written for SCI (Science Citation Index), all the ISI databases should work (SCI, SSCI, A&HCI, ISTP). Isi2bibtex will probably make a bad job of editing the content of these other databases, and would have to be changed a bit (not difficult), but you may be lucky.

In the UK, probably most of the other databases on BIDS should work either straight away or with a small amount of modification of the script. BIDS Pascal for instance works with downloading format, and would work with a small amount of modification with standard format.


Input formats

If you use a web interface to ISI, isi2bibtex will only convert text output (whether emailed or saved directly), not saved web pages or other bibliography formats such as Procite or Reference Manager. Specifically, the formats that are understood are:

ISI generic output format version 1.0:

I presume this is the format used in most of the world. In the UK, this is output by MIMAS WoS 'save records' or 'email records'.

BIDS standard format:

(any of: Title only; Title, authors & journal; Full record excluding citations; Full record)

BIDS downloading format:

(any of: Title, authors & journal in downloading format; Full record in downloading format)

You can mix and match record formats in one file. Deleting fields and / or record numbers from records should be okay. Any fields may be present in any order. Don't change the indentation of records: isi2bibtex will ignore records if they're too different from the usual layout due to ambiguity of field labels and field contents.


Output fields

For ISI generic format (eg MIMAS WoS output) and BIDS downloading format, fields other than title (TI), author (AU), source ie journal (SO), page range (BP, EP), year (PY) and abstract (AB) are ignored.

For standard BIDS format, fields other than Title (TI:), author (AU:), journal (JN:) and abstract (AB:) are ignored (the JN: field contains the page numbers, volume, date, etc as well as the journal name).

At the moment isi2bibtex only outputs the more useful fields, but this may change in the future (when someone gets round to it). Which fields are output can be controlled with a configuration file (see below). Those that don't correspond to the standard BibTeX fields (such as abstract) won't be recognised by BibTeX by default, but they'll be there if you need to use them.


Output formatting

Output is tidied up as much as possible, but some editing is still required.

Output formatting defaults can be modified with a configuration file. /etc/isi2bibtexrc and ~/.isi2bibtexrc (or whatever you set in the @CONFIG variable in the script) are looked at in that order for configuration settings, with the latter overriding the former. See the example configuration file provided.

If they are switched on, things like journal title abbreviations and acronym capitalisations can be added and removed at the end of the script (very easy to do by looking at what's there already). Newer ISI entries have lower case as well as upper, and isi2bibtex always leaves the capitalization as-is for those records.


DOESN'T WORK?

Remember to:


Unix

set the first line of this script to point to your copy of perl (eg. /usr/bin/perl or /usr/local/bin/perl)

make it executable (eg. chmod +x ./isi2bibtex)

put it somewhere your OS can find it (eg ~/bin or /usr/local/bin): you may need to change your PATH environment variable


Microsoft Windows

change the name of this script to isi2bibtex.pl (you'll have to use it as

isi2bibtex.pl [OPTIONS] inputfile.txt outputfile.bib

rather than

isi2bibtex [OPTIONS] inputfile.txt outputfile.bib

because the windows DOS shell doesn't know about the #! line)

put it in your Perl bin directory, eg C:\Perl\bin (obviously if you don't have perl installed, you need to do that first: see below)

if that doesn't work check the PATH environment variable contains your perl bin directory, and as a last resort try

    perl C:\Perl\bin\isi2bibtex.pl inputfile.txt


Other platforms

I have no idea, but it should work on any platform that runs Perl 5, perhaps with a few small modifications. Isi2bibtex has been tested on Windows (95 and NT) and Unix. Please send me any portability changes.

Email <> if it still doesn't work.


KNOWN PROBLEMS

It only does articles, not books, proceedings etc, and won't notice if a record isn't an article.

It ignores some fields (mostly those that don't correspond to the standard BibTeX 'article' fields).

ISI access providers' output other than BIDS and MIMAS WOS haven't been tested. Send me an output file and I'll make it work with that format (for SCI).

Please tell me about any bugs you find, at <jjl@pobox.com>


SEE ALSO

If you don't have Perl installed, it can be got (free) from http://www.perl.com/ . LaTeX, BibTeX and everything else TeX can be downloaded from http://www.CTAN.org/ .

bp converts between many bibliography database formats (including conversion from BIDS downloading and ISI generic formats to BibTeX), and many character sets.

Ben Bolker (author of the BIDS / MIMAS WOS specification for bp) has a page describing his modifications to bp:

http://www.zoo.ufl.edu/bolker/bp.html

Dana Jacobsen (author of bp) has a web page with lots of bibliography software information and details of his bp package:

http://www.ecst.csuchico.edu/~jacobsd/bib/index.html

Some other BibTeX utilities that may or may not be useful (these are just the ones I've got round to looking at):

bibclean checks and formats BibTeX databases

bibsort sorts BibTeX databases

bib2dvi converts BibTeX databases to DVI files (DVI files are output by LaTeX and are DeVice Independent typeset documents, a bit like postscript or pdf -- you can read them on most computer systems)

bibextract, citefind and citetags respectively extract BibTeX records from a BibTeX database, extract LaTeX references from a LaTeX document, and look up LaTeX references in a BibTeX database.

bibindex makes an index for fast lookup by biblook, if you have a huge database that needs it I suppose

BibTool is an all-singing all-dancing general purpose BibTeX management utility

bibview is a simple interactive searching utility for BibTeX files

findbib gets BibTeX records corresponding to references in a LaTeX file from a preprint server (don't know if it still works)

both refer2bibtex and r2bib convert refer files (whatever they are) to BibTeX files

tkbibtex is a graphical tool for editing and searching BibTeX databases

Text::BibTeX is a Perl module for doing things to BibTeX databases.


COPYRIGHT

Copyright (C) 2000 Jonathan Swinton, Ben Bolker, Anthony Stone, John J. Lee

Isi2bibtex replaces and is derived from bids.to.bibtex (as of 29 Jan 1998) and isi2bib 0.1.

bids.to.bibtex was based on a perl script written by Jonathan Swinton, and subsequently modified by Ben Bolker and Anthony Stone.

isi2bib 0.1 was written by John J. Lee <jjl@pobox.com>

This script is covered by the GPL. See the script for copyright information.


FILES

/etc/isi2bibtexrc, ~/.isi2bibtexrc (or whatever you set in the @CONFIG variable) are looked at in that order for default configuration settings, with the latter overriding the former. See the example configuration file provided.


VERSION

0.40