X-Git-Url: https://git.sommitrealweird.co.uk/bpgallery.git/blobdiff_plain/f8cd832b8ff300101bc8ae82a98fbfb7da8069f5..56fdabc7cf470c6d6cee9efc652dda63f7dc7fa8:/README

diff --git a/README b/README
index b9003a6..5657915 100644
--- a/README
+++ b/README
@@ -8,8 +8,9 @@ Requirements
 ------------
 The ImageMagick tools (convert and identify)
 bash
-find
-xargs
+GNU find
+GNU xargs
+sed
 
 Installation
 ------------
@@ -19,8 +20,60 @@ Usage
 -----
 bpgallery.sh /path/to/image/files
 
+Also, the following files, if placed in the images directory, will be used to
+generate part of the index page:
+        description.txt - a simple text file containing paragraphs to go at the
+                          beginnings of the index page
+        captions.txt - filename<tab>caption style file, it'll add a caption to
+                       the images on the index page.
+The following environment variables can also be used:
+        TITLE - the title of the gallery
+        WIDTH - the width to make the icons
+
+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:
-	e-mail: <iDunno@sommitrealweird.co.uk>
-	www:    http://www.sommitrealweird.co.uk/
+        e-mail: <iDunno@sommitrealweird.co.uk>
+        www:    http://www.sommitrealweird.co.uk/