Note - we will replace the thtml format at some point, so don't get too 
       attached to it...

albumtemplates:
 photopub supplied variables:
  everything defined as a parameter - default value is that given in the
   template, value can be overridden in the url 

  $styleroot - "style=/jcr/standard" => "/jcr"
  $page - what page you're on (of a multipage view)
  $album - what album this is
  $description - description of the group or album link
  $photocount - number of photos in the group

 tags for which things happen:
  <PARAMETER foo default=bar> - Exports $foo into the document, default 
   value of bar, which can be changed in the url
  <MAXGROUPS> - Maximum number of entries on a page
  <REPEAT ITEMS> .... </REPEAT> - go through this section for every entry
  <REPEAT ORDER=REVERSE> - reversed order to normal
  <REPEAT ORDER=REVERSEGROUP> - reverse the order of the group entries, 
   but keep the link entries un-reversed and at the top
  <IFGROUP> .... </IFGROUP> - go through this section for every group 
   found
  <IFLINK> .... </IFLINK> - go through this section for every link found
  <IFCOUNT MOD a = b> .... </IFCOUNT> - if the entry number, divided by a, 
   leaves a remainder of b, go through this section
  <A GROUP STYLE="foo"> .... </A> 
    - replace this with a link to the group, with a style of "foo".
      STYLE="foo" is optional if an appropriate default exists,
      and "foo" can be either a relative or an absolute reference.   
  <A LINK> .... </A>  - replace this with a link to the album, 
                        using the current style
  <A LINK NOSTYLE> .... </A> - replace this with a link to the album, 
                               using no style
  <IFPAGES> .... </IFPAGES> - go through this section if we have multiple 
   pages
  <NOPAGES> .... </NOPAGES> - go through this section if we only have a 
   single page
  <IFNEXT> .... </IFNEXT> - go through this section if we have a next page
  <IFPREV> .... </IFPREV> - go through this section if we have a previous 
   page
  <A NEXT> .... </A> - replace this with a link to the next page
    $nexturl - the URL that gets put into the <a href="..">
  <A PREV> .... </A> - replace this with a link to the previous page
    $prevurl - the URL that gets put into the <a href="..">
  <IFPLURAL> .... </IFPLURAL> - go through this section if there are 
   multiple photos in the group
  <IFSINGULAR> .... </IFSINGULAR> - go through this section if there is
   only one photo in the group
  <NOPHOTOS> .... </NOPHOTOS> - go through this section if there are 
   no photos in the group
  <IFPHOTOS> .... </IFPHOTOS> - go through this section if there are 
   some photos in the group. May contain:
    <IMG FIRSTPIC ....> - Display the first image from the group (.... can 
      be anything you'd normally have in a range.pl IMG tag)
    <IMG LASTPIC ....> - As above, but the last image from the group
    <IMG RANDOMPIC ....> - As above, but a random image from the group
    <IMG RANDPIC ....> - An alternative tag for above

rangetemplates:
 photopub supplied variables:
  everything defined as a parameter - default value is that given in the
   template, value can be overridden in the url 

  $styleroot - "style=/jcr/standard" => "/jcr"
  $page - what page you're on (of a multipage view)
  $range - what range this is
  $description - description of the photo is
  $title - if a titles parameter was supplied, then the title if the 
           range could be found in the album in this parameter

 tags for which things happen:
  <PARAMETER foo default=bar> - Exports $foo into the document, default 
   value of bar, which can be changed in the url
  <MAXGROUPS> - Maximum number of entries on a page
  <REPEAT PICTURE> .... </REPEAT> - go through this section for every 
   picture
  <IFDESCR> .... </IFDESCR> - go through this section if the photo has a
   description
  <IFTITLE> .... </IFTITLE> - go through this section if a valid title
   was found
  <IFNOTITLE> .... </IFNOTITLE> - go through this section if there wasn't
   a valid title found
  <IFCOUNT MOD a = b> .... </IFCOUNT> - if the entry number, divided by a, 
   leaves a remainder of b, go through this section
  <A PICTURE> .... </A> - replace this with a link to the picture
  <A PICTURE shrink=a> .... </A> - replace this with a link to the 
   picture, scaled to an a'th of the size
  <IMG PICTURE> - replace this with an IMG tag pointing to the picture
  <IMG PICTURE thumb=AAAxBBB> - replace this with an IMG tag pointing to 
   the picture, scaled to fit inside a box of size AAAxBBB
  <IMG PICTURE shrink=a> - replace this with an IMG tag pointing to the 
   picture, scaled to an a'th of the size


... and possibly a few more...