Xibit (tibix) - the image gallery generator for werc
Xibit can:
- generate thumbnails from almost any picture format
- generate preview images with captions
- display them (rather brokenly for now)
Dependencies:
- Plan9port
- Imagemagick
- werc
To make it work:
1, clone the git repo at git://home.9souldier.org/xibit into $werc_root/apps
2, pick a directory to serve the gallery from
3, create an _werc and _werc/xibit directory in there, the xibit directory needs to be writable by the webserver to generate the thumbnails (at one point i'll probably make a cronjob, and then this will be optional)
4, create an _werc/config file (readable by the webserver), that contains the options for xibit
5, add xibit to the enabled_apps in initrc.local (or the local per-directory config file)
That should get you going.
to use captions just create a directory in GALLERY/_werc/xibit called captions, make it readable by the weberver and add the captions as files, using the following naming convention:
image.imageextension.md
the caption handler accepts markdown formatting
to enable comments add the comments handler (bridge) to the enabled apps, it'll (should) automatically work with xibit
Config options:
- fmts:
file extensions recognised
ex. fmts=(jpg gif png svg)
- thumbsize:
size of thumbnails to generate, accepts
ex. thumbsize='140x'
- previewsize:
size of the previews to generate
ex. previewsize='x460'
check_user:
Enforce authentication
This has been ripped out of the xibit code, if you want to enable perms enforcing, you should add the following to your config:
if ( ! check_user) { #if fyou want to enforce per-group permissions, do "if( ! check_user $group) {"
enabled_apps=() #maybe you want to leave some apps on, i just do this on a per-directory besis
handler_body_main=(echo '<a href="/_users/login">please log in</a>')
}
