Gallery with Magazine Layout

Most of the pictures you’re likely to distribute on your webpage with DokuWiki are not the same size. The gallery plugin from DokuWiki does not consider this and just throws them out with a specific width or height.

To change this kind of static behavior I merged the wonderfull gallery with an even more powerfull tool from alistapart.com. The author Harvey Kane wrote a PHP script to generate a Magazine Layout which has the ability to resize a certain number of pictures (up to eight) in a way that they all fit into a defined box. No picture will every again fall out of this frame.

To integrate the feature I used the build from 2007-11-12, so that even the lightbox feature does work. To install the new gallery into your wiki you can use the tgz version.

The usage is rather easy and alike the original gallery plugin.

{{gallery>namespace?magazine&120x5}}

This means to use the Magazine Layout with an total width of 120px and a spacing between of 5px. You can combine some more options like lightbox, the lightboxe sizes and reverse. There is another thing now: By adding a space at the left or the right of the namespace, the imageblock will be aligned (floated) on the right or left.

I was free to add one more new Option, which is the noresize. It enables the user to set a definit size for all pictures shown (without using the magazine layout). While using the option noresize, 300×120 means that every image will be calculated to the size of 300px width and 120px height.

If there are more than eight images in the namespace, the plugin restarts itself showing the rest of the images.

The new version now supports pages. So you can give the option pageAmount=X where X is a positive Number to have the images separated into pages. This is helpfull in large galleries where the image take long to load.

Finaly, take a look at the result using the magazine layout.