Repository files navigation

Fontship is a toolkit for generating fonts and tooling for a collaborative workflow.

Developed atThe League of Moveable Type with the needs of open-source font projects in mind, Fontship automates the process of turning your design sources into production ready font files and bundling them for publishing.Yes you could take all the same steps manually.Yes you could write your own scripts to get the same work done.What Fontship brings to the table is a complete bundle of all the tooling you need to gather with most bits wired up already.

One building fonts from sources is completely automated, automatic builds from CI and publishing releases is just a small step away.As an added bonus, everything is carefully organized to make asynchronous remote collaboration via version control systems (such as Git) as easy as possible.Designers don’t even need to be using the same design tools!

Almost every aspect of the build steps and workflow can be tweaked on a per-project basis, but out of the box settings should work to build most font projects.

Fontship can be used in any of three different ways:

1. Remotely via a CI runner that responds to events in a remote Git repository.
2. Locally via an all-inclusive Docker image for low hassle setup.
3. Locally via a regular system utility install (provided all the required dependencies are also installed).

Note: a fourth method supported through v0.5.0, direct inclusion of Fontship’s rule files into your project’s existing Makefile, has been deprecated.Depending on your project, such usage may or may not continue to function with limitations for the time being, but new features added to the CLI will beassumed in the rules going forward.

Build your fonts without installing or running anything locally!Just push your sources to a remote Git repository and let Fontship do the rest.

For use with Github Actions, add a configuration file to your repository such as.github/workflows/fontship.yml:

name:Fontshipon:[push, pull_request]jobs:fontship:runs-on:ubuntu-latestname:Fontshipsteps:      -name:Checkoutuses:actions/checkout@v2with:fetch-depth:0      -name:Fetch tagsrun:git fetch --prune --tags      -name:Fontshipuses:theleagueof/fontship@latest

At the current time Fontship only builds the fonts into the current project directory, it doesn’t publish them anywhere.You’ll need to post the resulting artifacts by (e.g. by attaching them to each CI run or publishing them on releases) as another step your project’s workflow. For a full working examples seeLeague Spartan’s orLibertinus’s workflows.

Other CI runners could easily be supported, seeissue #32 for details or to request sample configs for your favorite.

Prebuilt Docker images are available fromDocker Hub,Github Packages, or you can build them yourself.

The easiest way to instantiate a Docker container with all the right arguments is to set an alias (which can be added to your shell’s RC file to persist it):

Using Docker Hub as an example, an alias could be:

$alias fontship='docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" theleagueof/fontship:latest'

Docker will automatically pull the containers it needs to run this the first time you use it, after which it will just use its local container cache.To jump start the download without runningfontship or to manually update your cache later (e.g. whenlatest gets updated to a new release) usedocker pull theleagueof/fontship:latest.

You may substitutelatest (which will always be the most recently released version tag) withmaster to use the freshest unreleased build, with a tag name such asv0.3.2 to explicitly use a specific version, or withHEAD to use an image built locally.

To build a docker image locally, you’ll want to clone this repository and run./bootstrap.sh or download and extract the sources from a release, then run:

$./configure$make docker

If you use Arch Linux, you can installthis AUR package (prebuilt inthis repository).

Otherwise to install and use locally from source, you’ll need some dependencies:

• Git,
• GNU core utilities plusdiffutils,bsdtar,entr,zsh,
• GNUmake (4.2+) with corresponding autoconf tools,
• Python 3 plus assorted modules, seerequirements.txt file,
• Rust tools includingcargo andrustc to build the CLI,
• And a handful of other font related CLI utilities, namely:sfnt2woff-zopfli,psautohint,ttfautohint, andwoff2_compress.

To install the software to your computer, either clone this repository and run./bootstrap.sh ordownload and extract the latest release, then run:

$ ./configure$ make$ sudo make install

To build all the possible formats for your font project, run

$fontship make all

To only generate a specific format, try:

#Just static OTF fonts$fontship make otf#All static formats$fontship make static#All variable formats$fontship make variable#Just variable TTF format$fontship make variable-ttf

If you’re only interested in one specific file (say, a static weight instance) you can specify the exact file name you expect to get the fastest possible rebuild of just that file:

$fontship make FooBar-Black.otf

When everything is ready or you want to actually ship a font (or send a sample to a friend), you’ll want to build the distribution package:

$fontship make dist

The font version setting in all generated fonts is determined by the tag on the git repository.Version tags should conform to theMAJOR.MINOR format described byopenfv.