source: release-kits/shared/greenstone2/docs/READMEen.txt@ 18013

Last change on this file since 18013 was 18013, checked in by max, 15 years ago

Update the readme file to V2.81rc

File size: 4.5 KB
Line 
1Title Greenstone digital library software
2
3Purpose A suite of digital library software which includes the ability to
4 serve digital library collections and build new collections
5
6Author New Zealand Digital Library Project
7
8License GNU General Public Licence (Version 2)
9 Full terms and conditions are in the file "LICENSE.txt"
10
11Date December 2008
12
13Version 2s2008.12.01
14
15Contents: Programs
16 Greenstone library server A cgi program to serve digital library collections
17 Greenstone oaiserver A cgi program to serve collections using the OAI-PMH protocol.
18 Greenstone Librarian Interface (GLI)
19 A graphical tool for collection building
20 Greenstone Editor for Metadata Sets (GEMS)
21 A graphical tool for creating and editing metadata sets used by GLI
22
23Contents: Directory Structure
24 bin Executable code
25 cgi-bin CGI scripts
26 collect Collections
27 etc Configuration files, log files, user databases etc
28 gli Librarian Interface
29 images Images and CSS files used by the interface
30 macros Display macros
31 mappings Unicode translation tables
32 perllib Perl modules used for collection building
33
34 If source code is present (from a source release or by adding the source component):
35 common-src Source code and packages used when building collections and at runtime
36 build-src Source code and packages only used when building collections
37 runtime-src Source code and packages only used at runtime
38
39Additional Packages
40 TODO java, image magick, perl, ...
41
42 Documentation and Support
43 Greenstone Website:
44 http://www.greenstone.org
45 Greenstone's main website.
46 Greenstone Wiki:
47 http://wiki.greenstone.org
48 Contains documentation, and links to manuals, tutorials etc...
49 Greenstone Mailing List:
50 https://list.scms.waikato.ac.nz/mailman/listinfo/greenstone-users (to subscribe)
51 [email protected] (to post)
52 New Zealand Digital Library:
53 http://www.nzdl.org
54 A demonstration site containing lots of collections
55
56
57Platform
58 Greenstone runs on Unix, Windows 2000/XP/2003/Vista/2008 and Mac OS 10.5.2 (Leopard).
59
60
61 The Greenstone Librarian Interface requires version 1.4 or later
62 of the Java Runtime Environment. Java 1.6 is included in the binary
63 release of Greenstone.
64
65 The Greenstone user interface uses a Web browser capable of Javascript,
66 Tables, and Frames. Browsers that meet these requirements include:
67
68 Netscape Navigator 4.0
69 Internet Explorer 4.0
70 Mozilla
71 Safari
72
73 More recent versions of these browsers should also work (recommended).
74
75
76
77Unix
78Source code has been compiled and tested on Linux and Solaris.
79 Binary code requires an Intel x86-based Linux distribution which
80 includes ELF binary support and supports the GNU C library (glibc 2.0
81 or greater). Distributions that meet these requirements include:
82
83 RedHat 5.1
84 SuSE Linux 6.1
85 Debian 2.1
86 Slackware 4.0
87
88 More recent versions of these distributions should also work.
89
90 We have tested Greenstone 2 on the following distributions:
91 Ubuntu 8.04 & 8.10
92 Mandriva 2008 Spring
93 OpenSUSE 11
94 Fedora 6 & 9
95 CentOS 5.2
96
97Windows
98Source code can be compiled with Microsoft Visual C++ 6.0, 7 (VS 2003.Net),
998 (VS 2005 Pro or VC++ Express 2005 with Microsoft Platform SDK 2003 R2).
100
101 Binary code has been tested on 32 bits version of:
102 Windows 2000
103 Windows XP
104 Windows Server 2003
105 Windows Vista
106 Windows Server 2008
107
108 Greenstone software (version 2.81 and later) no longer runs on
109 Windows 3.1
110 Windows 95
111 Windows 98
112 Windows Me
113 Windows NT
114
115Mac
116Source code has been compiled with Xcode 3.1 on Intel Mac OS 10.5.2.
117Binary has been tested on Intel Mac OS 10.5.2 (Leopard).
118
119However the source code can be compiled with other versions of Mac OS and Xcode,
120in that case please download Imagemagick and Ghostscript to recompile them from source.
Note: See TracBrowser for help on using the repository browser.