Compile fonts from sources (UFO, Glyphs) to binary (OpenType, TrueType).
Project description
fontmake
This library provides a wrapper for several other Python libraries which together compile fonts from various sources (.glyphs, .ufo) into binaries (.otf, .ttf).
Installation
Fontmake requires Python 2.7, 3.5 or later.
Releases are available on PyPI and can be installed with pip.
pip install fontmakeUse the -U, --upgrade option to update fontmake and its dependencies to the newest available release:
pip install -U fontmakeAlternatively, you can download the git repository and install from source:
git clone https://github.com/googlei18n/fontmake
cd fontmake
pip install .Developers who want to quickly test changes to the source code without re-installing, can use the “–editable” option when installing from a local source checkout:
pip install -e .However, even with an editable installation, it is recommended to always reinstall fontmake after pulling the latest changes from the upstream repo:
git pull
pip install -e .This makes sure that the requirements are still met, i.e. updating old ones to new minimum required versions, or installing new ones as needed.
It also ensures that the package metadata is updated, e.g. when displaying the installed version with pip list or pip show fontmake.
Virtual environments
It is recommended to install fontmake inside a “virtual environment” to prevent conflicts between its dependencies and other modules installed globally.
You can either install virtualenv (pip install --user virtualenv), or use the Python 3 venv module.
To create a new virtual environment, e.g. inside the ‘env’ directory:
python -m virtualenv envSimilarly, if you are using the venv module:
python3 -m venv envTo “activate” a virtual environment, i.e. temporarily place the folder containing the executable scripts on the shell’s $PATH so they can be run from anywhere, run this from the Bash shell (e.g., Linux, Mac):
source env/bin/activateIf you are using the Windows Command Prompt:
env/bin/activate.batTo deactivate the virtual environment and restore the original environment, just do:
deactivate
Dependencies and requirements files
Fontmake is mostly the front-end interface for a number of Python libraries.
These are automatically installed or updated to the minimum required version whenever you install a given fontmake version.
Pip also allows to specify a set of packages that work together in text files. These can be used with the -r option to recreate a particular environment.
There are two such requirements files in fontmake repository:
dev_requirements.txt: contains the URLs of the git repositories for all fontmake’s dependencies.
requirements.txt: contains the current released versions of the direct dependencies which fontmake is tested against.
To install from the latest development versions, or upgrade an existing environment to the current HEAD commit of the respective master branches, you can do:
pip install -r dev_requirements.txtFor more information on requirements files, see pip documentation.
Usage
After installation, you can use the fontmake console script. For example:
fontmake -g MyFont.glyphs # outputs binary font files for masters onlyUse fontmake -h to see options for specifying different types of input and output.
You can also use fontmake as a module to run intermediate steps in the build process, via methods of the fontmake.font_project.FontProject class.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fontmake-1.5.1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 74f36c42d4b865154e1b8cd3edbb8cb9582d2cdf486eafeebfdb3ca145e5b0c4 |
|
| MD5 | 3127522981acd375fd2525c9223ab0e9 |
|
| BLAKE2b-256 | 80190fcde83ee1f07e59fe10ed4833ef04b346cf3779928a1d8e5bae49cc6729 |
