galleryhtml

Python to make thumbnails and generate HTML and/or JSON pointing to them.

Implemented as a badly-designed class with a command-line wrapper. Probably wrong in many particulars. I don't know Python.

As of September 2016, this is just kind of an experiment. I'll probably change the interface (and might also abandon the whole thing in favor of some existing tool). If I get it to a place where I think I won't break the interface and there are some unit tests in place, that will probably be a v1.0.0.

rationale

I just want to make some simple photo galleries for my website, using something I can easily plumb into Makefiles or Vim macros.

synopsis

gallery-html --base_url=https://example.com/ --base_dir=. -x=256 -y=256

installing

# I needed this on my Debian Jessie system:
# sudo apt-get install python3-pil
git clone https://github.com/brennen/galleryhtml
cd galleryhtml
sudo python3 setup.py install

Installing for development:

sudo pip3 install -e

gallery-html usage

$ gallery-html --help
gallery-html - generate thumbnails and print html for images

Usage:
  gallery-html [--source <pattern>...] [--output <dir>] [--base_url <url>] [-x <n>] [-y <n>] [--json <filename>] [--html <filename>] [--overwrite]
  gallery-html (-h | --help)
  gallery-html (-v | --version)

Options:
  --source <pattern>  Source directory or image file(s) to make gallery from
  --output <dir>      Parent directory on local filesystem for thumbnails
  --base_url <url>    Base URL for images
  -x <n>              Maximum width of thumbnails in pixels
  -y <n>              Maximum height of thumbnails in pixels
  --json <filename>   Render JSON output to filename
  --html <filename>   Render HTML output to filename
  --overwrite         Replace existing thumbnail files
  -h --help           Show this screen
  -v --version        Display version