package Global
_t17_ {
The downloads available from the download page
are hosted by Sourceforge.
}
#######################################################################
package home
_t1_ {About Greenstone}
_t2_ {
Greenstone is a suite of software for building and distributing digital
library collections. It provides a new way of organizing information and
publishing it on the Internet or on CD-ROM. Greenstone is produced by the
New Zealand Digital Library Project at the University of
Waikato, and developed and distributed in cooperation with
UNESCO and the Human Info NGO. It is open-source,
multilingual software, issued under the terms of the GNU General Public
License.
}
_t3_ {
UNESCO is running regional training workshops on the use of Greenstone.
Here is a report of one held in
Bangalore, India, in August 2003. Another will be conducted in Dakar,
Senegal in September 2003, and a third in Suva, Fiji, in November 2003.
}
_t4_ {
Greenstone v2.40a has now been released! Download it from here. This release
is the same as Greenstone v2.40, except it features better integration of
the Librarian Interface tool.
}
_t5_ {
One of the trickier parts of using Greenstone is coming up with a
configuration file for your collection. To help learn how to do it, here is a
new document that presents, and explains, the configuration files for a few
actual Greenstone collections, and also gives an example of how
Greenstone's appearance can be customized.
}
_t6_ {
The complete Greenstone interface, and all documentation, is available in
English, French, Spanish, Russian and
Kazakh. Greenstone also has interfaces in many other languages. We are looking for volunteers to add new language
interfaces and help maintain existing ones.
}
_t7_ {
The aim of the software is to empower users, particularly in universities,
libraries, and other public service institutions, to build their own
digital libraries. Digital libraries are radically reforming how
information is disseminated and acquired in UNESCO's partner communities
and institutions in the fields of education, science and culture around the
world, and particularly in developing countries. We hope that this
software will encourage the effective deployment of digital libraries to
share information and place it in the public domain. Further information
can be found in the book How to build a
digital library, authored by two of the the group's project members.
}
_t8_ {
The collect.cfg files for many of the collections at www.nzdl.org have been made available here.
}
_t9_ {
This software is developed and distributed as an international cooperative
effort established in August 2000 among three parties.
}
_t10_ {
New Zealand Digital Library Project at the University of Waikato
}
_t11_ {
Greenstone software grew out of this project, and this initiative has been
endorsed by the Communication Sub-Commission of the New Zealand National
Commission for UNESCO as part of New Zealand's contribution to UNESCO's
programme.
}
_t12_ {
United Nations Educational, Scientific and Cultural Organization
}
_t13_ {
The dissemination of educational, scientific and cultural information
throughout the world, and particularly its availability in developing
countries, is central to UNESCO's goals as pursued within its
intergovernmental Information for All Programme, and appropriate,
accessible information and communication technology is seen as an important
tool in this context.
}
_t14_ {
The Human Info NGO, based in Antwerp, Belgium
}
_t15_ {
This project works with UN agencies and other NGOs, and has established a
worldwide reputation for digitizing documentation of interest to human
development and making it widely available, free of charge to developing
nations and on a cost-recovery basis to others.
}
_t16_ {
If you download Greenstone and install it with standard demonstration
collections, or if you install it from the Greenstone CD-ROM, it will look
exactly like this.
}
#######################################################################
package download
_t18_ {Download Greenstone}
_t19_ {
Greenstone is open-source software, distributed under the terms of the GNU General Public
License. It runs on Windows and Unix, and both source code and binaries
are available for download. It is fully documented in English, French,
Spanish and Russian.
}
_t20_ {
Select the Greenstone distribution you require from the list below. Each
distribution provides a complete interface in English, French, Spanish and
Russian.
}
_t21_ {
Each distribution also includes the "Greenstone Librarian
Interface", a graphical tool for building digital libraries. It gives
you access to Greenstone's functionality from an easy-to-use 'point and
click' interface. To use this tool you will need a suitable Java Run-time
Environment, which you can download from here (choose the
JRE, not the SDK).
}
_t22_ {Windows distribution}
_t23_ {
This is the distribution you want if you're going to run Greenstone under
any 32 bit Windows environment (that is, Windows 95/98/Me/NT/2000/XP etc.).
}
_t24_ {
Note that Greenstone will also run on 16 bit Windows (that is, Windows
3.1/3.11). The installer program used by this distribution will not work on
these versions of Windows however. Please contact us if you need a version of
Greenstone for 16 bit Windows.
}
_t25_ {
Using this distribution you may either install the "local
library", the "web library", or install and compile the
source code (click here for a
description of the differences between the "local library" and
the "web library"). You will be asked which form of Greenstone
you want during the installation process.
}
_t26_ {
This distribution includes everything you need to run Greenstone (including
a pre-built demonstration collection) and to build new Greenstone
collections. Some functionality is not included however, mostly in an
attempt to keep the distribution as small as possible. See below for details on how to get this missing
functionality.
}
_t27_ {
This distribution uses a standard Windows installer program, simply
download the file and double-click it to install (see the Installer's Guide for more detailed
installation instructions).
}
_t28_ {Unix distribution}
_t29_ {
This is the recommended distribution if you're installing Greenstone on any
form of Unix.
}
_t30_ {
This distribution comes with statically linked linux binaries. However, it
also contains the Greenstone source code for compiling on other forms of
Unix (or on linux if you prefer not to use the provided binaries).
}
_t31_ {
This distribution includes everything you need to run Greenstone (including
a pre-built demonstration collection) and to build new Greenstone
collections. Some functionality is not included however, mostly in an
attempt to keep the distribution as small as possible. See below for details on how to get this missing
functionality.
}
_t32_ {
To install this distribution, extract the gzipped tar archive and run the
Install.sh shell script from within the gsdl-X.XX-unix/Unix
directory (see the Installer's Guide for
more detailed installation instructions).
}
_t33_ {Mac OS X distribution}
_t34_ {
This distribution contains dynamically linked binaries for Mac OS X running
on PowerPC platforms.
}
_t35_ {
This distribution has been tested on Mac OS X 10.2.6. It includes the
pre-built binaries and also includes the demonstration collection,
unbuilt. This is the first distribution for the Mac that includes the
Greenstone Librarian Interface for building collections.
}
_t36_ {Source only distribution}
_t37_ {
This distribution contains the Greenstone source code along with the same
demonstration collection as the distributions above (although the
collection is not pre-built in this distribution).
}
_t38_ {
This distribution does not have an automated installation proceedure
(running Install.sh will not work). Unless you're sure you know what
you're doing you probably want one of the distributions above, both of
which also contain the Greenstone source. Note that you can obtain an
up-to-date version of the Greenstone source code at any time by using cvs.
}
_t39_ {
The following extra packages may be downloaded and installed along with an
existing Greenstone installation to add functionality that was left out of
the distributions above.
}
_t40_ {Export to CD-ROM package}
_t41_ {
This package enables the "export to CD-ROM" function from within
Greenstone's Collector.
}
_t42_ {
To install, simply download the file (it will work on both Windows and Unix
and any version of Greenstone above 2.34) and extract the zip archive into
the gsdl\\bin\\windows directory of your existing Greenstone installation.
}
_t43_ {
The following utilities have been developed to be used along with
Greenstone.
}
_t44_ {The Organizer}
_t45_ {
The Organizer is a Windows application useful for automatically generating
many of the configuration files (metadata.xml, sub.txt etc.) required by
complex Greenstone collections.
}
_t46_ {
To install, simply download and double-click the self-extracting executable
file.
}
#######################################################################
package examples
_t47_ {Examples of Greenstone in Action}
_t48_ {New Zealand Digital Library Project}
_t49_ {
A demonstration site set up by the developers of Greenstone, the New
Zealand Digital Library Project. This site contains many collections,
ranging from humanitarian information to computer science technical reports
to demonstration collections of Chinese and Arabic documents.
}
_t50_ {Russian Greenstone Library}
_t51_ {
A Greenstone site containing several collections in the Russian
language. This site was set up by a regional government department in the
Mari El Republic of the Russian Federation.
}
_t52_ {Project Gutenberg}
_t53_ {
An on-going project to produce and distribute free electronic editions of
literature, Project Gutenberg now contains more than 3,700 titles from
Shakespeare to Dickens to the Bronte sisters. This site, maintained by
Ibiblio, one of the original Gutenberg mirror sites, uses Greenstone to
make the entire Gutenberg collection available in a fully searchable form.
}
_t54_ {University of Applied Sciences, Stuttgart}
_t55_ {
Hochschule der Medien - an "Information and Media" digital
library created by the University of Applied Sciences, Stuttgart, Germany.
}
_t56_ {Gresham College Archive}
_t57_ {
A digital library created at Gresham College, London, England.
}
_t58_ {Center for the Study of Digital Libraries}
_t59_ {
Texas A&M University - A digital libraries research site containing
prototypical Greenstone collections with an emphasis on Digital Floras.
}
_t60_ {Peking University Digital Library}
_t61_ {
Two experimental collections created at Peking University.
}
_t62_ {Music Information Retrieval Research}
_t63_ {
Virtual home of music information retrieval research.
}
_t64_ {Photograph Album}
_t65_ {
A collection of photographs taken by Gordon Paynter.
}
_t66_ {Washington Research Library Consortium Special Collections}
_t67_ {
Digital material from the special collections of the eight universities of
WRLC in Washington, D.C., USA.
}
_t68_ {Archives of Indian Labour}
_t69_ {
A collaborative project between the V.V. Giri National Labour Institute and
the Association of Indian Labour Historians. The Archives of Indian Labour
are dedicated to preserving and making accessible the fast depleting
documents on the Indian working class.
}
_t70_ {NCSI Demonstration Collections}
_t71_ {
Demonstration collections created by students and staff at the National
Centre for Science Information, Indian Institute of Science, Bangalore,
India. Many of these collections include content in Kannada and Hindi.
}
_t72_ {New York Botanical Garden}
_t73_ {
The rare book digitization project of the LuEsther T. Mertz Library of the
New York Botanical Garden.
}
_t74_ {Lehigh University Digital Bridges Collection}
_t75_ {
A collection containing thirty books about bridges, all of which were
published between 1811 and 1899. The collection was created at Lehigh
University, Pennsylvania and features a heavily customized user interface.
}
_t76_ {Chopin Early Editions}
_t77_ {
A collection of digital images of early printed editions of musical
compositions by Frédéric Chopin. This collection was created
by the University of Chicago Library and, once completed, will include its
entire collection of over 400 Chopin early editions. The greenstone
collection configuration file for this collection has also been made
available and can be downloaded here.
}
_t78_ {Slavonski Brod Public Library}
_t79_ {
The pilot project of digitization of local studies collection in Slavonski
Brod Public Library, Croatia.
}
_ex1t_ {Mirabilia Vicomercati}
_ex1d_ {
Mirabilia Vicomercati is an on-going project managed by Vimercate Public Library (Milan, Italy), aimed at the digitization of local history primary sources. Several collections will be provided - photographs, postcards, maps, text, reference, multimedia - in order to make accessible, promote and preserve the historical memory of Vimercate and its territory.
}
_ex2t_ {Illinois Wesleyan University Argus Digital Collection}
_ex2d_ {
Illinois Wesleyan University's newspaper The Argus has been published under student supervision continuously since 1894. This digital collection is part of an on-going project to preserve and provide access to Argus volumes published from 1894-2000. |
This site contains documents, photos and books covering files of children kidnapped during the 1976-1983 dictatorship, leglislation on identity, jurisprudence-related information, and many other items. It was created by the Secretary of Human Rights of Argentina under the Comisión Nacional por el Derecho a la Identidad (CONADI), which is a National Commission that fights for the right that a person has for knowing his or her identity -- particularly when their parents have disappeared. |
This site contains two Greenstone collections. Alabama Postcards has over 300 postcards depicting buildings, natural settings, events and other scenes in various Alabama cities and towns in the early 20th century. These images are categorized by place as well as by title. Alabama Authors gives information about 20th Century Alabama Authors which is maintained and updated by the Alabama Library Association. This collection began life as a printed document created in WordPerfect 5.2 and has been through several iterations before becoming fully searchable under Greenstone. |
Please note that the downloadable Windows distribution of Greenstone comes with an installer that will not work on 16 bit Windows. If you need to use Greenstone on Windows 3.1/3.11 please contact us.
} _t211_ { There are two Greenstone mailing lists. You can subscribe to them from the documentation page. } _t212_ { The most popular mailing list (greenstone-users@list.scms.waikato.ac.nz) is archived as a Greenstone collection at www.nzdl.org. Note that this collection is updated only sporadically so may not always be completely up to date. } _t213_ { We welcome contributions or improvements to the Greenstone software!Before beginning work, you should announce what you're doing on the greenstone developer's list to tell us what you plan to do and get some feedback.
} ####################################################################### package faqob _t215_ { From the greenstone.org download page. } _t216_ { Yes. At present there are binary distributions for 32 bit Windows, PowerPC Mac OS X, and i386 linux. They can be downloaded from the download page. } _t217_ { While some version 2.37 and 2.38 CD-ROMs have been produced they're not currently being made widely available. You are encouraged to download the latest release of Greenstone from the download page. If your internet connection is such that downloading Greenstone isn't possible please contact us and we may be able to arrange for a CD-ROM to be sent out. } _t218_ { Yes, see our CVS page for details. } ####################################################################### package faqinst _t220_ { See our compiling page. } _t221_ { Firstly, the local library is only available if you're running Greenstone under Windows. It's not yet available on Unix.The major difference between the two is that the local library contains it's own built-in webserver. The web library however, requires an external webserver like Apache or Microsoft IIS. This makes the local library much easier to install and configure than the web library.
For this reason, it's recommended that Windows users install the local library unless they're sure that they need the web library. Even if you think you might need the web library, try installing the local library first. You can always uninstall it later and install the web library if you then decide you need it.
A situation where the web library may be preferable is if you plan to serve your Greenstone collections as a full-time service on the web. In this case you'll probably want the added stability that running the web library in conjunction with an external webserver can provide.
Please note that the local library is quite capable of serving Greenstone collections over a local area network or the web (despite its rather misleading name).
} ####################################################################### package faqrun _t223_ { If you're using the Windows local library you should be able to simply select "Greenstone Digital Library" from within the programs in your start menu.If you're using the web library things are a little less obvious however. First make sure your webserver is configured correctly and is running (see the Greenstone Installer's Guide and your webserver's documentation for details). You can then simply open your web browser and point it at the URL of Greenstone's library executable. This is dependant on the way you configured Greenstone and your webserver. Typically it might be something like http://localhost/gsdl/cgi-bin/library.exe.
} _t224_ { Greenstone relies on a web browser that supports tables, javascript, and in some places, frames. Any reasonably modern browser will do. Examples are Microsoft Internet Explorer 4, Netscape 4, and Mozilla. Newer releases of all these browsers will also work.If you find that your favourite web browser does not work with Greenstone, please contact us.
Note that there is an exception to the rule that any modern browser will do when running Greenstone. That is when you're using the restricted version of the Windows local library when you must use Netscape. See the discussion below on the differences between the "Restricted Version" and the standard "Enter Library" version of the local library for details.
} _t225_ { The webserver built into the local library uses the networking software built into your Windows operating system in order to function. If your computer has never been connected to a network this networking software may not be installed however. For this reason Greenstone comes with some networking software of it's own that it will use if it can't find any installed on your computer.When you click the "Enter Library" button, Greenstone first checks to see if your computer has it's own networking software. If it does, it starts up using that, if not it starts up using it's own networking software.
When you click the "Restricted Version" button, Greenstone doesn't bother checking your system for networking software, it just goes ahead and uses it's own.
The catch is that there are several limitations with using the Greenstone supplied networking software. The most important limitations are that the local library won't be accessible from the network if run in this way (that is, it really will be "local" to the machine on which it's running) and that it must use a Netscape web browser. Using your computer's built-in networking software is therefore the prefered option.
} _t226_ { Since Greenstone will automatically use it's own networking software if it can't find any installed on your computer it should not normally be necessary to run the "Restricted Version" explicitly.Times when it may be necessary are.
If this does not solve the problem, try starting the local library by clicking the "Restricted Version" button rather than the "Enter Library" button. See the discussion above on the differences between the standard and restricted versions of the local library for further details.
} _t228_ {If you installed Greenstone using the InstallShield installer on Windows or the Install.sh script on Unix you should have been asked to set a password during the installation procedure.
If you didn't, don't worry, the password defaults to being admin.
So if you don't know what to enter you should try username = admin, password = admin.
} _t231_ { This may be caused by the URL becoming too long for your web browser. Because Greenstone currently stores all state information in the URL, if you do a search for a long phrase the URL can become very long. Different browser's on different platforms have different maximum URL lengths but in general it seems that Netscape can handle longer URLs than can Microsoft Internet Explorer.
There is very little you can do to avoid this problem with the way Greenstone is currently implemented (aside from not searching for long phrases). Future versions of Greenstone may store some state information on the server rather than in the URL but this has yet to be implemented.
} ####################################################################### package faqbuild _t233_ { The Collector is a web interface for building new collections, altering or deleting existing collections, and exporting existing collections to stand-alone CD-ROMs. The Collector is a standard part of a Greenstone installation. To begin using the Collector, click the "The Collector" button on your Greenstone home page. For further details on using the Collector see the Greenstone User's Guide. } _t234_ { It's occasionally preferable to build your Greenstone collections from the command line rather than from the Collector. This allows you greater control over how your new collection turns out. See the Greenstone Developer's Guide for detailed step by step instructions on building collections from the command line. } _t235_ { Are you running Norton Anti-Virus? There are some incompatibilities between Norton and the Greenstone collection building process that cause unpredictable things to happen if you build your collection while Norton is running. Try disabling Norton and rebuilding the collection.If you do not have Norton or disabling Norton does not solve the problem please contact us for further help.
} _t236_ { If you downloaded Greenstone from the web you will not have all the components required to make the "export to CD-ROM" function work. These extra components have been made available in a separate download which you can get from the download page. } _t237_ { Are you using a Netscape web browser with the local library? If so, try using Internet Explorer instead. There are some socket connection problems that show up on Windows 2000 when using Netscape. } _t238_ { The Organizer (also called the "Collection Organizer") is a Windows utility used for automatically generating some of the configuration files (metadata.xml, sub.txt etc.) used by complex Greenstone collections. } _t239_ { From the download page. } _t240_ { There are several reasons that the collector might fail to build a collection and the error messages it produces are not always very helpful.If you changed the default configuration during the configure collection stage you'll need to make sure the changes were valid. For example, if you added a new classify or plugin line you'll need to make sure that the classifier and/or plugin names and arguments are all correct. If they're not the collector will fail. A good test is to build your collection without changing the configuration. If it builds ok with the default configuration but fails after you change the configuration you'll need to look closely at the changes you're making.
Another good thing to do if having problems with the collector is to build your collection from the command line instead. You'll get much more feedback to help debug problems when building in this way. For details on how to build a collection from the command line see the Greenstone developer's guide.
} _t241_ { The collect.cfg files for many of the collections at www.nzdl.org have been made available here. } _t242_ { The MGPP user manual gives some instructions. } _tfaqbuild11body_ { To create and add the new buttons for a new classifier, there are several macro files that need to be edited. This is an example for the Countries metadata. Countries is the metadata name (or buttonname), count is the short form used in image names, countries is the text that appears on the nav bar buttons and the green title.These lines should all be put next to the other ones ones of the same type. Use Title as an example to search for the approriate place to insert.
base.dm:
\_Countrieswidth\_ \{\_widthcountx\_ \}
\_imageCountries\_ \{\_gsimage\_(\_httpbrowseCountries\_,\_httpicontcountof\_,\_httpicontcounton\_,countries,\_textimageCountries\_)\}
\_icontabCountriesgreen\_ \{<img
src="\_httpicontcountgr\_" width=\_widthtcountx\_ border=0>\}
\_icontabCountriesgreen\_[v=1] \{\_texticontabCountriesgreen\_ \}
document.dm:
\_textCountriespage\_ \{\_texticonhcount\_ \}
\_iconCountriespage\_ \{<img src="\_httpiconhcount\_" width="\_widthhcount\_"
height="\_heighthcount\_">\}
\_iconCountriespage\_ [v=1] \{<h2>\_texticonhcount\_</h2>\}
english.dm:
\_textimageCountries\_ \{Browse by countries\}
\_texticontabCountriesgreen\_ \{Countries\}
\_texticonhcount\_ \{Countries\}
\_textCountriesshort\_ \{access publications by country\}
\_textCountrieslong\_ \{<p>You can <i>access publications by country</i> by
pressing the <i>countries</i> button. This brings up a list of countries. \}
## "countries" ## nav\_bar\_button ## tcount ##
\_httpicontcountgr\_ \{\_httpimg\_/tcountgr.gif\}
\_httpicontcountof\_ \{\_httpimg\_/tcountof.gif\}
\_httpicontcounton\_ \{\_httpimg\_/tcounton.gif\}
\_widthtcountx\_ \{87\}
## "countries" ## green_title ## h_count ##
\_httpiconhcount\_ \{\_httpimg\_/h\_count.gif\}
\_widthhcount\_ \{200\}
\_heighthcount\_ \{57\}
The images that are needed are the nav bar images, and the title image with the green bar in the background. There are 3 nav bar images: tcountgr.gif is the green one and tcounton.gif and tcountof.gif are the two yellow ones for the rollover effect. h_count.gif is the title image.
These images can be generated by copying the two ## blocks from above into a temp file and running translate.pl on it eg.
translate.pl -language_symbol en temp.dm
To add the images in other languages, you need to edit the appropriate language macro file, and add the same items as for english.dm. And run the translate script to generate the images.
English versions of the images should be placed in the $GSDLHOME/images directory, while other language versions should be placed in the appropriate subdirectory of $GSDLHOME/images, for example $GSDLHOME/images/fr for french images. } ####################################################################### package faqplugins # base puts in surrounding
and
, so skip first and last ones # _metadata_ { "Default" means that the metadata fields will be automatically assigned (or extracted if possible), while the "Available fields" lists other items of metadata that the plugin may be able to assign based on any arguments given to that plugin in the collect.cfg file. All plugins are derived from BasPlug, and have following metadata fields:Default fields | Available fields | |
---|---|---|
BasPlug | Language, Encoding, Source | FirstNNNN, kea, Acronym |
In addition, many plugins have additional fields available:
Plugin name | Default fields | Available fields |
---|---|---|
BibTexPlug | Title, Creator, Abstract, Author, Booktitle, Chapter, Copyright, Date, Edition, Editor, EntryType Journal, Keywords, Month, Note, Number, Pages, Publisher, PublisherAddress, Volume, Year | |
DBPlug | (arbitrary metadata field names based on Database configuration file) | |
EMAILPlug | Date, DateText, From, FromAddr, FromName, Headers, Subject, Title (based on subject, from, and date), To | |
ExcelPlug | (all fields as in HTMLPlug) | |
HTMLPlug | Title, URL | Author, Creator, Email (others as found in the -metadata_fields option) |
ImagePlug | Image, ImageHeight, ImageSize, ImageType, ImageWidth, ScreenHeight, screenicon, ScreenSize, ScreenType, ScreenWidth, Source, srclink, srcicon, Thumb, ThumbHeight, ThumbType, ThumbWidth | |
IndexPlug | as in the index.txt file | (use metadata.xml files instead of using this plugin) |
MARCPlug | Creator, Description, MarcIdentifier, MarcSource, URL, Publisher, Relation, Rights, Subject, Title, Type | (Metadata fields as in the marctodc.txt file) |
OAIPlug | URL, (all metadata in .oai markup file) | |
PDFPlug | (all fields in HTMLPlug) | |
PPTPlug | (all fields in HTMLPlug) | |
PSPlug | Title | Date, Pages, (all fields in TextPlug) |
ReferPlug | Abstract, BookConfOnly, Booktitle, Copyright, Creator, Date, Editor, Keywords, Journal, JournalsOnly, Number, Pages, Publisher, Publisheraddr, Report, Title, Volume | |
RTFPlug | (all fields in HTMLPlug) | |
SRCPlug | Title, filename, includes, class, classdecl | |
TEXTPlug | Title | |
UnknownPlug | (as given in the -assoc_field plugin argument) | |
WordPlug | (all fields in HTMLPlug) |
See section two of the _docs:developersguide_ for information about options to plugins, or run the pluginfo.pl command on the plugin name after setting up your environment for Greenstone. (For example, "perl -S pluginfo.pl BasPlug".)
In addition, every document can be manually assigned arbitrary metadata fields and values through use of metadata.xml files, as discussed in the manual. } # base puts in surrounding
and
, so skip first and last ones # _pdfproblems_ { PDF is a "page description language". This means that the document contains objects and commands such as "draw this text here" and "draw this image here".Greenstone uses an external program called "pdftohtml" to extract text out of PDF files. Sometimes, there is no text that can be extracted. This often depends on how the PDF was created.