Creating a template is trivial. All you have to do is create your html code
and insert text variables inside the code. mpp.py will just change these
variables for the real information. Below is the list of variables
supported by mpp.py:

* Shared by both templates (img_page and index):

    * __ALBUM_TITLE__:       title, from .ini file
    * __ALBUM_TITLE2__:      title2, from .ini file
    * __ALBUM_PERIOD__:      period, from .ini file
    * __ALBUM_MODIF_DATE__:  current date
    * __MPP_PROJECT_LINK__:  html link to mpp.py
    * __ALBUM_NUM_IMGS__:    number of images on this album
    * __LANG_LINKS__:        links to the current page in other languages

* Exclusive to the index template:

    * __ALBUM_HTML_DESC__:   html description, (from description file)
    * __ALBUM_IMGS_TABLE__:  table (html) with the thumbnails and links

* Exclusive to the img_page template:

    * __IMG_NAME__:          image file name (relative path)
    * __IMG_DATE__:          date this image was shot (if available)         
    * __IMG_WIDTH__:         image width
    * __IMG_HEIGHT__:        image height
    * __IMG_CAPTION__:       image caption (or name if no caption is set)
    * __IMG_DESCRIPTION__:   image description (mix of caption and name by now)
    * __IMG_NEXT__:          next image name on this album
    * __IMG_PREV__:          previous image name on this album
    * __IMG_NUMBER__:        image number on this album
    * __IMG_EXIF__:          image exif information (txt)
    * __ALBUM_INDEX_PAGE__:  index file (relative path)

The templates should be put inside the directory specified by
'templates_dir' in the ini file (default: mpp-templates). Templates for
additional languages should be put inside a lang-dir sub-directory.

By default, templates should get their formatting from CSS. If that's not the
case and you want the index table to have some basic formatting, set
'format_from_css = no' in the .ini file. If a mpp.css file exists inside the
templates dir, it's copied to all albums generated by mpp.py.

Notice that "en" is the default/primary language. If you want to use it as a
secondary language, create an "en" directory, copy the main templates to there
and and fix the link references inside the html (add '../' to img and index
links).

Below is the default structure of the templates dir:

    mpp-templates/
    |-- README
    |-- img_page.html
    |-- index.html
    |-- mpp.css
    `-- pt_BR
        |-- img_page.html
        `-- index.html

# vim: et:tw=80: