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
- Fork it ( https://github.com/scarypine/middleman-dragonfly_thumbnailer/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
License
Copyright (c) 2018 Andrew White. MIT Licensed, see LICENSE.txt for details.