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#') # 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("http://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) # ===> http://s3.amazon.com/my-stuff/lard.mp3 ``` ... then Dragonfly is for you! See [the documentation](http://markevans.github.io/dragonfly) to get started! Documentation ============= THE MAIN DOCUMENTATION IS HERE!!! RDoc documentation is here Installation ============ gem install dragonfly or in your Gemfile ```ruby gem 'dragonfly', '~> 1.0.8' ``` Require with ```ruby require 'dragonfly' ``` Articles ======== See [the Articles wiki](http://github.com/markevans/dragonfly/wiki/Articles) for articles and tutorials. Please feel free to contribute!! Plugins / add-ons ================= See [the Add-ons wiki](http://github.com/markevans/dragonfly/wiki/Dragonfly-add-ons). Please feel free to contribute!! Issues ====== Please use the github issue tracker if you have any issues. Suggestions/Questions ===================== Google group dragonfly-users Ruby Versions ============= Dragonfly has been tested with ruby versions 1.8.7, 1.9.2, 1.9.3, 2.0.0, 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](http://github.com/markevans/dragonfly/wiki/Upgrading-from-0.9-to-1.0) for notes on changes, and feel free to add anything you come across while upgrading! Changes are listed in [History.md](https://github.com/markevans/dragonfly/blob/master/History.md) If for whatever reason you can't upgrade, then the docs for version 0.9.x are here. Credits ======= [Mark Evans](http://github.com/markevans) (author) with awesome contributions from these guys