- 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][vim-macros].
-
- synopsis
- --------
-
- ```sh
- gallery-html --base_url=https://example.com/ --base_dir=. -x=256 -y=256
- ```
-
- installing
- ----------
-
- ```sh
- # 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:
-
- ```sh
- sudo pip3 install -e
- ```
-
- gallery-html usage
- ------------------
-
- <!-- exec -->
-
- $ 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
-
- <!-- end -->
-
- [vim-macros]: https://github.com/brennen/bpb-kit/blob/master/home/bin/vim-filter-exec-raw
|
