Sablotron Module for Ruby
=========================

This is a Ruby interface to Sablotron, the XSLT processor
developed by Ginger Alliance.

This module supports Sablot-0.60 and Ruby-1.6.2 or higher.


License and Warranty
--------------------

This module's license is the combination of MPL(Mozilla Public
License) and GPL.

Further information of these licenses:
  http://www.mozilla.org/MPL  (about MPL)
  http://www.gnu.org/copyleft/gpl.html  (about GPL)

And, I offer NO WARRANTY for using this module in any conditions.


How to Install
--------------

You get Sablotron and install it.
  Sablotron URL: http://www.gingerall.com/

and install this module in the ordinary way, such as:

  ruby extconf.rb
  make
  make install

You can specify the location of Sablot files with command line
switch:
   --with-sablot-dir=/path/to/Sablot
   --with-sablot-lib=/path/to/Sablot/libdir
   --with-sablot-include=/path/to/Sablot/includedir

   --with-iconv   (when you use iconv library)
   --with-iconv-dir=/path/to/iconv
   --with-iconv-lib=/path/to/iconv/libdir
   --with-iconv-include=/path/to/iconv/includedir

   --with-expat-dir=/path/to/expat
   --with-expat-lib=/path/to/expat/libdir
   --with-expat-include=/path/to/expat/includedir

Sample files
------------

In directory `sample', There are sample documents, stylesheets and
scripts.

  sample/basic
    basic sample.

  sample/encoding
    encoding translation sample.

  sample/handler
    handler sample.


Class Document
--------------

please see doc/sablot.rd (in RD format).


Future Plan
-----------

 * implement Handler class.
 * add tests (using RubyUnit) and samples.


History
-------

version 0.5.2  (Oct 7, 2001)
 * fix document(command line options).

version 0.5.1  (Sep 9, 2001)
 * change search order of libraries(thanks to KUNISHIMA Takao).

version 0.5.0  (Jun 24, 2001)
 * support message handlers.
 * add more comment to document.
 * divide and add sample.
 * add japanese README.ja

version 0.4.1  (Jun 21, 2001)
 * add setEncoding(). (by Takaaki Tateishi)
 * add --with-iconv and --with-expat . (by Takaaki Tateishi)
 * add more samples (by Takaaki Tateishi and me)

version 0.4.0  (Mar 11, 2001)
 * add createProcessor and runProcessor and resultArg.
 * add setBase and setBaseForSchema.
 * fix extconf.rb to add --with-oldgcc option and add messages.

version 0.0.2  (Dec 04, 2000)
 * add --with-sablot-dir option (by Aleksi Niemela)
 * fix minor bug in README (by Aleksi Niemela)

version 0.0.1  (Sep 25, 2000)
 * initial version.


------
TAKAHASHI Masayoshi(maki@rubycolor.org).

