Basic Theme Support for jigl
Date        :  04/17/2003
jigl version: >1.0
----------------------------

Basic themes are supported in jigl by the use of template files. There are
three template files that jigl uses:
   index_template
   slide_template
   info_template

The templates describe the basic layout of the page including the placement
of information generated by jigl and the foreground and background colors.

The default templates are built into the jigl program and will be generated
if none exist. If these files do exist in the directory jigl is processing
it will use those templates.

The placement of information by jigl is done by using a series of tags that
jigl reads and replaces with the appropriate information. These tags are
keywords and are in all capital letters. The following tags are available
in their respective templates.

index_template
--------------
INDEX-TITLEBAR
   This value is set in the gallery.dat file and is what you want the
   titlebar of the index page to say, i.e. what's between the <title></title>
   tags.
INDEX-TITLE
   This value is set in the gallery.dat file and is what you want the
   top of the index page to say.
TIME-STAMP
   The time stamp of when jigl was run.
INDEX-HEADER bgcolor=#rrggbb
   This value is set in the gallery.dat file and contains information that
   will be shown in it's own table above the thumbnails. The bgcolor tag
   extender is optional and is meant to change the background color of
   the table.
INDEX-FOOTER bgcolor=#rrggbb
   This value is set in the gallery.dat file and contains information that
   will be shown in it's own table below the thumbnails. The bgcolor tag
   extender is optional and is meant to change the background color of
   the table.
PICTURES bgcolor=#rrggbb
   This tag is where the pictures will be inserted. Each row of pictures
   will be it's own table and the background of the tables can be set with
   the optional bgcolor tag extender.

slide_template
--------------
ORIG-IMAGE-NAME
   This will insert the name of the original image.
NEXT-SLIDE-NAME
   This will insert the name of the image for the next slide.
PREV-SLIDE-HTML
   The previous slides html page.
INDEX-HTML
   The index.html file name.
INFO-HTML
   The name of this slides info page.
NEXT-SLIDE-HTML
   The next slides html page.
SLIDE-IMAGE
   This slides image.
SLIDE-DESCRIPTION
   The description of this slide.
SLIDE-COUNT
   Will insert (x of n) image count.

info_template
-------------
ORIG-IMAGE-NAME
   This will insert the name of the original image.
NEXT-SLIDE-NAME
   This will insert the name of the image for the next slide.
THIS-SLIDE-HTML
   The slide html page for this info page.
PREV-SLIDE-HTML
   The previous slides html page.
PREV-INFO-HTML
   The previous slides info html page.
INDEX-HTML
   The index.html file name.
NEXT-INFO-HTML
   The next slides info html page.
NEXT-SLIDE-HTML
   The next slides html page.
INFO-IMAGE
   The slide image that has been scaled down using the html height and width
   tags. The inserted code is: <img src="imgename" width=x height=y> unless
   the link-originals option is used. Then the above line is wrapped in an
   <a href> tag.
SLIDE-DESCRIPTION
   The description of this slide.
SLIDE-COUNT
   Will insert (x of n) image count.
EXIF-INFO
   A table with all of the exif info in it for this image.


Creating your own templates
---------------------------
The easiest way to create you own template files it to let jigl create the
default templates for you and modify them. This will give you a good idea
of how it all fits together.

If you come up with some interesting templates, send them to me and I'll put
them on the web site for others to use!
