]> git.wh0rd.org - fontconfig.git/blame - fonts.conf.in
Document FC_DEBUG values (bug 6393). Document name \ escape syntax.
[fontconfig.git] / fonts.conf.in
CommitLineData
24330d27
KP
1<?xml version="1.0"?>
2<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
302e07f1 3<!-- /etc/fonts/fonts.conf file to configure system font access -->
24330d27
KP
4<fontconfig>
5
a6531d8c 6<!--
302e07f1
KP
7 DO NOT EDIT THIS FILE.
8 IT WILL BE REPLACED WHEN FONTCONFIG IS UPDATED.
9 LOCAL CHANGES BELONG IN 'local.conf'.
10
a6531d8c
KP
11 The intent of this standard configuration file is to be adequate for
12 most environments. If you have a reasonably normal environment and
13 have found problems with this configuration, they are probably
ef82cce1
KP
14 things that others will also want fixed. Please submit any
15 problems to the fontconfig bugzilla system located at fontconfig.org
a6531d8c 16
302e07f1 17 Note that the normal 'make install' procedure for fontconfig is to
0ce819b6
KP
18 replace any existing fonts.conf file with the new version. Place
19 any local customizations in local.conf which this file references.
20
a6531d8c
KP
21 Keith Packard
22-->
23
c5a0b541 24<!-- Font directory list -->
24330d27 25
20fa60c9
KP
26 <dir>@FC_DEFAULT_FONTS@</dir>
27 @FC_FONTPATH@
a6531d8c 28 <dir>~/.fonts</dir>
24330d27 29
7410e40b
PL
30<!-- Font cache directory list -->
31
32 <cachedir>@FC_CACHEDIR@</cachedir>
d2f78684 33 <cachedir>~/.fontconfig</cachedir>
7410e40b 34
24330d27
KP
35<!--
36 Accept deprecated 'mono' alias, replacing it with 'monospace'
37-->
38 <match target="pattern">
39 <test qual="any" name="family">
40 <string>mono</string>
41 </test>
42 <edit name="family" mode="assign">
43 <string>monospace</string>
44 </edit>
45 </match>
46
fa244f3d
KP
47<!--
48 Accept alternate 'sans serif' spelling, replacing it with 'sans-serif'
49-->
50 <match target="pattern">
51 <test qual="any" name="family">
52 <string>sans serif</string>
53 </test>
54 <edit name="family" mode="assign">
55 <string>sans-serif</string>
56 </edit>
57 </match>
58
24330d27
KP
59<!--
60 Accept deprecated 'sans' alias, replacing it with 'sans-serif'
61-->
62 <match target="pattern">
63 <test qual="any" name="family">
64 <string>sans</string>
65 </test>
66 <edit name="family" mode="assign">
67 <string>sans-serif</string>
68 </edit>
69 </match>
70
71<!--
72 Mark common families with their generics so we'll get
73 something reasonable
74-->
75
76<!--
77 Serif faces
78 -->
79 <alias>
b1e98ed9 80 <family>Bitstream Vera Serif</family>
db970d35 81 <family>DejaVu Serif</family>
24330d27 82 <family>Times New Roman</family>
192296d8
KP
83 <family>Thorndale AMT</family>
84 <family>Times</family>
fb9545b1
KP
85 <family>Nimbus Roman No9 L</family>
86 <family>Luxi Serif</family>
06a48f20
KP
87 <family>Kochi Mincho</family>
88 <family>AR PL SungtiL GB</family>
899e3526 89 <family>AR PL Mingti2L Big5</family>
2ba729ed 90 <family>MS 明朝</family>
e5871b5c
KP
91 <family>Baekmuk Batang</family>
92 <family>FreeSerif</family>
328929f5 93 <family>MgOpen Canonica</family>
24330d27
KP
94 <default><family>serif</family></default>
95 </alias>
96<!--
97 Sans-serif faces
98 -->
99 <alias>
b1e98ed9 100 <family>Bitstream Vera Sans</family>
db970d35 101 <family>DejaVu Sans</family>
24330d27 102 <family>Helvetica</family>
24330d27 103 <family>Arial</family>
24330d27 104 <family>Verdana</family>
192296d8 105 <family>Albany AMT</family>
fb9545b1
KP
106 <family>Nimbus Sans L</family>
107 <family>Luxi Sans</family>
06a48f20
KP
108 <family>Kochi Gothic</family>
109 <family>AR PL KaitiM GB</family>
899e3526 110 <family>AR PL KaitiM Big5</family>
2ba729ed 111 <family>MS ゴシック</family>
06a48f20 112 <family>Baekmuk Dotum</family>
899e3526 113 <family>SimSun</family>
e5871b5c 114 <family>FreeSans</family>
328929f5 115 <family>MgOpen Modata</family>
24330d27
KP
116 <default><family>sans-serif</family></default>
117 </alias>
118<!--
119 Monospace faces
120 -->
121 <alias>
db970d35 122 <family>Bitstream Vera Sans Mono</family>
b17cf498 123 <family>DejaVu Sans Mono</family>
24330d27 124 <family>Courier</family>
24330d27 125 <family>Courier New</family>
24330d27 126 <family>Andale Mono</family>
fb9545b1 127 <family>Luxi Mono</family>
192296d8 128 <family>Cumberland AMT</family>
06a48f20 129 <family>Nimbus Mono L</family>
899e3526 130 <family>NSimSun</family>
e5871b5c 131 <family>FreeMono</family>
24330d27
KP
132 <default><family>monospace</family></default>
133 </alias>
134<!--
135 If the font still has no generic name, add sans-serif
136 -->
137 <match target="pattern">
138 <test qual="all" name="family" compare="not_eq">
139 <string>sans-serif</string>
140 </test>
141 <test qual="all" name="family" compare="not_eq">
142 <string>serif</string>
143 </test>
144 <test qual="all" name="family" compare="not_eq">
145 <string>monospace</string>
146 </test>
147 <edit name="family" mode="append_last">
148 <string>sans-serif</string>
149 </edit>
150 </match>
e5871b5c 151
192296d8 152<!--
b43dbbdc 153 URW provides metric and shape compatible fonts for these 10 Adobe families.
192296d8 154 -->
716ac8b8 155 <alias>
b43dbbdc
PL
156 <family>Avant Garde</family>
157 <accept><family>URW Gothic L</family></accept>
158 </alias>
159 <alias>
160 <family>Bookman</family>
161 <accept><family>URW Bookman L</family></accept>
162 </alias>
163 <alias>
164 <family>Courier</family>
165 <accept><family>Nimbus Mono L</family></accept>
716ac8b8
KP
166 </alias>
167 <alias>
168 <family>Helvetica</family>
169 <accept><family>Nimbus Sans L</family></accept>
170 </alias>
171 <alias>
b43dbbdc
PL
172 <family>New Century Schoolbook</family>
173 <accept><family>Century Schoolbook L</family></accept>
174 </alias>
175 <alias>
176 <family>Palatino</family>
177 <accept><family>URW Palladio L</family></accept>
178 </alias>
b43dbbdc
PL
179 <alias>
180 <family>Times</family>
181 <accept><family>Nimbus Roman No9 L</family></accept>
182 </alias>
183 <alias>
184 <family>Zapf Chancery</family>
185 <accept><family>URW Chancery L</family></accept>
186 </alias>
187 <alias>
188 <family>Zapf Dingbats</family>
189 <accept><family>Dingbats</family></accept>
190 </alias>
a7757294
PL
191 <match target="pattern">
192 <test name="family">
193 <string>Symbol</string>
194 </test>
195 <edit name="family" mode="append" binding="strong">
196 <string>Standard Symbols L</string>
197 </edit>
198 </match>
192296d8
KP
199<!--
200 AMT provides metric and shape compatible fonts for these three web font
716ac8b8 201 families.
192296d8
KP
202 -->
203 <alias>
204 <family>Times New Roman</family>
205 <accept><family>Thorndale AMT</family></accept>
2ba729ed 206 </alias>
192296d8
KP
207 <alias>
208 <family>Arial</family>
209 <accept><family>Albany AMT</family></accept>
2ba729ed 210 </alias>
192296d8
KP
211 <alias>
212 <family>Courier New</family>
213 <accept><family>Cumberland AMT</family></accept>
2ba729ed 214 </alias>
192296d8 215
cc168fa6
KP
216<!--
217 Some Asian fonts misadvertise themselves as monospaced when
218 in fact they are dual-spaced (half and full). This makes
219 FreeType very confused as it forces all widths to match.
220 Undo this magic by disabling the width forcing code -->
221 <match target="font">
222 <test name="family"><string>GulimChe</string></test>
223 <edit name="globaladvance"><bool>false</bool></edit>
224 </match>
e5871b5c 225
cc168fa6
KP
226 <match target="font">
227 <test name="family"><string>DotumChe</string></test>
228 <edit name="globaladvance"><bool>false</bool></edit>
229 </match>
230
df43986c
KP
231 <match target="font">
232 <test name="family"><string>BatangChe</string></test>
233 <edit name="globaladvance"><bool>false</bool></edit>
234 </match>
235
236 <match target="font">
237 <test name="family"><string>GungsuhChe</string></test>
238 <edit name="globaladvance"><bool>false</bool></edit>
239 </match>
240
b1e98ed9
KP
241<!--
242 The Bitstream Vera fonts have GASP entries suggesting that hinting be
243 disabled below 8 ppem, but FreeType ignores those, preferring to use
244 the data found in the instructed hints. The initial Vera release
245 didn't include the right instructions in the 'prep' table. Fix this
246 by disabling hinting manually at smaller sizes (< 8ppem)
247 -->
e5871b5c 248
b1e98ed9
KP
249 <match target="font">
250 <test name="family">
251 <string>Bitstream Vera Sans</string>
252 </test>
253 <test name="pixelsize" compare="less">
254 <double>7.5</double>
255 </test>
256 <edit name="hinting">
257 <bool>false</bool>
258 </edit>
259 </match>
e5871b5c 260
b1e98ed9
KP
261 <match target="font">
262 <test name="family">
263 <string>Bitstream Vera Serif</string>
264 </test>
265 <test name="pixelsize" compare="less">
266 <double>7.5</double>
267 </test>
268 <edit name="hinting">
269 <bool>false</bool>
270 </edit>
271 </match>
e5871b5c 272
b1e98ed9
KP
273 <match target="font">
274 <test name="family">
275 <string>Bitstream Vera Sans Mono</string>
276 </test>
277 <test name="pixelsize" compare="less">
278 <double>7.5</double>
279 </test>
280 <edit name="hinting">
281 <bool>false</bool>
282 </edit>
283 </match>
e5871b5c 284
24330d27
KP
285<!--
286 Load per-user customization file
287-->
288 <include ignore_missing="yes">~/.fonts.conf</include>
289
938bc633
KP
290<!--
291 Load local system customization file
292-->
2d9c79c0 293 <include ignore_missing="yes">conf.d</include>
938bc633
KP
294 <include ignore_missing="yes">local.conf</include>
295
24330d27
KP
296<!--
297 Provide required aliases for standard names
298-->
299 <alias>
300 <family>serif</family>
301 <prefer>
b1e98ed9 302 <family>Bitstream Vera Serif</family>
db970d35 303 <family>DejaVu Serif</family>
24330d27 304 <family>Times New Roman</family>
192296d8 305 <family>Thorndale AMT</family>
24330d27 306 <family>Luxi Serif</family>
192296d8 307 <family>Nimbus Roman No9 L</family>
24330d27 308 <family>Times</family>
6d3a90a4 309 <family>Frank Ruehl</family>
328929f5
PL
310 <family>MgOpen Canonica</family>
311 <family>FreeSerif</family>
06a48f20
KP
312 <family>Kochi Mincho</family>
313 <family>AR PL SungtiL GB</family>
899e3526 314 <family>AR PL Mingti2L Big5</family>
2ba729ed 315 <family>MS 明朝</family>
e5871b5c 316 <family>Baekmuk Batang</family>
24330d27
KP
317 </prefer>
318 </alias>
319 <alias>
320 <family>sans-serif</family>
321 <prefer>
b1e98ed9 322 <family>Bitstream Vera Sans</family>
db970d35 323 <family>DejaVu Sans</family>
24330d27 324 <family>Verdana</family>
24330d27 325 <family>Arial</family>
192296d8
KP
326 <family>Albany AMT</family>
327 <family>Luxi Sans</family>
328 <family>Nimbus Sans L</family>
24330d27 329 <family>Helvetica</family>
6d3a90a4 330 <family>Nachlieli</family>
328929f5
PL
331 <family>MgOpen Modata</family>
332 <family>FreeSans</family>
06a48f20
KP
333 <family>Kochi Gothic</family>
334 <family>AR PL KaitiM GB</family>
899e3526 335 <family>AR PL KaitiM Big5</family>
2ba729ed 336 <family>MS ゴシック</family>
06a48f20 337 <family>Baekmuk Dotum</family>
899e3526 338 <family>SimSun</family>
24330d27
KP
339 </prefer>
340 </alias>
341 <alias>
342 <family>monospace</family>
343 <prefer>
b1e98ed9 344 <family>Bitstream Vera Sans Mono</family>
db970d35 345 <family>DejaVu Sans Mono</family>
24330d27
KP
346 <family>Andale Mono</family>
347 <family>Courier New</family>
192296d8 348 <family>Cumberland AMT</family>
24330d27 349 <family>Luxi Mono</family>
06a48f20 350 <family>Nimbus Mono L</family>
192296d8 351 <family>Courier</family>
6d3a90a4 352 <family>Miriam Mono</family>
328929f5 353 <family>FreeMono</family>
06a48f20
KP
354 <family>Kochi Gothic</family>
355 <family>AR PL KaitiM GB</family>
356 <family>Baekmuk Dotum</family>
24330d27
KP
357 </prefer>
358 </alias>
359
c689ec22
KP
360<!--
361 Artificial oblique for fonts without an italic or oblique version
362 -->
363
364 <match target="font">
365 <!-- check to see if the font is roman -->
938bc633 366 <test name="slant">
c689ec22
KP
367 <const>roman</const>
368 </test>
369 <!-- check to see if the pattern requested non-roman -->
938bc633 370 <test target="pattern" name="slant" compare="not_eq">
c689ec22
KP
371 <const>roman</const>
372 </test>
373 <!-- multiply the matrix to slant the font -->
374 <edit name="matrix" mode="assign">
375 <times>
376 <name>matrix</name>
ddde1797 377 <matrix><double>1</double><double>0.2</double>
c689ec22
KP
378 <double>0</double><double>1</double>
379 </matrix>
380 </times>
381 </edit>
382 <!-- pretend the font is oblique now -->
383 <edit name="slant" mode="assign">
384 <const>oblique</const>
385 </edit>
720298e7
PL
386 <!-- and disable embedded bitmaps for artificial oblique -->
387 <edit name="embeddedbitmap" mode="assign">
388 <bool>false</bool>
389 </edit>
c689ec22
KP
390 </match>
391
46a10637
KP
392<!--
393 Synthetic emboldening for fonts that do not have bold face available
394 -->
395
396 <match target="font">
397 <!-- check to see if the font is just regular -->
398 <test name="weight" compare="less_eq">
efa9f2bd 399 <const>medium</const>
46a10637
KP
400 </test>
401 <!-- check to see if the pattern requests bold -->
efa9f2bd
PL
402 <test target="pattern" name="weight" compare="more">
403 <const>medium</const>
46a10637 404 </test>
efa9f2bd
PL
405 <!--
406 set the embolden flag
407 needed for applications using cairo, e.g. gucharmap, gedit, ...
408 -->
46a10637
KP
409 <edit name="embolden" mode="assign">
410 <bool>true</bool>
411 </edit>
efa9f2bd
PL
412 <!--
413 set weight to bold
414 needed for applications using Xft directly, e.g. Firefox, ...
415 -->
416 <edit name="weight" mode="assign">
417 <const>bold</const>
418 </edit>
46a10637
KP
419 </match>
420
421
fb9545b1 422 <config>
24330d27
KP
423<!--
424 These are the default Unicode chars that are expected to be blank
425 in fonts. All other blank chars are assumed to be broken and
426 won't appear in the resulting charsets
427 -->
fb9545b1 428 <blank>
9cc93576 429 <int>0x0020</int> <!-- SPACE -->
8759822e
KP
430 <int>0x00A0</int> <!-- NO-BREAK SPACE -->
431 <int>0x00AD</int> <!-- SOFT HYPHEN -->
432 <int>0x034F</int> <!-- COMBINING GRAPHEME JOINER -->
433 <int>0x0600</int> <!-- ARABIC NUMBER SIGN -->
434 <int>0x0601</int> <!-- ARABIC SIGN SANAH -->
435 <int>0x0602</int> <!-- ARABIC FOOTNOTE MARKER -->
436 <int>0x0603</int> <!-- ARABIC SIGN SAFHA -->
437 <int>0x06DD</int> <!-- ARABIC END OF AYAH -->
438 <int>0x070F</int> <!-- SYRIAC ABBREVIATION MARK -->
439 <int>0x115F</int> <!-- HANGUL CHOSEONG FILLER -->
9cc93576
KP
440 <int>0x1160</int> <!-- HANGUL JUNGSEONG FILLER -->
441 <int>0x1680</int> <!-- OGHAM SPACE MARK -->
8759822e
KP
442 <int>0x17B4</int> <!-- KHMER VOWEL INHERENT AQ -->
443 <int>0x17B5</int> <!-- KHMER VOWEL INHERENT AA -->
444 <int>0x180E</int> <!-- MONGOLIAN VOWEL SEPARATOR -->
9cc93576
KP
445 <int>0x2000</int> <!-- EN QUAD -->
446 <int>0x2001</int> <!-- EM QUAD -->
447 <int>0x2002</int> <!-- EN SPACE -->
448 <int>0x2003</int> <!-- EM SPACE -->
449 <int>0x2004</int> <!-- THREE-PER-EM SPACE -->
450 <int>0x2005</int> <!-- FOUR-PER-EM SPACE -->
451 <int>0x2006</int> <!-- SIX-PER-EM SPACE -->
452 <int>0x2007</int> <!-- FIGURE SPACE -->
453 <int>0x2008</int> <!-- PUNCTUATION SPACE -->
454 <int>0x2009</int> <!-- THIN SPACE -->
8759822e
KP
455 <int>0x200A</int> <!-- HAIR SPACE -->
456 <int>0x200B</int> <!-- ZERO WIDTH SPACE -->
457 <int>0x200C</int> <!-- ZERO WIDTH NON-JOINER -->
458 <int>0x200D</int> <!-- ZERO WIDTH JOINER -->
459 <int>0x200E</int> <!-- LEFT-TO-RIGHT MARK -->
460 <int>0x200F</int> <!-- RIGHT-TO-LEFT MARK -->
9cc93576
KP
461 <int>0x2028</int> <!-- LINE SEPARATOR -->
462 <int>0x2029</int> <!-- PARAGRAPH SEPARATOR -->
8759822e
KP
463 <int>0x202A</int> <!-- LEFT-TO-RIGHT EMBEDDING -->
464 <int>0x202B</int> <!-- RIGHT-TO-LEFT EMBEDDING -->
465 <int>0x202C</int> <!-- POP DIRECTIONAL FORMATTING -->
466 <int>0x202D</int> <!-- LEFT-TO-RIGHT OVERRIDE -->
467 <int>0x202E</int> <!-- RIGHT-TO-LEFT OVERRIDE -->
468 <int>0x202F</int> <!-- NARROW NO-BREAK SPACE -->
469 <int>0x205F</int> <!-- MEDIUM MATHEMATICAL SPACE -->
9cc93576
KP
470 <int>0x2060</int> <!-- WORD JOINER -->
471 <int>0x2061</int> <!-- FUNCTION APPLICATION -->
472 <int>0x2062</int> <!-- INVISIBLE TIMES -->
473 <int>0x2063</int> <!-- INVISIBLE SEPARATOR -->
ce50587c
KP
474 <int>0x206A</int> <!-- INHIBIT SYMMETRIC SWAPPING -->
475 <int>0x206B</int> <!-- ACTIVATE SYMMETRIC SWAPPING -->
476 <int>0x206C</int> <!-- INHIBIT ARABIC FORM SHAPING -->
477 <int>0x206D</int> <!-- ACTIVATE ARABIC FORM SHAPING -->
478 <int>0x206E</int> <!-- NATIONAL DIGIT SHAPES -->
479 <int>0x206F</int> <!-- NOMINAL DIGIT SHAPES -->
9cc93576 480 <int>0x3000</int> <!-- IDEOGRAPHIC SPACE -->
f9ad97b0 481 <int>0x3164</int> <!-- HANGUL FILLER -->
8759822e
KP
482 <int>0xFEFF</int> <!-- ZERO WIDTH NO-BREAK SPACE -->
483 <int>0xFFA0</int> <!-- HALFWIDTH HANGUL FILLER -->
484 <int>0xFFF9</int> <!-- INTERLINEAR ANNOTATION ANCHOR -->
485 <int>0xFFFA</int> <!-- INTERLINEAR ANNOTATION SEPARATOR -->
486 <int>0xFFFB</int> <!-- INTERLINEAR ANNOTATION TERMINATOR -->
fb9545b1
KP
487 </blank>
488<!--
489 Rescan configuration every 30 seconds when FcFontSetList is called
490 -->
491 <rescan>
492 <int>30</int>
493 </rescan>
494 </config>
24330d27
KP
495
496</fontconfig>