Jekyll plugin to generate thumbnails from a directory of images and display them with a Liquid tag
- Install ImageMagick and the RMagick gem.
- Drop
galleries.rb
into your Jekyll site's_plugins
folder. - Add the following to your
_config.yml
and customize to taste.
gallerytag:
dir: images/galleries
url: /images/galleries
thumb_width: 150
thumb_height: 150
columns: 4
dir
— The path (relative to your top Jekyll directory) to the folder containing your gallery images.url
— The URL to your gallery folder.thumb_width
— The width, in pixels, you want your thumbnails to havethumb_height
— The height, in pixels, you want your thumbnails to havecolumns
— How many columns galleries should display when the Liquid tag is used.
Jekyll will automatically generate (during builds) thumbnails for any images in the folder specified in _config.yml
. To display them in a post, you would use a Liquid tag set up like this:
{% gallery galleryname %}
subfolder/myfirstimage.jpg:: A caption!
subfolder/myseconfimage.png:: Another caption
subfolder/mythirdimage.jpg
subfolder/myfourthimage.png
subfolder/myfifthimage.jpg
{% endgallery %}
Jekyll will output some HTML that is (intentionally) similar to what WordPress does for galleries in posts, making it relatively simple to tweak your CSS. It will also add rel
attributes to the links, which contain the "galleryname" text as shown in the above example. This makes is easy to integrate a lightbox script like FancyBox.
You can see it in action on my personal blog, here.