Skip to content

Jekyll plugin to generate thumbnails from a directory of images and display them with a Liquid tag

Notifications You must be signed in to change notification settings

mattvh/JekyllGalleryTag

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 

Repository files navigation

JekyllGalleryTag

Jekyll plugin to generate thumbnails from a directory of images and display them with a Liquid tag

Installation

  1. Install ImageMagick and the RMagick gem.
  2. Drop galleries.rb into your Jekyll site's _plugins folder.
  3. 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 have
  • thumb_height — The height, in pixels, you want your thumbnails to have
  • columns — How many columns galleries should display when the Liquid tag is used.

Usage

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.

About

Jekyll plugin to generate thumbnails from a directory of images and display them with a Liquid tag

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages