JSGal - javascript web gallery v0.83 ------------------------------------ Copyright (C) 2004-2009 by Andreas S. Krebs (jsgal@sberk.net) --------------- GNU General Public License Disclamer --------------- This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . -------------------------------------------------------------------- Quick Installation: ------------------- 1. extract the zip file 2a. use the add2jsgal.pl script to create/modify gallery.xml (installation details see below) 2b. create the gallery.xml manually: -put the images for the gallery in the images folder -create the thumbnails for the gallery in the thumbs folder -modify the sample gallery.xml file to contain all the settings and images for the gallery 3. modify the sample galleries.xml to only contain the default gallery.xml file 4. open the index.html and enjoy Multi Gallery Installation: --------------------------- 1. create multiple gallery XML files 2. modify the galleries.xml to contain all your galleries NOTES: ------ -all references in the XML files have to be relative to the index.html file! -the DTDs in the XML files are not really needed, but are included anyway -when updating please check the index.html again, so that ALL tags with IDs are present - otherwise jsgal.js will fail add2jsgal.pl Installation: -------------------------- Install perl and the XML::DOM and Image::Magick module - they are both available on CPAN or look for packages for your linux distribution. HISTORY: -------- v0.83: -added support for relative links in XMLs -added version meta tag to html page v0.82: -fixed vertical padding not centering image in gallery -fixed additional blank line at the end of preview image in firefox/opera -fixed not working vertical scaling with other CSS than default -added new style "Elegant Black" v0.81: -added support for vertical padding to fill browser page -added support for preloading preview and slideshow images -switch to XHTML strict as doctype for index.html -made image preview work with IE v0.80: -added support for image preview -added support for konquerer (may also work with safari) -added scaling option on image level to scale vertical, horizontal -added support to add2jsgal.pl to set image scaling depending on image aspect -added tool tips to all buttons and links -added new default style sheet v0.72: -fixed bug with duplicate next/previous link -optimized gallery size calculation v0.71: -added tooltips to images -added support to navigate between galleries using previous / next -added support to cycle galleries in slideshow mode -added support to show galleries navigation horizontal -added support to collapse galleries navigation -added support to reverse slideshow direction -updated button styles -added support to add2jsgal.pl to create a new gallery v0.70: -fixed bug in jsgals.dtd -added support to directly goto an image number -fixed bug with updating images in opera v0.69: -added support to load XML files using XMLHttpRequest (support for more browsers) -added support to select default gallery and image v0.68: -added support to zoom images and thumbs -added support to add image number to image title v0.66: -fixed bug with slideshow not starting on current page v0.65: -fixed issue with slideshow loading on slow connection -added support for preloading images in slideshow v0.64: -added support for image slideshow -fixed bug with missing image title if restored on last page of gallery -more stable layout for images of different sizes / aspects -changed color for active thumb page -added support to save state of all galleries in cookie v0.60: -added support for dynamic calculating rows and colums of galleries -added perl script for adding images to a gallery v0.50: -switched to XML based data format instead of using javascript code -added support for multiple galleries and gallery switching v0.40: -added support for switching style sheets (styles similar to those of TFT Gallery) -changed rendering to update DOM rather than recreating each time -added support to store state in cookie v0.21: -fixed issue with IE and missing tbody tag in table -fixed issue with not correct working setAttribute in IE's DOM implementation v0.20: -added support for multiple lines in navigation bar -switch from innerHTML to DOM node creation to improve performance v0.1: -inital release and proof of concept TODO: ----- -add support for URLs relative to XML files -add support for multiple languages -documentation !!!!