Font Custom integration with Compass
MIT License
This is my attempt of integrating Font Custom with Compass.
Tested on Ruby 2.0, 2.1, 2.2, 2.3 and 2.4. You'll need to have fontforge and the WOFF font toolset installed as outlined in the Font Custom installation instructions.
Add this line to your application's Gemfile:
gem 'compass-fontcustom'
or:
gem 'compass-fontcustom', :github => 'glaszig/compass-fontcustom'
And then execute:
$ bundle
Compass::Fontcustom adds the following configuration options to Compass.
Just add these to your project's config/compass.rb
.
fontcustom_input_paths
fontcustom_discard_manifest
fontcustom_options
Syntactically it works like Compass' sprites feature. You can let Font Custom generate your fonts upon Compass' css compilation:
@import "myfont/*.svg";
@include all-myfont-glyphs;
This will setup a proper @font-face
and generate icon classes named .icon-<font_name>-<glyph_name>
for each glyph.
You can also use custom class names using the <font_name>-glyph()
mixin:
.custom-class-name {
@include myfont-glyph(glyph-file-name);
}
which will result into CSS along the lines of:
.myfont-font, .custom-class-name {
font-family: "myfont";
}
.custom-class-name:before {
content: "\f100";
}
Attention Generated CSS class names will be normalized and reserved characters removed. That means if you have a glyph file name of
a_R3ally-eXotic f1Le+Name.svg
the generated class name will be.icon-myfont-a_R3ally-eXotic-f1Le-Name
.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)