debian/README.Debian

   1 libapache-gallery-perl for Debian
   2 ---------------------------------
   3
   4 Read more to learn how to integrate Apache::Gallery in the Apache Web Server.
   5 You have to complete all the steps described in this README file.
   6
   7 1. Configure your Apache server
   8
   9 1.1 Apache 1.3
  10
  11 You need to configure your virtualhost block to look like:
  12
  13 <VirtualHost *>
  14         ServerName   gallery.yourdomain.org
  15         DocumentRoot /data/pictures/
  16         ErrorLog     logs/gallery-error_log
  17         TransferLog  logs/gallery-access_log
  18         PerlSetVar   GalleryTemplateDir '/usr/share/libapache-gallery-perl/templates/default'
  19         PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
  20         PerlSetVar   GallerySizes '640 1024 1600 2272'
  21         PerlSetVar   GalleryThumbnailSize '100x75'
  22         PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
  23         <Location />
  24             SetHandler  perl-script
  25             PerlHandler Apache::Gallery
  26         </Location>
  27 </VirtualHost>
  28
  29 NOTICE: Although stated by the original author of Apache::Gallery, some users
  30 have reported it is not longer true that Apache::Gallery does not work with
  31 mod_autoindex. If you experience problems, with your gallery, please, follow
  32 this instructions:
  33
  34 WARNING: Apache::Gallery might not work properly if mod_autoindex is loaded by
  35 Apache. Indeed, mod_autoindex might override Apache::Gallery and might not let
  36 it display directory content.
  37
  38 To check if your apache loads mod_autoindex, just look for this line in
  39 httpd.conf:
  40
  41 LoadModule autoindex_module /usr/lib/apache/1.3/mod_autoindex.so
  42
  43 If this line is not commented, Apache::Gallery might only work when an image is
  44 loaded directly. Whenever a directory listing is requested, Apache might
  45 respond with the classic (and ugly) directory listing performed by
  46 mod_autoindex.
  47
  48 1.2 Apache 2
  49
  50 In case you run apache 2 and modperl 2 (or 1.99), it needs to look like:
  51
  52 <VirtualHost *>
  53         ServerName   gallery.yourdomain.org
  54         DocumentRoot /data/pictures/
  55         ErrorLog     logs/gallery-error_log
  56         TransferLog  logs/gallery-access_log
  57         PerlSetVar   GalleryTemplateDir '/usr/share/libapache-gallery-perl/templates/default'
  58         PerlSetVar   GalleryInfo 'Picture Taken => DateTimeOriginal, Flash => Flash'
  59         PerlSetVar   GallerySizes '640 1024 1600 2272'
  60         PerlSetVar   GalleryThumbnailSize '100x75'
  61         PerlSetVar   GalleryCopyrightImage 'htdocs/c.png'
  62         PerlOptions +GlobalRequest
  63         <Location />
  64             SetHandler          modperl
  65             PerlResponseHandler Apache::Gallery
  66         </Location>
  67 </VirtualHost>
  68
  69 NOTICE: Although stated by the original author of Apache::Gallery, some users
  70 have reported it is not longer true that Apache::Gallery does not work with
  71 mod_autoindex. If you experience problems, with your gallery, please, follow
  72 this instructions:
  73
  74 WARNING: Apache::Gallery might not work properly if mod_autoindex is loaded by
  75 Apache. Indeed, mod_autoindex might override Apache::Gallery and might not let
  76 it display directory content.
  77
  78 To check if your installation loads the autoindex module, you need to check
  79 under /etc/apache2/mods-enabled for a link to the module (actually placed under
  80 /etc/apache2/mods-available)
  81
  82 If this module is activated, Apache::Gallery might only work when an image is
  83 loaded directly. Whenever a directory listing is requested, Apache might
  84 respond with the classic (and ugly) directory listing performed by
  85 mod_autoindex.
  86
  87 2. Place the icons
  88
  89 For accessing the icons, you can create an alias to the directory where they
  90 reside. Icons for libapache-gallery-perl *must* appear under /icons/gallery
  91 on your topmost apache tree:
  92
  93     Alias /icons/gallery/ "/usr/share/libapache-gallery-perl/icons/"
  94
  95 This Alias defined above should appear _before_ the "Alias /icons ..." in your
  96 config files.
  97
  98 Another choice is to symlink:
  99
 100     /usr/share/apache2/icons/gallery -> /usr/share/libapache-gallery-perl/icons
 101
 102 From your Apache icons directory. The example above is for Apache2.
 103
 104 As a less recommended alternative, you can create a directory called gallery in
 105 your Apache icons directory and copy the png files in htdocs to this directory.
 106
 107 3. Edit the template directory
 108
 109 Edit the GalleryTemplateDir variable to point to the templates you want
 110 Apache::Gallery to use. This Debian package distributes 2 templates, called
 111 "default" and "new".
 112
 113 4. Place the CSS file
 114
 115 The gallery.css file from the template directory you choose must be
 116 copied to the DocumentRoot of your gallery.
 117
 118 That's IT!
 119
 120
 121 It is possible to include a graphical copyright notice on each picture now.
 122 By setting the GalleryCopyrightImage PerlSetVar you can define the path
 123 to a picture that you want include in the bottom right of each picture.
 124
 125  -- Jesus Climent <jesus.climent@hispalinux.es>  Mon, 09 Apr 2004 22:31:39 +0000