Skip to content

Latest commit

 

History

History
89 lines (64 loc) · 3.62 KB

README.md

File metadata and controls

89 lines (64 loc) · 3.62 KB
Raw

fontsmith Build status

DEPRECATED

We are choosing to deprecate fontsmith and its family of libraries. They rely on a deprecated icomoon.io API, were never fully developed (e.g. missing SASS templates, multiple engines), and out of date (e.g. uses grunt@0.3).

While we would love to keep everything running, we have to choose to prioritize other projects over this one. We suggest using grunt-webfont as an alternative:

https://www.npmjs.com/package/grunt-webfont

If you are interested in forking, feel free to (and maybe open an issue to let me know so we can link to it).

If you have a minor request (e.g. cannot figure out how to use existing tool), feel free to open an issue describing your problem.

Collect SVGs into multiple fonts and a character code mapping

Getting Started

Install the module with: npm install fontsmith

var fontsmith = require('fontsmith');
fontsmith({src: ['paths', 'to', 'svgs']}, function (err, res) {
  res.map; // Map of file name to unicode value for character
  res.fonts; // Object containing binary string representations of fonts (e.g. {svg, ttf, woff, eot})
});

Dependencies

Currently, there is only the icomoon-phantomjs engine.

icomoon-phantomjs

This requires installing phantomjs and having it accessible from your path (i.e. phantomjs --version will work).

Documentation

fontsmith provides a single function as its export.

/**
 * Function which eats SVGs and outputs fonts and a mapping from file names to unicode values
 * @param {Object} params Object containing all parameters for fontsmith
 * @param {String[]} params.src Array of paths to SVGs to compile
 * @param {Function} cb Error-first function to callback with composition results
 */

Examples

Below is taken from the test folder

var files = [
      'test_files/eye.svg',
      'test_files/moon.svg',
      'test_files/building_block.svg'
    ],
    params = {src: this.files};
fontsmith(params, function (err, res) {
  err; // Any errors that might have popped up
  res.map; // Map of file name to unicode value for character
  res.fonts; // Object containing binary string representations of fonts (e.g. {svg, ttf, woff, eot})
});

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint using grunt and test via npm test.

Attribution

Test files

Building Block designed by Michael Rowe from The Noun Project

Eye designed by Dmitry Baranovskiy from The Noun Project

Moon designed by P.J. Onori from The Noun Project

Donating

Support this project and others by twolfson via gittip.

Support via Gittip

License

Copyright (c) 2013 Todd Wolfson

Licensed under the MIT license.