chagallpy

CHArming GALLery in PYthon


Keywords
gallery, static-site-generator, wowp-framework
License
MIT
Install
pip install chagallpy==0.1.5

Documentation

chagallpy

(Cha)rming (gall)ery in (Py)thon is a static, minimalistic and mostly JS-free web gallery generator. In a way, it serves as an example project for the WOWP framework (see http://pythonic.eu/wowp).

The gallery does not depend on any external JS library and is navigable using standard (whatever reasonable definition of "standard") keyboard shortcuts.

Usage

Just run this command in the directory with photos:

Usage: chagall [OPTIONS]

Options:
  -i, --input TEXT  (default .)
  -o, --output TEXT  (default ./build)
  -S, --image-size INTEGER
  -T, --thumbnail-size INTEGER
  -v, --verbose

It finds all JPEG images in a current directory, then tries to read metadata about them and produces a gallery in output directory.

Example galleries produced with chagallpy: http://i.vzdusne.cz/

Installation

Easiest way is to use "pip" and download the package from PyPI.

pip install chagallpy

Or, you can visit the GitHub page of the project and work with the development version:

https://github.com/janpipek/chagallpy

Configuration

Gallery metadata

Metadata are store in gallery.yaml. Currently available configuration options:

  • title

Image metadata

Available EXIF data are read.

For each image.jpg, a file image.yaml is read with the following options:

  • title
  • place
  • date (dd/mm/YYYY)
  • author (additional (c) is displayed in the image toolbar)