diff options
Diffstat (limited to 'doc/fontconfig-user.sgml')
| -rw-r--r-- | doc/fontconfig-user.sgml | 196 |
1 files changed, 98 insertions, 98 deletions
diff --git a/doc/fontconfig-user.sgml b/doc/fontconfig-user.sgml index aa61469..16e98aa 100644 --- a/doc/fontconfig-user.sgml +++ b/doc/fontconfig-user.sgml @@ -4,7 +4,7 @@ ]> <!-- Copyright © 2003 Keith Packard - + Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that @@ -14,7 +14,7 @@ specific, written prior permission. The authors make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. - + THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR @@ -29,8 +29,8 @@ <manvolnum>5</manvolnum> </refmeta> <refnamediv> - <refname>fonts.conf</refname> - <refpurpose>Font configuration files</refpurpose> + <refname>fonts.conf</refname> + <refpurpose>Font configuration files</refpurpose> </refnamediv> <refsynopsisdiv> <synopsis> @@ -63,7 +63,7 @@ data found within. From an external perspective, configuration of the library consists of generating a valid XML tree and feeding that to FcConfigParse. The only other mechanism provided to applications for changing the running configuration is to add fonts and directories to the -list of application-provided font files. +list of application-provided font files. </para><para> The intent is to make font configurations relatively static, and shared by as many applications as possible. It is hoped that this will lead to more @@ -151,7 +151,7 @@ Fontconfig performs matching by measuring the distance from a provided pattern to all of the available fonts in the 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. - </para><para> + </para><para> Font matching starts with an application constructed pattern. The desired attributes of the resulting font are collected together in a pattern. Each property of the pattern can contain one or more values; these are listed in @@ -211,7 +211,7 @@ list of family names, second a list of point sizes and finally a list of additional properties: </para> <programlisting> - <families>-<point sizes>:<name1>=<values1>:<name2>=<values2>... + <families>-<point sizes>:<name1>=<values1>:<name2>=<values2>... </programlisting> <para> Values in a list are separated with commas. The name needn't include either @@ -301,11 +301,11 @@ The fontconfig document type definition resides in the external entity directory (&confdir;). Each configuration file should contain the following structure: <programlisting> - <?xml version="1.0"?> - <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> - <fontconfig> - ... - </fontconfig> + <?xml version="1.0"?> + <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> + <fontconfig> + ... + </fontconfig> </programlisting> </para> <refsect2><title><literal><fontconfig></literal></title><para> @@ -427,7 +427,7 @@ build the fontconfig database. </para></refsect2> <refsect2><title><literal><test qual="any" name="property" target="default" compare="eq"></literal></title><para> This element contains a single value which is compared with the target -('pattern', 'font', 'scan' or 'default') property "property" (substitute any of the property names seen +('pattern', 'font', 'scan' or 'default') property "property" (substitute any of the property names seen above). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", "more_eq", "contains" or "not_contains". 'qual' may either be the default, "any", in which case the match succeeds if any value associated with the property matches the test value, or @@ -595,102 +595,102 @@ This is an example of a system-wide configuration file <!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd"> <!-- &confdir;/fonts.conf file to configure system font access --> <fontconfig> -<!-- - Find fonts in these directories +<!-- + Find fonts in these directories --> <dir>/usr/share/fonts</dir> <dir>/usr/X11R6/lib/X11/fonts</dir> <!-- - Accept deprecated 'mono' alias, replacing it with 'monospace' + Accept deprecated 'mono' alias, replacing it with 'monospace' --> <match target="pattern"> - <test qual="any" name="family"><string>mono</string></test> - <edit name="family" mode="assign"><string>monospace</string></edit> + <test qual="any" name="family"><string>mono</string></test> + <edit name="family" mode="assign"><string>monospace</string></edit> </match> <!-- - Names not including any well known alias are given 'sans-serif' + Names not including any well known alias are given 'sans-serif' --> <match target="pattern"> - <test qual="all" name="family" compare="not_eq"><string>sans-serif</string></test> - <test qual="all" name="family" compare="not_eq"><string>serif</string></test> - <test qual="all" name="family" compare="not_eq"><string>monospace</string></test> - <edit name="family" mode="append_last"><string>sans-serif</string></edit> + <test qual="all" name="family" compare="not_eq"><string>sans-serif</string></test> + <test qual="all" name="family" compare="not_eq"><string>serif</string></test> + <test qual="all" name="family" compare="not_eq"><string>monospace</string></test> + <edit name="family" mode="append_last"><string>sans-serif</string></edit> </match> <!-- - Load per-user customization file, but don't complain - if it doesn't exist + Load per-user customization file, but don't complain + if it doesn't exist --> <include ignore_missing="yes" prefix="xdg">fontconfig/fonts.conf</include> <!-- - Load local customization files, but don't complain - if there aren't any + Load local customization files, but don't complain + if there aren't any --> <include ignore_missing="yes">conf.d</include> <include ignore_missing="yes">local.conf</include> <!-- - Alias well known font names to available TrueType fonts. - These substitute TrueType faces for similar Type1 - faces to improve screen appearance. + Alias well known font names to available TrueType fonts. + These substitute TrueType faces for similar Type1 + faces to improve screen appearance. --> <alias> - <family>Times</family> - <prefer><family>Times New Roman</family></prefer> - <default><family>serif</family></default> + <family>Times</family> + <prefer><family>Times New Roman</family></prefer> + <default><family>serif</family></default> </alias> <alias> - <family>Helvetica</family> - <prefer><family>Arial</family></prefer> - <default><family>sans</family></default> + <family>Helvetica</family> + <prefer><family>Arial</family></prefer> + <default><family>sans</family></default> </alias> <alias> - <family>Courier</family> - <prefer><family>Courier New</family></prefer> - <default><family>monospace</family></default> + <family>Courier</family> + <prefer><family>Courier New</family></prefer> + <default><family>monospace</family></default> </alias> <!-- - Provide required aliases for standard names - Do these after the users configuration file so that - any aliases there are used preferentially + Provide required aliases for standard names + Do these after the users configuration file so that + any aliases there are used preferentially --> <alias> - <family>serif</family> - <prefer><family>Times New Roman</family></prefer> + <family>serif</family> + <prefer><family>Times New Roman</family></prefer> </alias> <alias> - <family>sans</family> - <prefer><family>Arial</family></prefer> + <family>sans</family> + <prefer><family>Arial</family></prefer> </alias> <alias> - <family>monospace</family> - <prefer><family>Andale Mono</family></prefer> + <family>monospace</family> + <prefer><family>Andale Mono</family></prefer> </alias> <-- - The example of the requirements of OR operator; - If the 'family' contains 'Courier New' OR 'Courier' - add 'monospace' as the alternative + The example of the requirements of OR operator; + If the 'family' contains 'Courier New' OR 'Courier' + add 'monospace' as the alternative --> <match target="pattern"> - <test name="family" compare="eq"> - <string>Courier New</string> - </test> - <edit name="family" mode="prepend"> - <string>monospace</string> - </edit> + <test name="family" compare="eq"> + <string>Courier New</string> + </test> + <edit name="family" mode="prepend"> + <string>monospace</string> + </edit> </match> <match target="pattern"> - <test name="family" compare="eq"> - <string>Courier</string> - </test> - <edit name="family" mode="prepend"> - <string>monospace</string> - </edit> + <test name="family" compare="eq"> + <string>Courier</string> + </test> + <edit name="family" mode="prepend"> + <string>monospace</string> + </edit> </match> </fontconfig> @@ -708,52 +708,52 @@ $XDG_CONFIG_HOME/fontconfig/fonts.conf <fontconfig> <!-- - Private font directory + Private font directory --> <dir prefix="xdg">fonts</dir> <!-- - use rgb sub-pixel ordering to improve glyph appearance on - LCD screens. Changes affecting rendering, but not matching - should always use target="font". + use rgb sub-pixel ordering to improve glyph appearance on + LCD screens. Changes affecting rendering, but not matching + should always use target="font". --> <match target="font"> - <edit name="rgba" mode="assign"><const>rgb</const></edit> + <edit name="rgba" mode="assign"><const>rgb</const></edit> </match> <!-- - use WenQuanYi Zen Hei font when serif is requested for Chinese + use WenQuanYi Zen Hei font when serif is requested for Chinese --> <match> - <!-- - If you don't want to use WenQuanYi Zen Hei font for zh-tw etc, - you can use zh-cn instead of zh. - Please note, even if you set zh-cn, it still matches zh. - if you don't like it, you can use compare="eq" - instead of compare="contains". - --> - <test name="lang" compare="contains"> - <string>zh</string> - </test> - <test name="family"> - <string>serif</string> - </test> - <edit name="family" mode="prepend"> - <string>WenQuanYi Zen Hei</string> - </edit> + <!-- + If you don't want to use WenQuanYi Zen Hei font for zh-tw etc, + you can use zh-cn instead of zh. + Please note, even if you set zh-cn, it still matches zh. + if you don't like it, you can use compare="eq" + instead of compare="contains". + --> + <test name="lang" compare="contains"> + <string>zh</string> + </test> + <test name="family"> + <string>serif</string> + </test> + <edit name="family" mode="prepend"> + <string>WenQuanYi Zen Hei</string> + </edit> </match> <!-- - use VL Gothic font when sans-serif is requested for Japanese + use VL Gothic font when sans-serif is requested for Japanese --> <match> - <test name="lang" compare="contains"> - <string>ja</string> - </test> - <test name="family"> - <string>sans-serif</string> - </test> - <edit name="family" mode="prepend"> - <string>VL Gothic</string> - </edit> + <test name="lang" compare="contains"> + <string>ja</string> + </test> + <test name="family"> + <string>sans-serif</string> + </test> + <edit name="family" mode="prepend"> + <string>VL Gothic</string> + </edit> </match> </fontconfig> </programlisting> @@ -773,7 +773,7 @@ is the conventional name for a directory of additional configuration files managed by external applications or the local administrator. The filenames starting with decimal digits are sorted in lexicographic order and used as additional configuration files. All of these files are in XML -format. The master fonts.conf file references this directory in an +format. The master fonts.conf file references this directory in an <include> directive. </para> <para> @@ -837,8 +837,8 @@ fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1), <ulink url="https: </para> </refsect1> <refsect1><title>Version</title> - <para> + <para> Fontconfig version &version; - </para> + </para> </refsect1> </refentry> |