================================================= LiveGe'ez Remote Processing Protocol -=* Zobel *=- ----------------------- README file for the Zobel LiveGe'ez RPP Implementation. Zobel is a collection of modules and a front end CGI script that implement the LiveGe'ez Remote Processing Protocol specification. At this stage Zobel implements on the CGI query services fully and will (soon) be compliant with the HTML markup specification. Latest Zobel hype/summary: http://libeth.netpedia.net/Zobel/ Definitive info on the LiveGe'ez Remote Processing Protocol is found at: http://libeth.netpedia.net/LiveGeez.html If you do not intend to process Ethiopic web documents on remote servers, this package will not be very useful for you. Prerequisites for Zobel are the modules LWP::Simple, HTML::Entities, Convert::Ethiopic, and the old chestnut "cgi-lib.pl" and "cookies.pl" which have been included in the "bin" directory. Module LiveGeez::Request Instantiates an object that contains a parsed LiveGe'ez query. The request object is required by any other LiveGe'ez function of object. Module LiveGeez::Services Services.pm provides request processing services for a LiveGe'ez query as specified in the LiveGe'ez Remote Processing Protocol. "ProcessRequest" takes a LiveGe'ez LiveGeez::Request object and performs the appropriate service. Module LiveGeez::File Instantiates an object for processing an Ethiopic text or HTML document. The constructor requires a LiveGeez::Request object as an argument. Module LiveGeez::Cgi Instantiates an object for processing an Ethiopic text or HTML Program LiveGeez::HTML Provides the routines for conversion of HTML document content between Ethiopic encoding systems and for pre-interpretation of HTML markups for compliance with the LiveGe'ez Remote Processing Protocol. Program LiveGeez::CacheAsSERA Provides the routines for conversion of HTML document content from Ethiopic encoding systems into SERA for document caching and later conversion into other Ethiopic systems. Program LiveGeez::Local The required module by all other LiveGe'ez modules. Local.pm contains site specific settings for default encoding systems, language, and paths. Program Z.pl: The front end of the "Zobel" implementation of the LiveGe'ez Remote Processing Protocol. The expected and intended use is via CGI query, however the Z.pl script is serviceable at the command line as well. Installation: Obtain and install Convert::Ethiopic from where you found Zobel. LibEth is required: http://libeth.netpedia.net Download the tar.gz, unpack it, change to the Zobel-* directory. Then do Edit LiveGeez/Local.pm and bin/cookies.pl perl Makefile.PL make make install The scripts in "bin" are not automatically installed - you will probably want to install it in the appropriate place for CGI service on your system (vs /usr/local/bin etc.) Available: ftp://ftp.ethiopic.org/pub/perl-unicode/ and from your favorite CPAN site in the authors/id/D/DY/DYACOB/ directory. Copyright: (c) 1999 Daniel Yacob, Yacob@EthiopiaOnline.Net. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.