0.05
No commit activity in last 3 years
No release in over 3 years
IcoMoon is an icon set rendered by css font-face way. This gem integrates IcoMoon with Rails asset pipeline for easy of use.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.0
~> 0.14

Runtime

>= 3.1.1
>= 3.1.1
 Project Readme

Icomoon::Rails

IcoMoon provides an application to create your own icon fonts, and also releases an icon pack for free.

The icomoon-rails gem integrates the free icon pack of IcoMoon with the Rails asset pipeline. It also provide a way to fork with your own icon fonts.

It is highly recommanded to create your own fork.

Usage

Install icomoon-rails gem

Add this line to your application's Gemfile:

gem 'icomoon-rails'

And then execute:

bundle

Include icomoon-free stylesheet assets

Add to your app/assets/stylesheets/application.css

*= require icomoon-free/style

IE7 suppot

If you need to support IE7, there is a icomoon-free/lte-ie7.js in javascripts assets.

Use this stylesheet with conditional comment may be the best way to support IE7. But it can be difficult when it comes to assets pipeline. See this article on StackOverflow for a workaround: Using Rails 3.1 assets pipeline to conditionally use certain css

Customization

YOU SHOULD ONLY USE ACTULLY NEEDED ICON FONTS.

You can go to IcoMoon App to create your own fonts pack.

  1. select the fonts you needed, and click 'Font->' button
  2. click 'More Settings' to set your font name and CSS class prefix
  3. click 'Save/Load' to save your font pack for futher use
  4. click 'Download' to download your font pack as zip file
  5. fork this gem from github
  6. follow gem maintenace section and replace NAME and ZIP value to create your own fonts assets
  7. use gem 'icomoon-rails', git: 'xxxxxx' in your Gemfile instead
  8. follow other part of usage section

Gem maintenance

Maintain icomoon-rails gem with Rake commands.

Download icon fonts from IcoMoon App.

Update icomoon-free source files.

rake update-icomoon NAME=icomoon-free ZIP=~/Download/icomoon.zip

Publish gem.

rake release

License

The assets from IcoMoon free icon pack use CC License (CC BY-SA 3.0).

Other parts of gem use MIT license.