--- /dev/null
+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