@girder/grunt-fontello

grunt-fontello

donwload font icons from fontello.com

Getting Started

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-fontello --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-fontello');

The "fontello" task

Overview

In your project's Gruntfile, add a section named fontello to the data object passed into grunt.initConfig().

grunt.initConfig({
  fontello: {
    dist: {
      options: {
          config  : 'config.json',
          fonts   : 'output/fonts',
          styles  : 'output/css',
          scss    : true,
          force   : true
      }
    }
  },
})

Options

options.config

Type: String Default value: config.json

Path to your config.json file. Generate custom font icons here;

options.zip

Type: String Default value: .

Folder to extract the full archive.

options.fonts

Type: String Default value: fonts

Path to extract font files (*.eot, *.woff, *.svg, *.ttf)

options.styles

Type: String Default value: css

Path to extract css or scss files. See options.scss

options.scss

Type: Boolean Default value: false

Setting this option to true will extract .scss files instead of plain css.

options.force

Type: Boolean Default value: false

By default, if the folder specified in options.fonts, options.zip and options.styles do not exist, the task will throw an error. Setting this option to true will create the directory structure specified.

options.exclude

Type: Array Default value: []

An array of names of files which are excluded

Example

Multiple Targets

grunt.initConfig({
  fontello: {
    options: {
      scss: true,
      force: true
    },
    dist: {
      options: {
          fonts   : 'output/fonts',
          styles  : 'output/css',
      }
    },
    dev: {
      options: {
          config  : 'test/config.json',
          fonts   : 'test/output/fonts',
          styles  : 'test/output/css',
      }
    }
  },
})

grunt.loadNpmTasks('grunt-fontello');
grunt.registerTask('default', ['fontello:dist']);

Exclude files

grunt.initConfig({
  fontello: {
    dist: {
      options: {
          fonts   : 'output/fonts',
          styles  : 'output/css',
          exclude: ['animation.css', 'fontello-ie7-codes.css', 'fontello.eot'],
      }
    },
  },
})

Contributing

Shameless Confession: This is my very first node and grunt project! contributing to this project contributes to my knowledge so please do!

• [e-mail]

Release History

Update 2016/01/29

• fixed outdated needle dependency
• bumped npm version to 0.1.4