Apache/Gallery version 0.6
===========================

$Id: INSTALL,v 1.4 2002/06/06 19:41:30 mil Exp $

INSTALLATION

Before you start installing Apache::Gallery you need to check
that you have the following installed:

- Perl 5.6
- Apache with mod_perl
- Apache::Request
- URI::Escape
- Image::Info
- Image::Size
- CGI::FastTemplate
- Inline::C
- X11 libraries (ie, XFree86)
- Imlib2 (http://prdownloads.sourceforge.net/enlightenment/imlib2-1.0.3.tar.gz)

When installing Imlib2 from rpm, deb or other packages formats, remember
that you need the imlib2-dev package too. On Debian this can be installed
with:

apt-get install libimlib2-dev

Then, to install Apache::Gallery run the following commands:

   perl Makefile.PL
   make
   make test (optional)
   make install

Setup a virtualhostblock in httpd.conf, like this:

<VirtualHost 123.123.123.123>
	ServerName   gallery.yourdomain.org
	DocumentRoot /data/pictures/
	ErrorLog     logs/gallery-error_log
	TransferLog  logs/gallery-access_log
	PerlSetVar   GalleryTemplateDir '/usr/local/apache/gallery/templates'
	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>

Warning: Apache::Gallery does not work properly if mod_autoindex 
is loaded by Apache. Indeed, mod_autoindex overrides Apache::Gallery 
and does not let it displaying 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 will only work when 
user access an image, whenever a directory listing will be requested, 
Apache will answer a classic (and ugly) directory listing performed by 
mod_autoindex.

Copy the files from templates/ to where you pointed GalleryTemplateDir to,
copy htdocs/folder.png and htdocs/video-*.png to your Apache icons 
directory and copy htdocs/gallery.css to the DocumentRoot of your gallery.

Make sure your httpd can write to the temporary directory (usually /tmp).
This will be used by the Inline module to compile the c-code used to
access functions in Imlib2.

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.

Feel free to contact me with questions if you have problems setting up
Apache::Gallery. You can write to michael@legart.dk

Make sure you try the latest version of the gallery from 
<http://apachegallery.dk/> before reporting bugs. 

If you have problems installing Apache::Gallery, please make sure to run "make
test" to see, what may be the problem.

When reporting bugs please use this page and include the output from make test
in your bugreport:
<http://bugs.cpan.org/NoAuth/ReportBug.html?Queue=Apache%3A%3AGallery>
