libapache-gallery-perl for Debian
---------------------------------

Read more to learn how to integrate Apache::Gallery in the Apache Web Server.
You have to complete all the steps described in this README file.

1. Configure your Apache server

1.1 Apache 1.3

You need to configure your virtualhost block to look like:

<VirtualHost *>
	ServerName   gallery.yourdomain.org
	DocumentRoot /data/pictures/
	ErrorLog     logs/gallery-error_log
	TransferLog  logs/gallery-access_log
	PerlSetVar   GalleryTemplateDir '/usr/share/libapache-gallery-perl/templates/default'
	PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
	PerlSetVar   GallerySizes '640 1024 1600 2272'
	PerlSetVar   GalleryThumbnailSize '100x75'
	PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
	<Location />
	    SetHandler  perl-script
	    PerlHandler Apache::Gallery
	</Location>
</VirtualHost>

NOTICE: Although stated by the original author of Apache::Gallery, some users
have reported it is not longer true that Apache::Gallery does not work with
mod_autoindex. If you experience problems, with your gallery, please, follow
this instructions:

WARNING: Apache::Gallery might not work properly if mod_autoindex is loaded by
Apache. Indeed, mod_autoindex might override Apache::Gallery and might not let
it display directory content. 

To check if your apache loads mod_autoindex, just look for this line in
httpd.conf:

LoadModule autoindex_module /usr/lib/apache/1.3/mod_autoindex.so

If this line is not commented, Apache::Gallery might only work when an image is
loaded directly. Whenever a directory listing is requested, Apache might
respond with the classic (and ugly) directory listing performed by
mod_autoindex.

1.2 Apache 2

In case you run apache 2 and modperl 2 (or 1.99), it needs to look like:

<VirtualHost *>
	ServerName   gallery.yourdomain.org
	DocumentRoot /data/pictures/
	ErrorLog     logs/gallery-error_log
	TransferLog  logs/gallery-access_log
	PerlSetVar   GalleryTemplateDir '/usr/share/libapache-gallery-perl/templates/default'
	PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
	PerlSetVar   GallerySizes '640 1024 1600 2272'
	PerlSetVar   GalleryThumbnailSize '100x75'
	PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
	PerlOptions +GlobalRequest
	<Location />
	    SetHandler          modperl
	    PerlResponseHandler Apache::Gallery
	</Location>
</VirtualHost>

NOTICE: Although stated by the original author of Apache::Gallery, some users
have reported it is not longer true that Apache::Gallery does not work with
mod_autoindex. If you experience problems, with your gallery, please, follow
this instructions:

WARNING: Apache::Gallery might not work properly if mod_autoindex is loaded by
Apache. Indeed, mod_autoindex might override Apache::Gallery and might not let
it display directory content. 

To check if your installation loads the autoindex module, you need to check
under /etc/apache2/mods-enabled for a link to the module (actually placed under
/etc/apache2/mods-available)

If this module is activated, Apache::Gallery might only work when an image is
loaded directly. Whenever a directory listing is requested, Apache might
respond with the classic (and ugly) directory listing performed by
mod_autoindex.

2. Place the icons

For accessing the icons, you can create an alias to the directory where they
reside. Icons for libapache-gallery-perl *must* appear under /icons/gallery
on your topmost apache tree:

    Alias /icons/gallery/ "/usr/share/libapache-gallery-perl/icons/"

This Alias defined above should appear _before_ the "Alias /icons ..." in your
config files.

Another choice is to symlink:

    /usr/share/apache2/icons/gallery -> /usr/share/libapache-gallery-perl/icons

From your Apache icons directory. The example above is for Apache2.

As a less recommended alternative, you can create a directory called gallery in
your Apache icons directory and copy the png files in htdocs to this directory.

3. Edit the template directory

Edit the GalleryTemplateDir variable to point to the templates you want
Apache::Gallery to use. This Debian package distributes 2 templates, called
"default" and "new".

4. Place the CSS file

The gallery.css file from the template directory you choose must be 
copied to the DocumentRoot of your gallery.

That's IT!


It is possible to include a graphical copyright notice on each picture now.
By setting the GalleryCopyrightImage PerlSetVar you can define the path
to a picture that you want include in the bottom right of each picture.

 -- Jesus Climent <jesus.climent@hispalinux.es>  Mon, 09 Apr 2004 22:31:39 +0000
