fontsize

fontsize

 

Postcss plugin that minify font file and inline as base64 in stylesheet.

[中文文档][]

Getting Started

fontsize goes through every @font-face and try to find the local font declared by src: url('font.ttf'), then minifies the font and replace the url with base64. The characters that are not appeared in text will be ignore and thus the filesize of font can be greatly cut down.

``bash
$ npm i -D fontsize
`

`js
import postcss from 'postcss'
import fontsize from 'fontsize'

const content = fs.readFileSync('test/fixtures/style.css', 'utf8')
const opts = {
resolveUrl: url => path.join(__dirname, 'fixtures', url),
text: 'hello world'
}

postcss().use(fontsize(opts)).process(content)
// OR
fontsize.process(content, opts)
`

`css
/ raw stylesheet /
.ttf {
font-family: "SentyBrush";
font-size: 20px;
}
@font-face {
font-family: "SentyBrush";
src: url('./font/SentyBrush.ttf');
font-style: normal;
font-weight: normal;
}

/ transformed /
.ttf {
font-family: "SentyBrush";
font-size: 20px;
}
@font-face {
font-family: "SentyBrush";
src: url("data:application/x-font-ttf;charset=utf-8;base64,AAEAAAAKAIAAAwAgT1MvMkHQFusAAACsAAA...");
font-style: normal;
font-weight: normal;
}
`

`html



hello world

hello world

miss

`

!example

Options

- text: Expected characters that use custom webfont.
- resolveUrl: Function to resolve font-face src declaration, give the url parameter and return the realpath of your local font file. Default to url => path.resolve(url).
- inline: To inline font in stylesheet as base64 or not. If set to false, fontsize will extract a minified font file and replace the url with relative path. Default to true.
- disabled: Disable the plugin. default to false.

Practices

$3

With [postcss-loader][], fontsize is avaliable in Webpack.

`js
// webpack.config.base.js
const path = require('path')
const autoprefixer = require('autoprefixer')
const fontsize = require('fontsize')

module.exports = {
module: {
loaders: [{
test: /\.styl$/,
loaders: /style!css!postcss!styl/
}]
},
postcss: {
plugins: [
autoprefixer,
fontsize({
resolveUrl: url => path.resolve('test/fixtures', url),
text: 'hello world'
})
]
}
}
`

$3

It's recommended to write your expected characters in a single file, so that you can easily get them and post to fontsize.

`js
const text = require('./content.js')
// OR
const text = fs.readFileSync('./content.txt', 'utf8')
`

Regexp is useful when dealing with Chinese characters. It reads content.html as a string and remove all non-Chinese characters.

`js
const text = fs.readFileSync('./content.html', 'utf8').replace(/[^\u4e00-\u9fa5]/g, '')
`

If your characters are seperated in multiple files, maybe you need [glob][] to deal with the terrible mess.

`js
const files = glob.sync('app/components//.js')
const text = files.reduce((ret, file) => ret + fs.readFileSync(file, 'utf8'), '')
`

Just take it easy to manage your characters.

$3

By default when found more that one font in the stylesheet, fontsize will minify each font with the same text that you give. If you want to handle each font with difference text, just give text as an object with the key the same as font's filename.

`css
.SentyBrush {
font-family: "SentyBrush";
font-size: 20px;
}
@font-face {
font-family: "SentyBrush";
src: url('./font/SentyBrush.ttf');
font-style: normal;
font-weight: normal;
}
.FZHTJT {
font-family: "FZHTJT";
font-size: 20px;
}
@font-face {
font-family: "FZHTJT";
src: url('./font/FZHTJT.ttf');
font-style: normal;
font-weight: normal;
}
`

`js
const content = fs.readFileSync('test/fixtures/main.css')
const text = {
FZHTJT: 'hello world',
SentyBrush: 'some others'
}

fontsize.process(content, { text })
`

$3

When we get a fat font after minified, it's a good idea to extract the base64 font from the stylesheet.

`js
const content = fs.readFileSync('test/fixtures/ttf.css')
const text = 'hello world'
const resolveUrl = url => path.resolve('test/fixtures', url),

fontsize.process(content, { text, resolveUrl, inline: false })
`

Test

`bash
$ npm i && npm test
``

[postcss-loader]: https://github.com/postcss/postcss-loader
[glob]: https://github.com/isaacs/node-glob
[中文文档]: README.ZH-CN.md