Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Web interface for managing the web font icons in Rails apps
Ruby JavaScript CSS
branch: master
Failed to load latest commit information.
app text changes
bin first commit
config add routes generator
lib add glyphs to git by generator
test icofonts on dummy
.gitignore ignore gem
Gemfile generators
Gemfile.lock text changes
MIT-LICENSE first commit
README.md readme
README.rdoc first commit
Rakefile first commit
icofont.gemspec gemspec

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.

Something went wrong with that request. Please try again.