Update the documentation

[bpgallery.git] / README

diff --git a/README b/README
index 9a4aec8e8941bb7405bda7296582822f6bb7798e..56579151dcff44aabfd04ddd7e366cf236ff1352 100644 (file)
--- a/README
+++ b/README
@@ -33,6 +33,45 @@ The following environment variables can also be used:
 Example Usage:
         TITLE="My Funky Gallery" bpgallery.sh /path/to/image/files
 
+Themes
+------
+Theme support is very rudimentary, basically you create functions for each of the parts of the template, and put them in a file named the same as the theme. The functions that you need to declare are as follows:
+       bpgallery_ThemeName_head()
+               what's it for?:
+                       This sets up the header for the page, generally
+                       everything until the first picture. So, the title bar
+                       and any menus you would like to use
+               available variables:
+                       $TITLE       - the title for the index page
+       bpgallery_ThemeName_tail()
+               what's it for?:
+                       Closes the page, is the last thing to be printed.
+               available variables:
+                       None
+       bpgallery_ThemeName_description()
+               what's it for?:
+                       if there's a description set up (i.e. a description.txt
+                       file) then this is what it'll be wrapped in. It comes
+                       just after the _head.
+               available variables:
+                       $DESCRIPTION - the content of description.txt
+       bpgallery_ThemeName_stylesheet()
+               what's if for?:
+                       It generates the stylesheet for the page.
+               available variables:
+                       $WIDTH       - the width of the images
+                       $MAXHEIGHT   - the maximum height of the image
+       bpgallery_ThemeName_thumbsline()
+               what's it for?:
+                       Whatever is in here is generated per thumbnail.
+               available variables:
+                       $filename    - the name of the file
+                       $caption     - the caption as got from captions.txt
+
+If any of the functions are not defined in a theme then the default theme
+function will be used instead. The default theme is clean and simplistic, this
+is deliberate!
+
 Author
 ------
 Brett Parker: