From: "Brian Schröder" <ruby.brian@...>
Date: 2005-11-09T19:24:54+09:00
Subject: [ANN] rbibtex -- A bibtex parsing library for ruby

Hello Group,

I'm happy to announce my third mini-project within a few weeks. I
started a bibtex parsing library using racc and ruby.

This is the first library who's publication process I automated using
ara's rubyforge script and I'm very happy with it!

################################################################
# rbibtex
################################################################

## Description
A bibtex parsing library written in pure ruby.
With some additional executables that transform bibtex files.

This is my first attempt at racc so be patient with me. I hope to improve this
into a full bibtex parser in the near future, at the moment it parses the
bibtex subset that I need.

Another problem is that nearly no work went into the added scripts, which can
therefore be seen as usage examples, but may not help you with the work you
want to do.

I hope this will be a starting point for a more complete bibtex library for
ruby.

Cheers,

Brian

## Find it at

  http://ruby.brian-schroeder.de/rbibtex/

## Installation:

    wget http://ruby.brian-schroeder.de/rbibtex/releases/current.tar.bz2
    tar -xvvjf current.tar.bz2
    cd rbibtex-X.Y.Z
    ruby setup.rb

### As a gem

    $ su
    # gem install rbibtex

## Usage:

    rbib2html infiles > outfile

### or as a library:

    require "rbibtex"

    parser = BibTeX::Parser.new
    file = parser.parse( ARGF.read )
    file.each do | entry |
      p entry
    end

## ToDo
* The binaries are only quick hacks for my specific applications right now,
  they should be rewritten and extended.
* The full bibtex format is not parsed, I only allow for a specific subset
  right now.
* Escaping is not implemented.

## License
This library is under the ruby license

################################################################

--
http://ruby.brian-schroeder.de/

Stringed instrument chords: http://chordlist.brian-schroeder.de/