There are 6 special tags that can be used. Everything else is placed verbatim into the appropriate web page and so all HTML syntax is valid. Be careful, however, not to begin a line with one of the special tags (though they need to be immediately followed by a colon to be treated as a tag).

The special tags are:

photosrc:DIRECTORY-SPEC

The location of the original photos used on these pages (this is currently not used but a future version will take these photos and run the imgconv script to generate the images actually used in the pages).

title:NAME:DIRECTORY:TITLE

This is used to specify the entry page for the set. A file NAME.html will be generated in the current directory and all referenced pages will be created in DIRECTORY and TITLE will be used in the <title> tag in each generated page.

main:HEADING

This text will be used as the main heading in the front page for this set.

page:FILE:HEADING

All the following contents up to the next page tag will go into the file FILE.html in the directory specified by the title tag. The front page will also get a hyperlink to the file using this HEADING which will also form the main heading for this page.

tag:TAG

Normally, each generated page uses the HEADING text to generate links forward and backwards. If that text is overly long, then this tag allows you to specify a shorter form.

photo:PHOTO

The contents up to the next photo or page tag will be used as a caption for the specified image. It is expected that there exists both DIRECTORY/small/PHOTO (used inline in this page) and DIRECTORY/pics/PHOTO (displayed when the smaller image is selected). The imgconv application generates both of these from the original at appropriate sizes.