1 <!-- This is the Document Type Definition for font configuration files -->
2 <!ELEMENT fontconfig (dir |
11 Add a directory that provides fonts
13 <!ELEMENT dir (#PCDATA)>
14 <!ATTLIST dir xml:space (default|preserve) 'preserve'>
17 Define the per-user file that holds cache font information.
19 If the filename begins with '~', it is replaced with the users
22 <!ELEMENT cache (#PCDATA)>
23 <!ATTLIST cache xml:space (default|preserve) 'preserve'>
26 Add a directory that is searched for font cache files.
27 These hold per-directory cache data and are searched in
28 order for each directory. When writing cache files, the first
29 directory which allows the cache file to be created is used.
31 A leading '~' in a directory name is replaced with the users
34 <!ELEMENT cachedir (#PCDATA)>
35 <!ATTLIST cachedir xml:space (default|preserve) 'preserve'>
38 Reference another configuration file; note that this
39 is another complete font configuration file and not
40 just a file included by the XML parser.
42 Set 'ignore_missing' to 'yes' if errors are to be ignored.
44 If the filename begins with '~', it is replaced with the users
47 <!ELEMENT include (#PCDATA)>
49 ignore_missing (no|yes) "no"
50 xml:space (default|preserve) "preserve">
53 Global library configuration data
55 <!ELEMENT config (blank|rescan)*>
58 Specify the set of Unicode encoding values which
59 represent glyphs that are allowed to contain no
60 data. With this list, fontconfig can examine
61 fonts for broken glyphs and eliminate them from
62 the set of valid Unicode chars. This idea
63 was borrowed from Mozilla
65 <!ELEMENT blank (int)*>
68 Aliases are just a special case for multiple match elements
70 They are syntactically equivalent to:
74 <string value=[family]/>
76 <edit name="family" mode="prepend">
77 <string value=[prefer]/>
80 <edit name="family" mode="append">
81 <string value=[accept]/>
84 <edit name="family" mode="append_last">
85 <string value=[default]/>
91 Periodically rescan the font configuration and
92 directories to synch internal state with filesystem
94 <!ELEMENT rescan (int)>
97 Edit list of available fonts at startup/reload time
99 <!ELEMENT selectfont (rejectfont | acceptfont)* >
101 <!ELEMENT rejectfont (glob | pattern)*>
103 <!ELEMENT acceptfont (glob | pattern)*>
105 <!ELEMENT glob (#PCDATA)>
107 <!ELEMENT pattern (patelt)*>
109 <!ELEMENT patelt (constant)*>
111 name CDATA #REQUIRED>
113 <!ELEMENT constant (int|double|string|matrix|bool|charset|const)>
115 <!ELEMENT alias (family*, prefer?, accept?, default?)>
116 <!ELEMENT prefer (family)*>
117 <!ELEMENT accept (family)*>
118 <!ELEMENT default (family)*>
119 <!ELEMENT family (#PCDATA)>
120 <!ATTLIST family xml:space (default|preserve) 'preserve'>
122 <!ENTITY % expr 'int|double|string|matrix|bool|charset
124 |or|and|eq|not_eq|less|less_eq|more|more_eq|contains|not_contains
125 |plus|minus|times|divide|not|if|floor|ceil|round|trunc'>
128 Match and edit patterns.
130 If 'target' is 'pattern', execute the match before selecting a font.
131 if 'target' is 'font', execute the match on the result of a font
134 <!ELEMENT match (test*, edit*)>
136 target (pattern|font|scan) "pattern">
139 Match a field in a pattern
141 if 'qual' is 'any', then the match succeeds if any value in the field matches.
142 if 'qual' is 'all', then the match succeeds only if all values match.
143 if 'qual' is 'first', then the match succeeds only if the first value matches.
144 if 'qual' is 'not_first', then the match succeeds only if any value other than
146 For match elements with target=font, if test 'target' is 'pattern',
147 then the test is applied to the pattern used in matching rather than
148 to the resulting font.
150 Match elements with target=scan are applied as fonts are scanned.
151 They edit the pattern generated from the scanned font and affect
152 what the fontconfig database contains.
154 <!ELEMENT test (%expr;)*>
156 qual (any|all|first|not_first) "any"
158 target (pattern|font|default) "default"
159 compare (eq|not_eq|less|less_eq|more|more_eq|contains|not_contains) "eq">
162 Edit a field in a pattern
164 The enclosed values are used together to edit the list of values
165 associated with 'name'.
167 If 'name' matches one of those used in a test element for this match element:
168 if 'mode' is 'assign', replace the matched value.
169 if 'mode' is 'assign_replace', replace all of the values
170 if 'mode' is 'prepend', insert before the matched value
171 if 'mode' is 'append', insert after the matched value
172 if 'mode' is 'prepend_first', insert before all of the values
173 if 'mode' is 'append_last', insert after all of the values
174 If 'name' doesn't match any of those used in a test element:
175 if 'mode' is 'assign' or 'assign_replace, replace all of the values
176 if 'mode' is 'prepend' or 'prepend_first', insert before all of the values
177 if 'mode' is 'append' or 'append_last', insert after all of the values
179 <!ELEMENT edit (%expr;)*>
182 mode (assign|assign_replace|prepend|append|prepend_first|append_last) "assign"
183 binding (weak|strong|same) "weak">
186 Elements of expressions follow
188 <!ELEMENT int (#PCDATA)>
189 <!ATTLIST int xml:space (default|preserve) 'preserve'>
190 <!ELEMENT double (#PCDATA)>
191 <!ATTLIST double xml:space (default|preserve) 'preserve'>
192 <!ELEMENT string (#PCDATA)>
193 <!ATTLIST string xml:space (default|preserve) 'preserve'>
194 <!ELEMENT matrix (double,double,double,double)>
195 <!ELEMENT bool (#PCDATA)>
196 <!ELEMENT charset (#PCDATA)>
197 <!ATTLIST charset xml:space (default|preserve) 'preserve'>
198 <!ELEMENT name (#PCDATA)>
199 <!ATTLIST name xml:space (default|preserve) 'preserve'>
200 <!ELEMENT const (#PCDATA)>
201 <!ATTLIST const xml:space (default|preserve) 'preserve'>
202 <!ELEMENT or (%expr;)*>
203 <!ELEMENT and (%expr;)*>
204 <!ELEMENT eq ((%expr;), (%expr;))>
205 <!ELEMENT not_eq ((%expr;), (%expr;))>
206 <!ELEMENT less ((%expr;), (%expr;))>
207 <!ELEMENT less_eq ((%expr;), (%expr;))>
208 <!ELEMENT more ((%expr;), (%expr;))>
209 <!ELEMENT more_eq ((%expr;), (%expr;))>
210 <!ELEMENT contains ((%expr;), (%expr;))>
211 <!ELEMENT not_contains ((%expr;), (%expr;))>
212 <!ELEMENT plus (%expr;)*>
213 <!ELEMENT minus (%expr;)*>
214 <!ELEMENT times (%expr;)*>
215 <!ELEMENT divide (%expr;)*>
216 <!ELEMENT not (%expr;)>
217 <!ELEMENT if ((%expr;), (%expr;), (%expr;))>
218 <!ELEMENT floor (%expr;)>
219 <!ELEMENT ceil (%expr;)>
220 <!ELEMENT round (%expr;)>
221 <!ELEMENT trunc (%expr;)>