On Linux (and many other Unix systems), font configuring is handled by
Fontconfig
, and modern systems (particularly pango
and
cairo
) rely on this library in looking up any font specified.
You can provide the lepton-cli
command with a pattern containing the font
name wanted and, optionally, with some settings for that font.
Fontconfig performs matching of the pattern against all the fonts
available in your system. The closest matching font is selected. This
ensures that a font will always be returned, but doesn’t ensure that
it is anything like the requested pattern.
If you want to find out which fonts are available in your system, you
can use the fc-list
(1) utility from the fontconfig package.
To check whether fontconfig could find an appropriate font by the
specified pattern (or to see which font will correspond to your
pattern), use the fc-match
(1) utility.
See the fontconfig documentation for more information on how to specify the font name you want to use.
In some circumstances, the font system can even embed more than one font into your document. This occurs, for instance, if the most appropriate font chosen by fontconfig doesn’t contain some glyphs for one of the languages used in the document. In this case it will add some other font that does have the glyphs required.
The next table lists possible settings (acquired from the Pango documentation) which you can use in your font name patterns. There are some examples in the lepton-cli config section.
Setting | Value |
---|---|
Style | Normal
Oblique Italic |
Weight | Thin
Ultralight Light Book Normal Medium Semibold Bold Ultrabold Heavy Ultraheavy |
Variant | Normal
SmallCaps |
Stretch | UltraCondensed
ExtraCondensed Condensed SemiCondensed Normal SemiExpanded Expanded ExtraExpanded UltraExpanded |