quick-album
-----------

What does it do
---------------
This is the README for a program that will generate a list of static html pages from a configuration file.
It is used for the case of where you want to stick a bunch of photo's on the web and you don't have SQL or
other type of access and you just want simple. This program will stick the photo's in pages in a 2 x 5 grid
and make a Next and Previous to each page. Then it will create an index page.

This is basically as far as I will take this program. I'm happy that it is without bugs and it does everything
I'm going to use it for.

License
-------
This software is under GPL license, please read the LICENSE file.

There is no guarantee on this software. If it breaks, you get to keep the pieces.

Authors
-------
Please read AUTHORS file.

Depends
-------
Please read the DEPENDS file for packages needed to compile/run quick-album.

How does it work?
-----------------
The application, once compiled takes 2 parameters. The first on the name of a configuration file, the second one
 a target directory. It will create all files in the target directory.

The configuration file can have a mix of different types of entries. At this stage only two types of entries
are supported. The first is a picture entry, and the second is a configuration entry.

A picture entry has the following format:

filename, "description of file"

There may be no leading spaces. The filename can be absolute or relative. The resulting html pages will assume 
that the pictures are in the same directory as the html files. Any number of picture entries may be in the file.
The entries will appear in the html files in the order listed in the configuration file. If a picture file can not
 be found, it will be skipped and it will not appear in the final html file.

The following are the valid configuration entries. They are all optional.

#TITLE "The index.html page title. If not specified will default to Photographs"
#PRECOMMENT "A comment that must be placed on the index.html page before the links"
#POSTCOMMENT "A comment that must be placed on the index.html page before the links"
#HOME "The url to the higher level page. If not specified this will not be included in the index.html file"

Example
-------

test.pnm, "This is a test file"
test2.pnm", "Another test file"
#TITLE "The title of the index.html file"
#PRECOMMNENT "The pre-comment"
#POSTCOMMENT "The post-comment"
#HOME "../index.html"
