INSTALL

   1 Apache/Gallery version 1.0
   2 ===========================
   3
   4 INSTALLATION
   5
   6 Before you start installing Apache::Gallery you need to check
   7 that you have the following installed:
   8
   9 - Perl 5 (http://www.cpan.org/src/README.html)
  10 - Apache (http://httpd.apache.org/) - 1.3.x or 2.x
  11 - mod_perl (http://perl.apache.org/) - 1.x or 2.x (2.0.0 or newer)
  12 - X11 libraries (ie, XFree86)
  13 - Imlib2 (http://prdownloads.sourceforge.net/enlightenment/imlib2-1.0.3.tar.gz)
  14
  15 Perl Modules: (Use http://search.cpan.org/ to find them)
  16
  17 - URI::Escape
  18 - Image::Info version 1.11. (NB NB NB: Version 1.12 is known to give problems)
  19 - Image::Size
  20 - Text::Template
  21 - CGI (3.08)
  22 - Image::Imlib2 (1.02)
  23
  24 When installing Imlib2 from rpm, deb or other packages formats, remember
  25 that you need the imlib2-dev package too. On Debian this can be installed
  26 by running:
  27
  28 apt-get install libimlib2-dev
  29
  30 Then, to install Apache::Gallery run the following commands:
  31
  32    perl Makefile.PL
  33    make
  34    export MOD_PERL_API_VERSION=2 # Only if you run mod_perl 2.0
  35    make test (optional)
  36    make install
  37
  38 If you use Apache 1.3 and mod_perl 1, you need to configure
  39 your virtualhostblock to look like:
  40
  41 <VirtualHost *>
  42         ServerName   gallery.yourdomain.org
  43         DocumentRoot /data/pictures/
  44         ErrorLog     logs/gallery-error_log
  45         TransferLog  logs/gallery-access_log
  46         PerlSetVar   GalleryTemplateDir '/usr/local/apache/gallery/templates/default/'
  47         PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
  48         PerlSetVar   GallerySizes '640 1024 1600 2272'
  49         PerlSetVar   GalleryThumbnailSize '100x75'
  50         PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
  51         <Location />
  52                 SetHandler        perl-script
  53                 PerlHandler       Apache::Gallery
  54         </Location>
  55 </VirtualHost>
  56
  57 In case you run apache 2 and modperl 2 (or 1.99), it needs to look
  58 like:
  59
  60 <VirtualHost *>
  61         ServerName   gallery.yourdomain.org
  62         DocumentRoot /data/pictures/
  63         ErrorLog     logs/gallery-error_log
  64         TransferLog  logs/gallery-access_log
  65         PerlSetVar   GalleryTemplateDir '/usr/local/apache/gallery/templates/default/'
  66         PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
  67         PerlSetVar   GallerySizes '640 1024 1600 2272'
  68         PerlSetVar   GalleryThumbnailSize '100x75'
  69         PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
  70         PerlOptions +GlobalRequest
  71         <Location />
  72                 SetHandler        modperl
  73                 PerlResponseHandler       Apache::Gallery
  74         </Location>
  75 </VirtualHost>
  76
  77 Warning: Apache::Gallery does not work properly if mod_autoindex
  78 is loaded by Apache. Indeed, mod_autoindex overrides Apache::Gallery
  79 and does not let it display directory content.
  80
  81 To check if your apache loads mod_autoindex, just look for this line
  82 in httpd.conf:
  83
  84 LoadModule autoindex_module /usr/lib/apache/1.3/mod_autoindex.so
  85
  86 If this line is not commented, Apache::Gallery will only work when an
  87 image is loaded directly. Whenever a directory listing is requested,
  88 Apache will respond with the classic (and ugly) directory listing performed
  89 by mod_autoindex.
  90
  91 Copy the files from templates/ to where you pointed GalleryTemplateDir to.
  92
  93 Create a directory called gallery in your Apache icons directory and
  94 copy the png files in htdocs to this directory.
  95
  96 The gallery.css file from the template directory you choose must be
  97 copied to the DocumentRoot of your gallery.
  98
  99 It is possible to include a graphical copyright notice on each picture now.
 100 By setting the GalleryCopyrightImage PerlSetVar you can define the path
 101 to a picture that you want include in the bottom right of each picture.
 102
 103 Feel free to contact me with questions if you have problems setting up
 104 Apache::Gallery. You can write to michael@legart.dk
 105
 106 Make sure you try the latest version of the gallery from
 107 <http://apachegallery.dk/> before reporting bugs.
 108
 109 If you are brave you can also download the latest snapshot
 110 from http://svn.apachegallery.dk/snapshots/
 111
 112 If you have problems installing Apache::Gallery, please make
 113 sure to run "make test" to see, what may be the problem.
 114
 115 When reporting bugs please use this page and include the output from make test
 116 in your bugreport:
 117 <http://bugs.cpan.org/NoAuth/ReportBug.html?Queue=Apache%3A%3AGallery>