Dragonfly¶ ↑
Hello!! Dragonfly is a highly customizable ruby gem for handling images and other attachments and is already in use on thousands of websites.
If you want to generate image thumbnails in Rails
… ruby class User < ActiveRecord::Base # model
dragonfly_accessor :photo end
erb <%= image_tag
@user.photo.thumb('300x200#').url # view %>
… or generate text images on-demand in Sinatra … ruby get
"/:text" do |text| Dragonfly.app.generate(:text, text,
"font-size" => 32).to_response(env) end
… or just generally manage attachments in your web app … “`ruby wav = Dragonfly.app.fetch_url(“free.music/lard.wav”) # GET from t'interwebs mp3 = wav.to_mp3 # to_mp3 is a custom processor uid = mp3.store # store in the configured datastore, e.g. S3
url = Dragonfly.app.remote_url_for(uid) # ===> s3.amazon.com/my-stuff/lard.mp3 “`
… then Dragonfly is for you! See the documentation to get started!
Documentation¶ ↑
THE MAIN DOCUMENTATION IS HERE!!!RDoc documentation is hereInstallation¶ ↑
gem install dragonfly
or in your Gemfile ruby gem 'dragonfly', '~>
1.0.12'
Require with ruby require 'dragonfly'
Articles¶ ↑
See the Articles wiki for articles and tutorials.
Please feel free to contribute!!
Examples¶ ↑
See the Wiki and see the pages list for examples.
Please feel free to contribute!!
Plugins / add-ons¶ ↑
See the Add-ons wiki.
Please feel free to contribute!!
Issues¶ ↑
Please use the <a href=“github”>github.com/markevans/dragonfly/issues“>github issue tracker</a> if you have any issues.
Suggestions/Questions¶ ↑
Google group dragonfly-usersRuby Versions¶ ↑
Dragonfly has been tested with ruby versions 1.8.7, 1.9.2, 1.9.3, 2.0.0, 2.1.x, 2.2.x, jruby 1.7.8 and rubinius 2.2.
Upgrading from v0.9 to v1.0¶ ↑
Dragonfly has changed somewhat since version 0.9. See the Upgrading wiki for notes on changes, and feel free to add anything you come across while upgrading!
Changes are listed in History.md
If for whatever reason you can't upgrade, then <a href=“the”>markevans.github.io/dragonfly/v0.9.15“>the docs for version 0.9.x are here</a>.
Credits¶ ↑
Mark Evans (author) with awesome contributions from <a href=“these”>github.com/markevans/dragonfly/graphs/contributors“>these guys</a>