Yo Emacs, pleased to be in -*- text -*- mode, thanks!
# Gutenbook README
# http://www.gutenbook.org/
# Copyright (C) 2000 Lee "Lefty" Burgess
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
This is an advanced Phase 1 design prototype of Gutenbook.
Gutenbook is written in Perl/GTK+ and uses the following Perl modules:
Gtk
Gtk::Keysyms
Data::Dumper
Date::Calc
FileHandle
File::Basename
URI::URL
LWP::UserAgent
HTTP::Request
HTTP::Response
Storable
Perl can be found at:
http://www.perl.com/pub/language/info/software.html
If you need to get and build the modules from CPAN, (http://www.perl.com/CPAN-local/modules/index.html) here is what you need:
Gtk-Perl-x.xxxx.tar.gz (Gtk is available at ftp://ftp.gimp.org/pub/gtk/)
Date-Calc-x.x.tar.gz
libwww-perl-x.xx.tar.gz (which recommends the following)
URI-x.xx.tar.gz
MIME-Base64-x.xx.tar.gz
HTML-Parser-x.xx.tar.gz
libnet-x.xxxx.tar.gz
Digest-MD5-x.xx.tar.gz (not required for Gutenbook)
Storable-x.x.x.tar.gz
Note: Life will be much easier for you if you use the CPAN module to automate the installation of these modules.
Configure or run CPAN in interactive mode like so:
$ perl -MCPAN -e shell
You may then install any CPAN module by invoking something like this:
cpan> install Storable
If you are using Debian Linux, it will suffice to point your sources.list file to look at potato (which is currently frozen) and "apt-get install" the following packages:
perl-5.005 (which you should have by default)
libdate-calc-perl
libgtk-perl
libwww-perl (which recommends the following)
libhtml-parser-perl (if not already required by libwww-perl)
libdigest-md5-perl (not required for Gutenbook)
libstorable-perl
These custom modules are distributed with Gutenbook:
PGB
PGB::Index
PGB::Etext
PGB::Network
PGB::File
PBG::PropList
I wanted to use Compress::Zlib to deal with zip'd Etexts, but that module is only for gzip compression. Any help or code along these lines would be greatly appreciated. Right now, Gutenbook just does a call to /usr/bin/(un)zip. It's crappy and I don't like it, but it works. So make sure you have zip/unzip on your system.
I use Data::Dumper for debugging, and for writing out the user properties in a human readable and easily parsable manner.
The Storable module is used for caching the Gutenberg index and local file information.
This program is being developed on a Debian Linux box, but it should work on just about any unix type platform with Perl, unzip and the required modules installed correctly.
See the INSTALL file to install Gutenbook.
Please send comments and feedback to lefty@red-bean.com.
Have fun!
Copyright 1999 Lee P.W. Burgess
The software this README accompanies is protected under the GNU General Public License included as the file COPYLEFT.
For a copy of the current GPL, you may also point your favorite web browser to:
http://www.gnu.org/copyleft/gpl.html
Or write:
Free Software Foundation
59 Temple Plase - Suite 330
Boston, MA 02111-1307, USA
Or email: