winlu 602b38c19d Update README.md		vor 6 Jahren
..
README.md	602b38c19d Update README.md	vor 6 Jahren
__init__.py	d726fd9b05 Add missing __init__	vor 11 Jahren
gallery.py	3b088dae4c Unhardcode gallery path.	vor 9 Jahren

Gallery

Allows an article to contain an album of pictures.
All albums can also be syndicated into a central gallery page.

How to Use

Group images into folders, with each folder representing an album.
Place all album folders within a folder, which should reside under content.
Insert GALLERY_PATH to your pelicanconf.py and set a path to that folder. By default it is images/gallery.
```
./content/images/gallery/{your albums}
```

Articles

Attach an album to an article/post by placing a gallery metadata tag with the name of the album.

gallery:album_name

The template has access to the album name.

article.album

And the filename of images within an album.

article.albumimages

Gallery Page

Create a page and a gallery template (named gallery.html). And inform pelican to use the gallery template for the page.

template:gallery

The template has access to a dictionary of lists.
The dictionary key is the name of the album and the lists contain the filenames.

page.gallery

Examples

article.html

<h2><a href="{{ SITEURL }}/pages/gallery.html#{{ article.album }}">{{ article.album }}</a></h2>
    <ul>
    {% for image in article.galleryimages %}
    <li><a class="{{ article.album }} cboxElement" href="{{ SITEURL }}/static/images/gallery/{{ article.album }}/{{ image }}"><img src="{{ SITEURL }}/static/images/gallery200x200/{{ article.album }}/{{ image }}"></a></li>
    {% endfor %}
    </ul>

gallery.html

{% for album, images in page.gallery.iteritems() %}
<h2><a name="{{ album }}">{{ album }}</a></h2>
<ul>
    {% for image in images %}
    <li><a class="{{ album }} cboxElement" href="{{ SITEURL }}/static/images/gallery/{{album}}/{{ image }}" title="{{ image }}"><img src="{{ SITEURL }}/static/images/gallery200x200/{{album}}/{{ image }}"></a></li>
    {% endfor %}
</ul>
{% endfor %}

posts/foo.md

title:Foo
gallery:albumname

pages/gallery.md

title:All Images
template:gallery

Reasoning

The album name and filenames are returned as opposed to the direct path to the images, to allow flexibility of different thumbnail sizes to be used it different locations of a website.

href="{{ SITEURL }}/static/images/gallery/{{album}}/{{ image }}"
href="{{ SITEURL }}/static/images/gallery200x200/{{album}}/{{ image }}"

It also allows a thumbnail to link to the full image, as well as the filename extension to be stripped and the title of an image to be displayed along side the title of an album.

Recommendation

It is recommended to use this extension along with the thumbnailer plugin.

RESIZE = [
        ('gallery', False, 200,200),
      ]

You may also wish to use this along with a gallery plugin such as Colorbox.

README.md