jekyll-smartcropper

jekyll-smartcropper

Smartcropper Image Generator for Jekyll

Smartcropper Image Generator for Jekyll

This gem allows you to easily use SmartCropper and RMagick to crop and resize images in your Jekyll project, according to a preset defined in your config file.

Basic Setup

Install the gem:

[sudo] gem install jekyll-smartcropper

In a plugin file within your Jekyll project's _plugins directory:

# _plugins/my-plugin.rb
require "jekyll-smartcropper"

Define presets in your _config.yml file, like this:

# _config.yml
smartcropper:
    thumbnail:
        source: img/original
        destination: img/thumb
        process: "crop_and_scale"
        width: 100
        height: 100
    medium:
        source: img/original
        destination: img/medium
        process: "crop"
        width: 600
        height: 400

This configuration will create a 100x100 thumbnail for each image in img/original and put it in _site/img/photos/thumbnail and a 600x400 image in _site/img/photos/medium.

Bundler Setup

Already using bundler to manage gems for your Jekyll project? Then just add

gem "jekyll-smartcropper"

to your gemfile and create the following plugin in your projects _plugins directory. I've called mine bundler.rb. This will automatically require all of the gems specified in your Gemfile.

# _plugins/bundler.rb
require "rubygems"
require "bundler/setup"
Bundler.require(:default)