X-Git-Url: https://git.sommitrealweird.co.uk/bpgallery.git/blobdiff_plain/c757ab6dcdf959f0bb5fcf5fe23c7e94a4c6b819..db2e93451feb68956ecdf00cf3bb33ebca015173:/README diff --git a/README b/README index 81c0a4e..0678ce9 100644 --- a/README +++ b/README @@ -22,18 +22,40 @@ 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. + 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 - BPGALLERY_THEME - set the theme to use (described below) - BPGALLERY_THEME_DIR - set an extra location to look for themes - OUTPUTHTML - sets the script output to be wrapped in a <pre> block - GENERATEPAGESFORFULLSIZE - decide wether to generate pages for the full - size images or not + TITLE + the title of the gallery + + WIDTH + the width to make the icons + + MEDIUMWIDTH + set the width of images in the medium size pages + + BPGALLERY_THEME + set the theme to use (described below) + + BPGALLERY_THEME_DIR + set an extra location to look for themes + + OUTPUTHTML + sets the script output to be wrapped in a <pre> block + + GENERATEPAGESFORMEDIUMSIZE + generate medium sized images and pages + + GENERATEPAGESFORFULLSIZE + decide wether to generate pages for the full size images or not + + INDEXDOCUMENT + name of the index page (e.g. index.html) Example Usage: TITLE="My Funky Gallery" bpgallery.sh /path/to/image/files @@ -72,13 +94,13 @@ The functions that you need to declare are as follows: what's it for?: Whatever is in here is generated per thumbnail. available variables: - $link - the page/image to link to + $link - the page/image to link to $filename - the name of the file $caption - the caption as got from captions.txt - bpgallery_ThemeName_page() - what's it for?: + bpgallery_ThemeName_page() + what's it for?: It generates the pages for fullsize image pages - available variables: + available variables: $filename - the name of the image $previouspage - the URL for the previous page $currentpage - the url for the current page