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
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.