Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
[ikiwiki] / doc / todo / Gallery.mdwn
1 [[!template id=gitbranch branch=origin/gallery author="[[arpitjain]]"]]
2
3 New Version of gallery is available now. Few more features have been added like support for multiple pages, sorting and resizing of images etc.
4
5 Gallery repo is now available at  <http://github.com/joeyh/ikiwiki/tree/gallery>
6
7 --[[arpitjain]]
8
9 ---- 
10
11 creating a gallery of a bunch of images: 
12
13 * Display Exif informations
14 * Display Image informations (like size, date, resolution, compression...)
15 * Create CSS data for customizing
16 * Create Thumbnails (maybe in more than one size, eg: full,1024x768,800x600,640x480)
17 * Descriptions for every image
18 * Comments
19 * Ratings
20 * Watermarks
21 * Some javascript for easy navigation (see [photon](http://www.saillard.org/programs_and_patches/photon/) for a good example)
22
23 It should be possible to disable every feature for every directory. 
24
25 ----
26
27 This could be split into two distinct projects. One would be to modify the [[plugins/img]] plugin to support some of these ideas for extracting and using information such as exif out of images. The other project would be to design something that handles setting up a gallery, which could be just some regular wiki pages using the img plugin, and perhaps some other custom plugins for things like ratings and javascript), and adding new images to a gallery as they are added to the wiki.
28
29 That's one way to do it, and it has some nice benefits, like being able to edit the gallery pages like any wiki page, to add comments about images, links, etc. An example of ikiwiki being used like that: <http://kitenet.net/~family/pics/guaimaca.html> (still room for improvement, clearly).
30
31 --[[Joey]]
32
33 [[!tag soc]]
34
35 [[!tag wishlist]]
36
37 ----
38
39 I have implemented the first version of the Gallery Plugin for Ikiwiki as part of [[soc]]. This plugin would create a nice looking gallery of the images once the directory containing images is specified with some additional parameters. It has been build over the img plugin. 
40
41 Plugin can be downloaded from [here](http://myweb.unomaha.edu/~ajain/gallery.tar). 
42
43 It can be used as : <br>
44 \[[!gallery imagedir="images" thumbnailsize="200x200" cols="3" alt="Can not be displayed" title="My Pictures"]]
45
46 where-<br>
47 * imagedir  => Directory containing images. It will scan all the files with jpg|png|gif extension from the directory and will put it in the gallery.<br>
48 * thumbnailsize(optional) => Size of the thumbnail that you want to generate for the gallery.<br>
49 * alt(optional) => If image can not be displayed, it will display the text contained in alt argument.<br>
50 * cols(optional) => Number of columns of thumbnails that you want to generate.<br>
51 * title(optional) => Title of the gallery.<br>
52
53 Features of the Gallery Plugin:<br>
54 * You can go the next image by clicking on the right side of the image or by pressing 'n'.<br>
55 * Similary, you can go the previous image by clicking on the left side of the image or by pressing 'p'.<br>
56 * Press esc to close the gallery.<br>
57 * While on image, nearby images are preloaded in the background, so as to make the browsing fast.<br>
58
59 Right now, it features only one template namely [Lightbox](http://www.hudddletogether.com). Later on, I will add few more templates.<br>
60 For any feedback or query, feel free to mail me at arpitjain11 [AT] gmail.com 
61
62 Additional details are available [here](http://myweb.unomaha.edu/~ajain/ikiwikigallery.html).
63
64 [[!tag patch]]
65
66 > I'd love to merge this into ikiwiki.
67
68 > However, lightbox.js is licensed under a non-free (Creative Commons) license. :-(
69
70 > Since I don't much like the lightbox effects anyway (too much resizing
71 > motion, too slow), I wonder if another template could be added, perhaps
72 > a free one? 
73
74 > Now that ikiwiki is in git, I've downloaded the most recenty version of
75 > the gallery and put it in a "gallery" branch of my git repository.
76
77 > --[[Joey]]
78
79 ----
80
81 See also [[/users/smcv/gallery]] for another implementation of the same sort of
82 thing. Unfortunately, none of the implementation ideas
83 I have there seem quite right either... --[[smcv]]