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