No commit activity in last 3 years
No release in over 3 years
Fontcustom for Compass
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
>= 0

Runtime

~> 1.0.1
~> 1.3.3
 Project Readme

Compass::Fontcustom

Build Status Gem Version Test Coverage

This is my attempt of integrating Font Custom with Compass.

Requirements

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.

Installation

Add this line to your application's Gemfile:

gem 'compass-fontcustom'

or:

gem 'compass-fontcustom', :github => 'glaszig/compass-fontcustom'

And then execute:

$ bundle

Configuration

Compass::Fontcustom adds the following configuration options to Compass.
Just add these to your project's config/compass.rb.

  • fontcustom_input_paths
    Array of paths where to search for SVG files to build custom fonts from.
  • fontcustom_discard_manifest
    Boolean to configure to delete the manifest file after each run.
  • fontcustom_options
    A hash to pass native options to FontCustom.

Usage

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.

Custom class names

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.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

MIT