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) "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 <!ELEMENT test (%expr;)*>
152 qual (any|all|first|not_first) "any"
154 target (pattern|font|default) "default"
155 compare (eq|not_eq|less|less_eq|more|more_eq|contains|not_contains) "eq">
158 Edit a field in a pattern
160 The enclosed values are used together to edit the list of values
161 associated with 'name'.
163 If 'name' matches one of those used in a test element for this match element:
164 if 'mode' is 'assign', replace the matched value.
165 if 'mode' is 'assign_replace', replace all of the values
166 if 'mode' is 'prepend', insert before the matched value
167 if 'mode' is 'append', insert after the matched value
168 if 'mode' is 'prepend_first', insert before all of the values
169 if 'mode' is 'append_last', insert after all of the values
170 If 'name' doesn't match any of those used in a test element:
171 if 'mode' is 'assign' or 'assign_replace, replace all of the values
172 if 'mode' is 'prepend' or 'prepend_first', insert before all of the values
173 if 'mode' is 'append' or 'append_last', insert after all of the values
175 <!ELEMENT edit (%expr;)*>
178 mode (assign|assign_replace|prepend|append|prepend_first|append_last) "assign"
179 binding (weak|strong|same) "weak">
182 Elements of expressions follow
184 <!ELEMENT int (#PCDATA)>
185 <!ATTLIST int xml:space (default|preserve) 'preserve'>
186 <!ELEMENT double (#PCDATA)>
187 <!ATTLIST double xml:space (default|preserve) 'preserve'>
188 <!ELEMENT string (#PCDATA)>
189 <!ATTLIST string xml:space (default|preserve) 'preserve'>
190 <!ELEMENT matrix (double,double,double,double)>
191 <!ELEMENT bool (#PCDATA)>
192 <!ELEMENT charset (#PCDATA)>
193 <!ATTLIST charset xml:space (default|preserve) 'preserve'>
194 <!ELEMENT name (#PCDATA)>
195 <!ATTLIST name xml:space (default|preserve) 'preserve'>
196 <!ELEMENT const (#PCDATA)>
197 <!ATTLIST const xml:space (default|preserve) 'preserve'>
198 <!ELEMENT or (%expr;)*>
199 <!ELEMENT and (%expr;)*>
200 <!ELEMENT eq ((%expr;), (%expr;))>
201 <!ELEMENT not_eq ((%expr;), (%expr;))>
202 <!ELEMENT less ((%expr;), (%expr;))>
203 <!ELEMENT less_eq ((%expr;), (%expr;))>
204 <!ELEMENT more ((%expr;), (%expr;))>
205 <!ELEMENT more_eq ((%expr;), (%expr;))>
206 <!ELEMENT contains ((%expr;), (%expr;))>
207 <!ELEMENT not_contains ((%expr;), (%expr;))>
208 <!ELEMENT plus (%expr;)*>
209 <!ELEMENT minus (%expr;)*>
210 <!ELEMENT times (%expr;)*>
211 <!ELEMENT divide (%expr;)*>
212 <!ELEMENT not (%expr;)>
213 <!ELEMENT if ((%expr;), (%expr;), (%expr;))>
214 <!ELEMENT floor (%expr;)>
215 <!ELEMENT ceil (%expr;)>
216 <!ELEMENT round (%expr;)>
217 <!ELEMENT trunc (%expr;)>