gallerize
Create a static HTML/CSS image gallery from a bunch of images.
| Copyright: | 2007-2021 Jochen Kupperschmidt |
|---|---|
| License: | MIT, see LICENSE for details. |
Features
- Integrates ImageMagick to resize images and create thumbnails.
- Generates clean, slim, semantically appropriate HTML5 and uses CSS 3 for styling. As a result, the output can easily be themed.
- Provides HTML access keys for keyboard navigation.
- Optimizes images to reduce size and remove metadata.
Requirements
- Python 3.7+
- Jinja
- ImageMagick (tested with 6.6.9-7)
- jpegoptim (tested with 1.4.6)
Installation
It is recommended to create a virtual environment and run gallerize inside it.
To install ImageMagick, jpegoptim, and virtualenv on Debian/Ubuntu:
$ aptitude install imagemagick jpegoptim python-virtualenv
This should also give you a copy of pip.
Create a virtual environment called venv in the application path:
$ virtualenv venv
Activate it (note the space after the first dot!):
$ . venv/bin/activate
Install the dependencies of this application:
$ pip install -r requirements.txt
Install gallerize itself:
$ pip install -e .
Tests
Install test dependencies:
$ pip install -r requirements-test.txt
Run tests:
$ pytest
Usage
To create a gallery in the directory output from a all images in the directory images:
$ gallerize output/ images/*
See the usage help for more information on specifying a gallery title, image captions, image dimensions, and more:
$ gallerize --help
6 Mar 31, 2022
1 Feb 2, 2022
921 Dec 25, 2022
108 Dec 19, 2022
20 Dec 16, 2022
199 Dec 8, 2022
2 Aug 4, 2022
2 Dec 27, 2021
4 May 16, 2022
1 Feb 19, 2022
18 Nov 13, 2022
683 Jan 04, 2023
2 Aug 15, 2022
114 Dec 29, 2022
44 Nov 17, 2022
48 Dec 20, 2022
1.4k Dec 29, 2022
10 Nov 03, 2022
406 Dec 20, 2022
102 Feb 21, 2022
15 Nov 10, 2022
320 Dec 31, 2022
2 Dec 27, 2021
1 Dec 23, 2021
48 Jan 05, 2023
9.3k Dec 31, 2022
1 Jan 03, 2022
24 Dec 26, 2022