jekyll-photo-gallery
Yet another jekyll photo gallery.
This Jekyll plugin generates galleries from directories containing images recursively. Thumbnails are created using rmagick.
Usage
-
Install the
jekyll-photo-gallery
gem by e.g. addinggem 'jekyll-photo-gallery'
to yourGemfile
and runningbundle install
. -
Add
jekyll-gallery-generator
to the gems list in your_config.yml
:
gems:
- jekyll-photo-gallery
3. Copy your images to your jekyll site. The directory structure should be as follows:
```
% tree
.
|- photos
|- 2016
|- 2016-12-24 Christmas
|- image1.jpg
|- image2.jpg
|- ...
|- 2016-12-31 New years eve
|- 2015
|- ...
An infinite depth of recursion is supported. Folders are allowed to contain both images and folders. The original files are made available in the `_site` directory using symbolic links.
Configuration
Configure the plugin in your _config.yml
:
photo_gallery:
path: photos
thumbnail_size: 256
The thumbnails are generated as squares with the resize_to_fill method and saved in _site
inside the mirrored folder structure of path
.
Templating
All important html elements of the generated photo gallery have dedicated CSS classes which can be used for styling or incorporating a javascript photo slideshow script.