Skip to content

ntim/jekyll-photo-gallery

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Yet another jekyll photo gallery

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published