Create a SVG font from multiple SVG glyph files.
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-svgicons2svgfont --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-svgicons2svgfont');
In your project's Gruntfile, add a section named svgicons2svgfont
to the data
object passed into grunt.initConfig()
.
grunt.initConfig({
svgicons2svgfont: {
options: {
// Task-specific options go here.
},
your_target: {
// Target-specific file lists and/or options go here.
},
},
})
Type: string
SVG glyphs. Wildcards are supported.
Type: string
Directory of the resulting font.
Type: String
Default value: 'iconfont'
A string value that is used to name your font-family.
Type: Boolean
Default value: false
Allow to append codepoints to icon files in order to always keep the same codepoints.
Type: Boolean
Default value: false
Creates a monospace font of the width of the largest input icon.
Type: Boolean
Default value: false
Calculate the bounds of a glyph and center it horizontally.
Warning: The bounds calculation is currently a naive implementation that may not work for some icons. We need to create a svg-pathdata-draw module on top of svg-pathdata to get the real bounds of the icon. It's in on the bottom of my to do, but feel free to work on it. Discuss it in the
Type: Boolean
Default value: false
Normalize icons by scaling them to the height of the highest icon.
Type: Number
Default value: MAX(icons.height)
The outputted font height (defaults to the height of the highest input icon).
Type: Number
Default value: 10e12
Setup SVG path rounding.
Type: Number
Default value: 0
The font descent. It is usefull to fix the font baseline yourself.
Type: Function
Default value: false
Allows you to provide your own logging function. Set to function(){}
to impeach logging.
Type: Function
Default value: false
Allows you to provide your own error function. Set to function(){}
to impeach error.
grunt.initConfig({
svgicons2svgfont: {
options: {
fontName: "my-font-name"
},
your_target: {
src: 'glyphs/*.svg',
dest: 'font/'
}
},
})
You may use this plugin in addition of the following plugins:
Please submit SVG related issue to the svgicons2svgfont project on wich grunt-svgicons2svgfont depends.
This repository issues is only for grunt and grunt tasks related issues.
You may want to contribute to this project, pull requests are welcome if you accept to publish under the MIT licence.