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.