Iconmonstr Rails

This little gem puts all the Iconmonstr icons into a webfont. Similar to FontAwesome. If you're planning on using this library with FontAwesome it may or may not play nicely, I haven't tested it thoroughly enough yet.

Getting Started

Put the following in the assets group within your Gemfile:

group :assets
  gem 'iconmonstr-rails'
end

Run the bundle install command to install the latest version.

bundle install

Include the stylesheet within your own

//= require 'iconmonstr'

Remember there is a stylesheet for ie7 which you may want to include within your own ie7 styles.

//= require 'iconmonstr-ie7'

Documentation

Go to iconmonstr.com and use their fantastic directory service to find the icon you're looking for. Currently the latest version of this rails gem only has all icons up to now (2012-11-10).

Find the icon you want to use in your project and make note of the URL slug. eg.

http://iconmonstr.com/share-icon/

Now to use this within your code use something like:

<i class="icon-share"></i>

The general rule is to take the -icon and put it at the beginning of the URL slug. So

share-icon => icon-share antenna-2-icon => icon-atenna-2

etc.

Just to keep with convention :)

License

Now I have been slightly out of order and re-packaged Iconmonstr's icons within font-faces in this gem. Please respect their rights and find the Iconmonstr license within the LICENSE file. I was just too desperate to have this within my projects!