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.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.