AxKit::App::Gallery

$Id: README,v 1.3 2004/02/26 18:02:05 nik Exp $

This is an AxKit based image gallery, using XSLT and XPathScript. Directory hierarchies of images can be placed online with minimal effort. To see an example of AxKit::App::Gallery in use, go to

http://jc.ngo.org.uk/pics/

See the INSTALL document for notes on installing AxKit::App::Gallery and its dependencies.

After installing AxKit::App::Gallery;

• Identify the root directory of your image collection. For example, /usr/local/pictures.
• Create a directory to store the stylesheets (XSLT and XPathScript) that do the bulk of the transformation. E.g., /usr/local/share/ax-app-gallery. Copy the contents of the stylesheets/ directory here

        mkdir /usr/local/share/ax-app-gallery
        cp stylesheets/* /usr/local/share/ax-app-gallery

• Edit proofsheet2html.xsl and imagesheet2html.xsl. These both contain a statement that looks like this:

<xsl:include href="file:///home/nik/Local-CVS/CPAN/AxKit::App::Gallery/src/stylesheets/breadcrumb.xsl"/>

Adjust the path to reflect the full path to the file breadcrumb.xsl on your system. Unfortunately, this is a side effect of interactions between specific versions of XML::LibXML, XML::LibXSLT, and libxml.

Future versions will hopefully fix this bug.

• Integrate the contents of httpd/httpd.conf into your Apache configuration file. See the comments in that file for more details.
• Restart the webserver
• As part of the httpd.conf integration you should have created a URL on your website that maps back to the root directory of your image collection (/usr/local/pictures, or whatever you called it). Point a web browser at this URL.

  You should be rewarded with a page listing the subdirectories as links. Any images in this root directory should also be present as thumbnails.

Clicking on a subdirectory should show you the images and subdirectories it contains. Clicking on an image should show you a larger version of that image, some information about it, and links to view larger or smaller versions of the image.

See the documentation in AxKit::App::Gallery for detailed configuration information, author contact details, and troubleshooting/debugging recommendations.