Installation

Installation of GWTPhotoAlbum

This guide describes the installation of GWTPhotoAlbum from GWTPhotoAlbum-fat-sources-VERSION.tgz or from the cloned git repository of gwtphotoalbum.

A. Requirements and Dependencies:

To compile the AJAX part of GWTPhotoAlbum you need to install the following first:

1. google web toolkit version 2.2 or higher: http://www.gwtproject.org/

   (This may require the installation of further software like a java virtual machine, an internet browser and the Apache ant build tool.)

In order to run the GWTPhotoAlbumCreator.py program to generate web galleries you additionally need the following software:

(GWTPhotoAlbumCreator.py can be run without compiling the AJAX part first as it already contains the compiled AJAX scripts.)

2. The Python programming language version 2.6 or higher: www.python.org

3. The python imaging library version 1.1.7 or higher: http://www.pythonware.com/products/pil/

4. The pyexiv2 library version 1.3 or higher (probably 1.3 works best): http://tilloy.net/dev/pyexiv2/

B. Installing and running GWTPhotoAlbum:

1. Download the latest fat source package:

   GWTPhotoAlbum-fat-sources-VERSION.tgz

   from the project website:

   https://github.com/jecki/gwtphotoalbum

   or check out the git repository from there!

2. Create a new google web toolkit project by entering the command on the shell:

   webAppCreator -out GWTPhotoAlbum de.eckhartarnold.client.GWTPhotoAlbum

3. Extract the GWTPhotoAlbum sources with the command:

   tar --overwrite -xzvf GWTPhotoAlbum-fat-sources-VERSION.tar.gz

4. Change to the GWTPhotoAlbum directory with:

   cd GWTPhotoAlbum

5. View the demo gallery with the command:

   ant devmode

C. Creating your own web albums

Change to the "scripts" sub-directory of the "GWTPhotoAlbum" main directory tree and enter the command from the shell:

python GWTPhotoAlbumCreator.py

D. Changing the GWTPhotoAlbum AJAX code:

1. Change the code as you like (Apache 2.0 license :-) ). I recommend using a powerful integrated development environment like eclipse.

2. Compile the code by simply running this command from the main directory:

   ant

3. In the "scripts" sub-directory re-run the "genDeploymentPackage.py" script to update the AJAX code that is deployed by "GWTPhotoAlbumCreator.py". Just type:

   python genDeploymentPackage.py