Table of Contents
Greenstone Subversion (SVN) Repository
The Greenstone source code is kept under version-control in a subversion repository. For information about using SVN see this page, or the subversion book.
- Repository Root: https://svn.greenstone.org
- Repository Browser: https://trac.greenstone.org/browser
Repository Structure
The basic structure of the repository is
- deprecated Some code that is no longer used
- documentation Legacy manuals and tutorial source
- documented-examples Source for the greenstone 2 documented example collections
- gs2-extensions A collection of extensions to enhance the functionality of Greenstone 2, such as pdf-box, imagemagick, gnome-lib etc
- gs3-extensions A collection of extensions to enhance the functionality of Greenstone 3, such as solr, pharos image search, MAT (metadata analysis tool) etc
- local A handy set of setup script files for Greenstone 2 and 3 on different operating systems.
- main The main source code area
- other-projects Other related projects that are not part of Greenstone
- test-collections Some collections that we use for testing Greenstone
The main area is where the core source code lives. It is made up of branches, tags and trunk. The trunk is the main line of development of the source code. Tags are used to mark the repository at each release point. Branches are used to develop features on the sideline without disrupting the main trunk.
The important projects inside main are:
https://svn.greenstone.org/main/trunk/
- gli
- greenstone2
- greenstone3
- gs2build
gs2build is a package of greenstone 2 collection building code that is used by the greenstone 3 software.
Greenstone checkout
Greenstone3
To checkout the Greenstone 3 source code from our server do the following:
svn co https://svn.greenstone.org/main/trunk/greenstone3 greenstone3
Then from the greenstone3 folder, run
ant prepare
This will checkout gli, gs2build and download any additional files it needs.
ant install
compiles and installs the code.
Once you have the code you may update it at any time by changing to the greenstone3 directory and running:
ant svnupdate
will update all the code through svn, or
ant update
will update, clean then recompile and install.
Please see our compiling page for notes about compiling Greenstone.
Greenstone2
To checkout the Greenstone 2 source code from our server do the following:
svn co https://svn.greenstone.org/main/trunk/greenstone2 greenstone2
To checkout the Greenstone Librarian Interface source code, change to the greenstone2 directory and do the following:
svn co https://svn.greenstone.org/main/trunk/gli gli
Once you have the code you may update it at any time by changing to the greenstone2 directory and typing:
svn update
svn update gli
Please see our compiling page for notes about compiling Greenstone.
Notes
Line Endings
All of the line endings in the repository files are linux-style (\n) line endings. We ask that you do not check in files which do not conform to this standard. Therefore, we recommend finding a suitable editor for your platform, which uses this style of line ending.