Web interface for managing the web font icons in Rails apps
HTML Ruby JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app text changes Feb 4, 2014
bin first commit Dec 11, 2013
config add routes generator Jan 7, 2014
lib add glyphs to git by generator Jan 8, 2014
test icofonts on dummy Jan 7, 2014
.gitignore ignore gem Jan 3, 2014
Gemfile generators Jan 2, 2014
Gemfile.lock text changes Feb 4, 2014
MIT-LICENSE first commit Dec 11, 2013
README.md fontcustom url Jan 21, 2017
README.rdoc first commit Dec 11, 2013
Rakefile first commit Dec 11, 2013
icofont.gemspec gemspec Jan 8, 2014

README.md

Icofont

Provides a web interface to over 450 free icon fonts, so that you can inlcude only the fonts you need in your application.

Icofont front

Dependencies

Icofont depends on the awsome fontcustom for building the fonts. Please check their README for instructions on how to install it.

Installation

After installing fontcustom's dependencies, add the gem to the Gemfile of your Rails app:

gem 'icofont'

and run

bundle install

Usage

1. Start by running the icofont generator, which will copy the SVG glyphs from the [icofont-glyphs] repository into your machine, usually at ~/.icofont/glyphs:

rails generate icofont

The generator will also mount the icofont engine by injecting the following line into your routes.rb file:

mount_icofont

Now you can access the web interface of icofont at /icofont URL (e.g. http://localhost:3000/icofont). There you can select/unselect the glyphs you wish to be included on your font. Click on UPDATE to persist your changes, and create the font.

The class names can be found below the fonts.

The names of the fonts used are saved in the [rails_root]/.icofont/icofont.txt file, which was generated and added to your git repository automatically by the generator.

2. Include icofont.css.erb in your application.css file:

*= require icofont

Once the font is created, the selected class names are ready to use on your views.

This way you will include only the icons you need on your font.

Licence

Icofont is licenced under MIT-LICENSE.