Isi-1.1.2 is released!


#1

Dear Rubies and TeXnichians,

isi-1.1.2 is released.

isi converts ISI Export Format to BibTeX Format. This is a
Ruby script. You can use isi as a library. (Its former names
were isi.rb or isi2bibtex.rb.)

ISI Web of Science, http://portal.isiknowledge.com, provides
their bibliographic information in ISI Export Format. You can
get the tagged Marked List in Web of Science by pushing the
[SAVE TO FILE] button.

Its gem is also ready. Now, RubyGems user can install isi
easily. This release is also for the new tag “AF”.

Download it from http://rubyforge.org/projects/isi-rb/ !

Three different ways of installation is described in this README:

== What is isi?
isi converts ISI Export Format to BibTeX Format.
This is a Ruby script. You can use isi as a library.

ISI Web of Science, http://portal.isiknowledge.com,
provides their bibliographic information in ISI Export Format.
You can get the tagged Marked List in Web of Science by
pushing the [SAVE TO FILE] button.

== Where is the homepage of isi?
http://isi-rb.rubyforge.org

== Where can I download isi?
Go to http://rubyforge.org/projects/isi-rb .

== How can I install isi?
There are three different ways to install isi.rb.
=== I. Conservative way; use setup.rb
isi-X.Y.Z.tgz package can be installed as:
$ tar zxf isi-X.Y.Z.tgz
$ cd isi-X.Y.Z
$ su

ruby setup.rb

=== II. RubyGems users can take an easy way
There is an easy way, if you are a RubyGems user:
$ gem install isi
=== III. Simple way; just copy isi.rb
Just copy lib/isi.rb (isi-X.Y.Z.rb) into your working directory which
contains
your saved “Marked List”, e.g. savedrecs.txt.
$ cp lib/isi.rb ~/your/working/directory/
($ cp isi-X.Y.Z.rb ~/your/working/directory/isi.rb)
$ cd ~/your/working/directory/
$ ruby isi.rb savedrecs1.txt savedrecs2.txt
$ ruby isi.rb < savedrecs.txt > savedrecs.bib
Last two lines are examples of usage for this installation way.

Note that Text::Format (http://rubyforge.org/projects/text-format) is
required.

== How can I use it?
=== Save the marked records to an output file in ISI Web of Science
Mark the articles in ISI Web of Science. Then, view and save the
marked records to an output file (savedrecs.txt). I recommend to
check “Author(s)”, “Title”, “Source”, “abstract*”, “keywords” and
“source abbreviation” as the fields to include in the output file.
=== Here are some examples
% isi2bibtex savedrecs.txt
% isi2bibtex savedrecs1.txt savedrecs2.txt > savedrecs.bib
% isi2bibtex < savedrecs.txt > savedrecs.bib
% cat savedrecs.txt | isi2bibtex > savedrecs.bib
=== You can use isi as a library.
T.B.A.

== Copying
isi is distributed in the hope that
it will be useful, but WITHOUT ANY WARRANTY.
You can copy, modify and redistribute isi,
but only under the conditions described in
the GNU General Public License (the “GPL”).

== Thanks to contributor(s)!

  • Marcin Dulak

== Who is the author?
Takeshi NISHIMATSU <t-nissie{at}imr.tohoku.ac.jp>

== Why did he write it?
Because he do not like the output format of the Perl version.

== Is there a Perl version?
Yes.
You can find the Perl version by Jonathan Swinton, Ben Bolker, Anthony
Stone, John J. Lee
in CTAN http://www.ctan.org/tex-archive/biblio/bibtex/utils/isi2bibtex .

== I do not like the output format of isi2bibtex, neither!
The output format is defined in the source code WYSIWYGly.
So you can change by yourself easily.

== Meanings of tags in ISI Export Format:
See http://isibasic.com/help/helpprn.html .
=== file-unique tags
FN: File type. The file starts with ‘FN ISI Export Format’
VR: Version number of ISI export file format
EF: End of file
=== normal tags
AB: Abstract
AF: Authors Full (AU Foo, BAR -> AF Foo, B. A. R.; AU Nishimatsu, T ->
AF Nishimatsu Takeshi)
AR: Article number of new APS journals
AU: Authors
BP: Beginning page
C1: Research addresses
CR: Cited references
DE: Original keywords
DI: DOI
DT: Document type
EP: Ending page
ER: end of a record
GA: ISI document delivery number
ID: New keywords given by ISI
IS: issue
J9: 29-character journal title abbreviation
JI: ISO journal title abbreviation
LA: Language
NR: Cited reference count
PD: Publication date e.g. “JUN 8” or “JUL”
PG: the number of pages
PI: Publisher city
PN: Part number
PT: Publication type (e.g., book, journal, book in series)
PU: Publisher
PY: Publication year
RP: Reprint address
SE: Book series title
SI: Special issue
SN: ISSN
SO: journal title, in full
SU: Supplement
TC: Times cited
TI: Title
UT: ISI unique article identifier
VL: Volume
WP: Publisher web address
=== isi original tags
UR: URL

== Known bugs

  • none.

== TODO

  • Write papers, not tools for writing papers.