Skip to content
Thumbnail generation with Dragonfly
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/middleman
.gitignore
Gemfile
LICENSE.txt
README.md
Rakefile
middleman-dragonfly_thumbnailer.gemspec

README.md

Middleman Dragonfly Thumbnailer

Middleman Dragonfly Thumbnailer is a Middleman extension that lets you easily create thumbnails using Dragonfly's fantastic thumb processor.

Installation

Add this line to your application's Gemfile:

gem 'middleman-dragonfly_thumbnailer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install middleman-dragonfly_thumbnailer

Configuration

Just add the following to your config.rb file:

activate :dragonfly_thumbnailer

Usage

<%= thumb_tag 'image.png', '100x100#', class: 'thumbnail' %>
<%= thumb_tag 'image.gif', '100x100#', format: 'jpg', frame: 1, class: 'thumbnail' %>

The second argument is a geometry string which specifies the dimensions and options such as aspect ratio and cropping. You can also change the output format and choose the frame for GIFs. Have a look at https://markevans.github.io/dragonfly/imagemagick for examples of what you can do. Any other options will be passed to the image_tag helper.

When running Middleman in development, thumbnails will be generated on the fly and encoded in data URLs.

During a build, the thumbnails will be saved next to original image in a sub directory named using the geometry string, so the thumbnail for images/image.png will be saved as images/100x100/image.png.

Contributing

  1. Fork it ( https://github.com/scarypine/middleman-dragonfly_thumbnailer/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

License

Copyright (c) 2018 Andrew White. MIT Licensed, see LICENSE.txt for details.

You can’t perform that action at this time.