Galleria

Overview

Galleria is a plugin for pelican, a static site generator written in python.

Observe it first in action here: try to resize the window of our web browser and observe the flexible rearrangement of the following images.

Mycenaean Watercolor, from a fresco in Tiryns
Watercolor, also a fresco from Akrotiri
Watercolor, from a fresco from Akrotiri
Watercolor, the Caryatid porch at the Acropolis

The galleria plugin implements a reStructuredText directive for defining galleries in an intuitive way. Observe some real-life application of this plugin: just have a look at the Greuze-Cottave web site or the present author's Pirogh site.

The …

The galleria directive

A "galleria" consists of list of image file names, one per line, followed by a list of options, one per line, and then an optional caption paragraph. There must be blank lines before the caption and target paragraph. Here is an example, corresponding to the illustration of the introduction section:

.. galleria::
  tiryns.jpg
      :caption:  Mycenaean Watercolor, from a fresco in `Tiryns`_
      :target:   https://en.wikipedia.org/wiki/Tiryns
  boxers.jpg
      :caption:  Watercolor, also a fresco from `Akrotiri`_
      :target:   `Akrotiri`_
  swallows.jpg
      :caption:  Watercolor, from a fresco from `Akrotiri`_
  caryatid.jpg
      :caption:  Watercolor, the `Caryatid`_ porch …

The file pelicanconf.py

Here is a complete example of the pelicanconf.py file, as used for the present documentation of the theme. It starts by setting some standard pelican variables, as usual. Then, come the theme's and the optional plugins.

# =============================
# 1. standard pelican variables
# =============================
SITEURL      = 'http://galleria.artliba.org'
SITENAME     = 'Galleria'
AUTHOR       = 'Pirogh Hesse'
SITESUBTITLE = 'A responsive pelican gallery plugin'
TIMEZONE     = 'Europe/Paris'
DEFAULT_LANG = 'en'
LOCALE       = 'C'

PATH         = 'content'
STATIC_PATHS = ['images', 'theme']

OUTPUT_PATH  = 'output'

DISPLAY_CATEGORIES_ON_MENU = False # choose a custom top menu here
MENUITEMS = (
  ('About',      'about.html'),
  ('All',        'index.html'),
  ('Overview',   '1a-getting-started.html'),
  ('Directive',  '1b-directive.html'),
  ('Config',     '1c-pelicanconf.html'),
  ('#Tags',      'tags.html'),
)
DEFAULT_PAGINATION =   6 …