Google-webfonts-json-encoder NPM

google-webfonts-json-encoder

Download and encode google fonts as base64 json (ttf and woff). This tool is intended to be used in the build process of BaseKit app, but can be easily adapted to use in any other project.

Quick guide

Installation: npm install -g google-webfonts-json-encoder

Note: You can install it locally to your project as well. Remember to add the path to run it.

You need a Google API key to use the tool, and set an environment variable named GOOGLE_API_KEY with its value.

Usage: GOOGLE_API_KEY=your_key_here gwjencoder -l config/google_fonts.yml -d assets/public/fonts -s=latin,latin-ext

The minimun version of node needed to run it is 0.12.

Where -l is the path of a yml file listing the desired fonts (legacy format used in the app), -d is the folder to store the fonts, and -s the desired subsets of fonts.

How to use

This is intended to be part of an automated build process depending on the required fonts for a given target environment.

The complete list of command line options are:

l: path to the yml file, defaults to config/google_fonts.yml.
d: target folder, defaults to current one.

You can set your own defaults in config.js.

YAML font list

This is an example of our format, if you use another one, just adapt it to your own, specifying its name in config.js (fontListFormat option) and creating a loader and a parser with that name, ended in Loader and Parser respectively.

fonts:

latin:

    subset: 'latin'

    fonts:

        - family: 'Droid+Sans'

          size: '400,700'

        - family: 'Arvo'

          size: ''

'latin-ext': 

    subset: 'latin,latin-ext'

    fonts:

        - family: 'Droid+Sans'

          size: '400,700'

Disclaimer

The architecture is crap. It lacks test for the most important stuff (downloading and converting the fonts). It could be more deocupled and it should have used own EventEmitters and pipe all of them. Also it doesn't deal with any kind of errors.

Use it at your own risk.