Skip to content
grunt task for downloading fonts from fontello.com
JavaScript
Find file
Latest commit 99fcc54 Mar 10, 2016 @jubalm 0.3.2
Failed to load latest commit information.
tasks Add .woff2-file Mar 9, 2016
test init Oct 12, 2013
.gitignore init Oct 12, 2013
.jshintrc init Oct 12, 2013
Gruntfile.js Fixes #1: @casio Dec 11, 2013
LICENSE-MIT init Oct 12, 2013
README.md Merge pull request #20 from dimaip/patch-1 Jan 29, 2016
package.json 0.3.2 Mar 10, 2016

README.md

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!

Release History

Update 2016/01/29

  • fixed outdated needle dependency
  • bumped npm version to 0.1.4
Something went wrong with that request. Please try again.