Greenstone tutorial exercise
Updating a Greenstone installation
These tutorial exercises assume that you are using Greenstone 2.60 or above.
Before updating to a new version of Greenstone, ensure that the computer is not running the Greenstone Librarian Interface or the Greenstone local library server. Normally, quitting your web browser, or quitting the Librarian Interface, also quits the server.
Removing Greenstone from a Windows system
Completely remove the existing version before you install a new version of Greenstone.
-
Ensure that you are not running Greenstone.
-
Remove the old version by going to the Windows Control Panel (from the Settings item on the Start menu). Click Add or Remove Programs, select Greenstone Digital Library Software, and Remove it. (To do this you may need Windows "Administrator" privileges.)
-
At the end of this procedure you will be asked whether you would like all your Greenstone collections to be removed: you should probably say No if you wish to preserve your work.
Occasionally, problems are encountered if older Greenstone installations are not fully removed. To clean up your system, move your Greenstone collect folder, which contains all your collections, to the desktop. Then check for the folder C:\Program Files\gsdl or C:\Program Files\Greenstone, which is where Greenstone is usually installed, and remove it completely if it exists.
Reinstalling Greenstone on a Windows system
-
The reinstallation procedure is exactly the same as the original installation procedure, described in Installing Greenstone. If you already have ImageMagick, you do not need to install it again.
There have been some superficial changes to the installation procedure in moving to Greenstone Version 2.60, because it uses a different installer program.
There is another important difference that you should be aware of: Versions 2.60 and above are installed in the folder Program Files\Greenstone, whereas prior versions were placed in the folder Program Files\gsdl (these are both default locations that you could have changed during installation.) When upgrading to Version 2.60, if you want to save existing collections you must explicitly move the contents of your collect folder from the old place to the new one. Future Greenstone versions will be installed in the new place, Program Files\Greenstone, so this problem will not happen again.
Amalgamating different Greenstone collections
-
If you have previously installed the Greenstone Digital Library software in a non-standard place, you should amalgamate your collections by moving them from the collect folder in the old place into the folder Program Files\Greenstone\collect.
-
If you have installed collections from pre-packaged Greenstone CD-ROMs, they reside in a different place: C:\GSDL\collect. To amalgamate these with your main Greenstone installation, move them into the folder Program Files\Greenstone\collect. The mini version of Greenstone that is associated with the pre-packaged collections is no longer necessary. To uninstall it, select Uninstall on the Greenstone menu of the Windows Start menu.
Installing the Greenstone language pack (2.62 and earlier)
If you go to the Preferences page of any Greenstone collection, and look at the Interface language menu, you will probably find that only English, Spanish, French and Russian interfaces are installed.
-
Locate the Greenstone Language Pack (glp-x.xx.exe/glp-x.xx-linux.bin/gli-x.xx-macOSx.command). This may be on the CD-ROM from which you installed Greenstone, or you may have to download it from http://www.greenstone.org.
-
Run the executable file (double click it on Windows); this will start the installer. Accept all the defaults
-
Restart the Greenstone Digital Library and look at the interface language menu again. Now you should see about 40 different languages.
Enabling other languages (2.63 and later)
If you have downloaded Greenstone from the web, then all the languages will be enabled by default. However, if you have installed Greenstone from a UNESCO CD-ROM, then only English, French, Spanish and Russian will be enabled.
-
To enable a new language, edit the file greenstone →etc →main.cfg. Look for the appropriate "Language" line, and uncomment it (i.e. remove the # from the start). Check that the required encoding is also enabled.
For example, suppose that we want to enable Turkish. The "Language" line for Turkish looks like:
#Language shortname=tr longname=Turkish default_encoding=windows-1254
To enable it, we remove the #, i.e. make it look like:
Language shortname=tr longname=Turkish default_encoding=windows-1254
The default encoding for Turkish is windows-1254. So we look for the windows-1254 Encoding line:
Encoding shortname=windows-1254 "longname=Turkish (Windows-1254)" map=win1254.ump
This is already enabled (no # at the start) so we don't need to do anything else.
Installing the Classic Interface Pack (2.63 and later)
Greenstone now comes with all languages enabled.
The generated HTML uses text + CSS rather than images for navigation bar,
home, help, preferences buttons etc. The classic interface pack is not needed if you want to use Greenstone in another language. It is only needed if you want to revert back to the old style HTML with text images. This may be useful if you have customized your Greenstone, or if you require compatibility with Netscape 4.
-
Locate the Classic Interface Pack (gcip-x.xx.zip). This may be on the CD-ROM from which you installed Greenstone, or you may have to download it from http://www.greenstone.org.
-
The classic interface pack is a zip file containing the old text images, such as classifier buttons. Unzip the zip file into the images directory of your Greenstone installation.
-
Enable the use of the old-style macros by editing greenstone → etc → main.cfg: replace "nav_css.dm" with "nav_ns4.dm" in the "macrofiles" list.
-
Restart the Greenstone Digital Library. It should now be using the old text images.