No commit activity in last 3 years
No release in over 3 years
Yet another jekyll photo gallery generator with thumbnails.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 3.0

Runtime

~> 1.2
~> 2.16
 Project Readme

jekyll-photo-gallery

Gem Version

Yet another jekyll photo gallery.

This Jekyll plugin generates galleries from directories containing images recursively. Thumbnails are created using rmagick.

Usage

  1. Install the jekyll-photo-gallery gem by e.g. adding gem 'jekyll-photo-gallery' to your Gemfile and running bundle install.

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