fontconfig-templates/substitution-font-template.txt

   1 ▶ Documentation for substitution-font-template.conf
   2
   3 This advanced template adds one substitution rule to the basic template. Thus,
   4 it includes three rules:
   5 — the first one tells fontconfig it can use the font named [fontname] when an
   6 application asks for the generic family [genericname].
   7 — the second one tells fontconfig it can complete the font named [fontname]
   8 with glyphs taken from fonts registered under [genericname].
   9 — the third one tells fontconfig it can use [fontname] instead of
  10 [otherfontname] if an application asks for [otherfontname].
  11
  12 The typical use-case is when you package [fontname], which is a derivative of
  13 [otherfontname], and want the system to propose [fontname] if [otherfontname]
  14 is not available.
  15
  16 If you have different needs, take a look at the other templates.
  17
  18 Please replace [fontname], [genericname], and [otherfontname] with the
  19 appropriate values in the following blocks of instructions.
  20
  21 A [fontname] or [otherfontname] example would be:
  22 DejaVu Sans
  23 It's the name under which the font appears in GUI font drop-downs.
  24
  25 Fontconfig generics ([genericname]) currently include:
  26 — sans-serif
  27 — serif
  28 — monospace
  29 — fantasy
  30 – cursive
  31
  32 Processing the resulting file through xmllint with the "format" flag is usually
  33 a good idea.
  34 $ xmllint --format -o [XX]-[fontname].conf [yourfile]
  35 The output file will be named:
  36 [XX]-[fontname].conf
  37 where [XX] should be a two-digit number corresponding to the font priority in
  38 fontconfig.
  39
  40 © 2008-2009 Nicolas Mailhot <nim at fedoraproject dot org>