User Tools

Site Tools


en:developer:svn

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 Structure

The basic structure of the repository is

https://svn.greenstone.org/

  • 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.

en/developer/svn.txt · Last modified: 2023/03/19 21:10 by kjdon