Title Greenstone digital library software Purpose A suite of digital library software which includes the ability to serve digital library collections and build new collections Author New Zealand Digital Library Project License GNU General Public Licence (Version 2) Full terms and conditions are in the file "COPYING" on this CD-ROM Date November 2007 Version 2.75 Documentation Install.pdf Greenstone Digital Library Installer's Guide User.pdf Greenstone Digital Library User's Guide Develop.pdf Greenstone Digital Library Developer's Guide Paper.pdf From paper to collection Additional Utilities Librarian Interface A graphical tool for collection building using Greenstone (requires version 1.4 of the Java Runtime Environment, included on this CD-ROM) Platform Unix and Windows. Binaries and source code are included. The Greenstone user interface uses a Web browser capable of Javascript, Tables, and Frames. Browsers that meet these requirements include: Netscape Navigator 4.0 Internet Explorer 4.0 Mozilla, Safari More recent versions of these browsers should also work. Unix Source code has been compiled and tested on Linux and Solaris. Binary code requires an Intel x86-based Linux distribution which includes ELF binary support and supports the GNU C library (glibc 2.0 or greater). Distributions that meet these requirements include: RedHat 5.1 SuSE Linux 6.1 Debian 2.1 Slackware 4.0 More recent versions of these distributions should also work. Windows Source code has been compiled with Microsoft Visual C++ 4.2 and 6.0 Binary code has been tested on Windows 3.1, 95/98, NT, 2000, XP Restriction: The building process requires PERL, and so collections cannot be built under Windows 3.1 Install Install.pdf describes the complete installation procedure for both Unix and Windows, and includes tutorial information about configuring Greenstone and configuring the Apache, PWS and IIS Web Servers appropriately. Self-explanatory install scripts are provided for both Unix and Windows, which take you step by step through the installation procedure and provide appropriate options at each stage. Windows 9x/NT/2000/XP installation: execute setup.exe Unix installation: execute setupLinux.bin Uninstall scripts are provided which clean up should installation fail. Support Please report any problems installing or running the Greenstone Digital Library Software using the bug report form provided as Support.htm in the top level directory of this CD-ROM. There is a Greenstone mailing list that you can join at http://greenstone.org/english/docs.html. Both this page and the faq list at this site point to a lot of helpful information. Contents of this CD-ROM README.TXT This document COPYING Gives the conditions under which this software can be copied Support.htm Form for reporting problems installing or running Greenstone setup.exe Windows self-install program (includes option to install binaries or source) setupLinux.bin Linux self-install program (includes option to install binaries or source) docs Documentation, including the following: Install.pdf Installer's Guide Describes the installation procedure for both Unix and Windows, and includes tutorial information about configuring Greenstone and the Apache Web Server. User.pdf User's Guide Provides a comprehensive description of how to use the Greenstone software for accessing and building collections. Develop.pdf Developer's Guide This manual describes how Greenstone works. It is aimed at those who wish to customize collections and to develop and maintain the software. Paper.pdf From Paper to Collection This manual gives practical information on creating digitized collections from full text documents. Unix Unix version, including Linux binaries The top-level files and directories are: Install.sh Unix installation shell script (if run on Linux, includes option to install binaries; otherwise installs source) bin Linux binaries Windows Windows binaries The top-level files and directories are: bin Windows binaries gsdl Greenstone digital library software directory structure. This mirrors the Greenstone digital library directory structure that will be installed. bin Executable code cgi-bin CGI scripts collect Greenstone collections (includes Demo collection, pre-built indexes and source documents) etc Configuration files, logs, etc gli Greenstone Librarian Interface tool images Images used by interface macros Display macros perllib Perl modules used when building mappings Unicode translation tables The installation procedure installs files into some of these directories as follows: top level Batch file or shell script bin Executable code cgi-bin CGI scripts collect The Greenstone Demo collection Additional collections as specified at install time src, lib, packages Source code if specified at install time collect Greenstone collections (prebuilt) - note that although the install procedure only installs the prebuilt indexes, the original source documents for each collection are available on the CD-ROM. The source documents may be useful for those attempting to create new collections which copy the format of these collections. demo Greenstone demo dls-e Development Library Subset collection wrdpdf-e MSWord and PDF demonstration gsarch-e Greenstone Archives collection cltbib-e Bibliography collection cltext-e Bibliography supplement MARC-e MARC example oai-e OAI demo image-e Simple image collection pagedimg-e Paged image collection authen-e Formatting and authentication demo garish Garish version of demo collection style-e CSS demo collection isis-e CDS/ISIS example src Program source files Windows Configuration information for Windows Unix Configuration information for Unix lib C++ library code packages C++ source code for packages used by Greenstone src C++ source code