From: NISHIMATSU Takeshi <takeshi@...>
Date: 2007-05-01T06:04:17+09:00
Subject: [ANN] isi-1.1.2 is released!

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.
--------------------------------------------------------------------

-- 
love && peace && free_software
Takeshi Nishimatsu