Introduction to Graphite2

Graphite2 is a rendering engine for graphite fonts. These are TrueType fonts with additional tables containing smart rendering information and were originally developed to support complex non-Roman writing systems. They may contain rules for e.g. ligatures, glyph substitution, kerning, justification - this can make them useful even on text written in Roman writing systems such as English. Note that firefox provides an internal copy of the graphite engine and cannot use a system version, but it too should benefit from the availability of graphite fonts.

This package is known to build and work properly using an LFS-7.9 platform.

Package Information

Graphite2 Dependencies




FreeType-2.6.3, Python-2.7.11, and silgraphite to build the comparerender test and benchmarking tool, and if that is present, Harfbuzz-1.1.3 to add more functionality to it (this is a circular dependency, you would need to first build graphite2 without harfbuzz).

To build the documentation: AsciiDoc, Doxygen-1.8.11, texlive-20150521 (or install-tl-unx), and dblatex (for PDF docs)

To execute the test suite you will need FontTools (Python 2 module), otherwise, the "cmp" tests fail.

Optional (at runtime)

You will need at least one suitable graphite font for the package to be useful.

User Notes:

Installation of Graphite2

Some tests fail if FontTools (Python 2 module) is not installed. These tests can be removed with:

sed -i '/cmptest/d' tests/CMakeLists.txt

Install Graphite2 by running the following commands:

mkdir build &&
cd    build &&

cmake -G "Unix Makefiles"         \
      -Wno-dev .. &&


If you wish to build the documentation, issue:

make docs

To test the results, issue: make test.

Now, as the root user:

make install

If you built the documentation, install, as the root user:

install -v -d -m755 /usr/share/doc/graphite2-1.3.5/api &&
cp      -v -r -f    doc/doxygen/{html,latex/refman.pdf} \
                    /usr/share/doc/graphite2-1.3.5/api &&
cp      -v -r -f    doc/{GTF,manual}.html \

Command Explanations

-DCMAKE_VERBOSE_MAKEFILE=ON: This switch turns on build verbose mode.


Installed Programs: gr2fonttest, and optionally comparerender
Installed Libraries:
Installed Directories: /usr/{include,share}/graphite2 and optionally /usr/share/doc/graphite2-1.3.5

Short Descriptions


is a test and benchmarking tool.


is a diagnostic console tool for graphite fonts.

is a rendering engine for graphite fonts.

Last updated on 2016-03-03 14:05:00 -0800