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
23 Jan 04, 2022
4.4k Jan 02, 2023
44 Nov 17, 2022
8.7k Jan 02, 2023
1 Jan 02, 2022
105 Dec 21, 2022
1.8k Jan 02, 2023
5 Jan 24, 2022
1.3k Jan 06, 2023
8 Sep 12, 2022
4 Nov 08, 2021
15 Dec 28, 2022
12 Nov 08, 2022
116 Jan 03, 2023
86 Dec 29, 2022
3 Dec 22, 2021
1 Jul 05, 2021
2 Apr 05, 2022
3 Sep 27, 2022
280 Dec 16, 2022