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:
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'
SetHandler perl-script
PerlHandler Apache::Gallery
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:
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
SetHandler modperl
PerlResponseHandler Apache::Gallery
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 Mon, 09 Apr 2004 22:31:39 +0000