"Fossies" - the Fresh Open Source Software Archive 
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
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>