]> git.sommitrealweird.co.uk Git - bpgallery.git/blob - README
Add in a setable path for themes
[bpgallery.git] / README
1 Introduction
2 ------------
3 bpgallery is a small static gallery generator, it generates an index file and
4 thumbnails of your images. The index file is generated in the image folder,
5 icons in a subfolder called icons.
6
7 Requirements
8 ------------
9 The ImageMagick tools (convert and identify)
10 bash
11 GNU find
12 GNU xargs
13 sed
14
15 Installation
16 ------------
17 Copy the file bpgallery.sh to a directory in your PATH.
18
19 Usage
20 -----
21 bpgallery.sh /path/to/image/files
22
23 Also, the following files, if placed in the images directory, will be used to
24 generate part of the index page:
25         description.txt - a simple text file containing paragraphs to go at the
26                           beginnings of the index page
27         captions.txt - filename<tab>caption style file, it'll add a caption to
28                        the images on the index page.
29 The following environment variables can also be used:
30         TITLE - the title of the gallery
31         WIDTH - the width to make the icons
32         BPGALLERY_THEME - set the theme to use (described below)
33         BPGALLERY_THEME_DIR - set an extra location to look for themes
34         OUTPUTHTML - sets the script output to be wrapped in a <pre> block
35
36 Example Usage:
37         TITLE="My Funky Gallery" bpgallery.sh /path/to/image/files
38
39 Themes
40 ------
41 Theme support is very rudimentary, basically you create functions for each of
42 the parts of the template, and put them in a file named the same as the theme.
43 The functions that you need to declare are as follows:
44         bpgallery_ThemeName_head()
45                 what's it for?:
46                         This sets up the header for the page, generally
47                         everything until the first picture. So, the title bar
48                         and any menus you would like to use
49                 available variables:
50                         $TITLE       - the title for the index page
51         bpgallery_ThemeName_tail()
52                 what's it for?:
53                         Closes the page, is the last thing to be printed.
54                 available variables:
55                         None
56         bpgallery_ThemeName_description()
57                 what's it for?:
58                         if there's a description set up (i.e. a description.txt
59                         file) then this is what it'll be wrapped in. It comes
60                         just after the _head.
61                 available variables:
62                         $DESCRIPTION - the content of description.txt
63         bpgallery_ThemeName_stylesheet()
64                 what's if for?:
65                         It generates the stylesheet for the page.
66                 available variables:
67                         $WIDTH       - the width of the images
68                         $MAXHEIGHT   - the maximum height of the image
69         bpgallery_ThemeName_thumbsline()
70                 what's it for?:
71                         Whatever is in here is generated per thumbnail.
72                 available variables:
73                         $filename    - the name of the file
74                         $caption     - the caption as got from captions.txt
75
76 If any of the functions are not defined in a theme then the default theme
77 function will be used instead. The default theme is clean and simplistic, this
78 is deliberate!
79
80 Author
81 ------
82 Brett Parker:
83         e-mail: <iDunno@sommitrealweird.co.uk>
84         www:    http://www.sommitrealweird.co.uk/