Repository is archived
No commit activity in last 3 years
No release in over 3 years
Middleman Dragonfly Thumbnailer is a Middleman extension that lets you easily create thumbnails using Dragonfly's thumb processor.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6
>= 0

Runtime

 Project Readme

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.