%general-entities; ]> $LastChangedBy$ $Date$ Fontconfig-&fontconfig-version; Fontconfig Introduction to Fontconfig The Fontconfig package is a library for configuring and customizing font access. Package Information Download (HTTP): Download (FTP): Download MD5 sum: &fontconfig-md5sum; Download size: &fontconfig-size; Estimated disk space required: &fontconfig-buildsize; Estimated build time: &fontconfig-time; Fontconfig Dependencies Required and either or (requires ) Optional If you have DocBook-utils installed and you remove the --disable-docs parameter from the configure command below, you must have and installed also, or the Fontconfig build will fail. User Notes: Installation of Fontconfig Install Fontconfig by running the following commands: ./configure --prefix=/usr \ --sysconfdir=/etc --localstatedir=/var \ --disable-docs --without-add-fonts \ --with-docdir=/usr/share/doc/fontconfig-&fontconfig-version; && make To test the results, issue: make check. Now, as the root user: make install && install -v -m644 doc/*.3 /usr/share/man/man3 && install -v -m644 doc/*.5 /usr/share/man/man5 && install -v -m755 \ -d /usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-devel && install -v -m644 doc/*.{html,pdf,txt} \ /usr/share/doc/fontconfig-&fontconfig-version; && install -v -m644 doc/fontconfig-devel/* \ /usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-devel Command Explanations --localstatedir=/var: This switch places the system font cache files in /var/cache/fontconfig. --disable-docs: This switch avoids building the documentation (the release tarball includes pre-generated documentation). --without-add-fonts: This switch disables the automatic search for X Window System fonts which, if found, may confuse some applications. --with-docdir=/usr/share/doc/fontconfig-&fontconfig-version;: Though this parameter seems counter-intuitive following the preceding parameter to the configure command, it is used so that if the builder removes the --disable-docs parameter, the documentation will be installed in a versioned directory name instead of the default /usr/share/doc/fontconfig. Configuring Fontconfig Config Files /etc/fonts/*, /etc/fonts/conf.avail/*, and /etc/fonts/conf.d/* /etc/fonts/* /etc/fonts/conf.d/* /etc/fonts/conf.avail/* Configuration Information The main configuration file for Fontconfig is /etc/fonts/fonts.conf. Generally you do not want to edit this file. It will also read /etc/fonts/local.conf and any files in /etc/fonts/conf.d. To put a new font directory in the configuration, create (or update) the /etc/fonts/local.conf file with your local information or add a new file in /etc/fonts/conf.d. The default location of fonts in Fontconfig is: /usr/share/fonts ~/.fonts Fontconfig also ships many example configuration files in the /etc/fonts/conf.avail directory. Symlinking to specific files from /etc/fonts/conf.d will enable them. The default setup is generally good enough for most users. See /etc/fonts/conf.avail/README for a description of the configuration files. /usr/share/fonts ~/.fonts More information about configuring Fontconfig can be found in the user's manual in . XFree86 also includes an internal (and older) version of Fontconfig and unless it is explicitly disabled, the internal version is created leaving two slightly incompatible libraries on your system. It is recommended that you only install one version. Contents Installed Programs Installed Library Installed Directories fc-cache, fc-cat, fc-list, and fc-match libfontconfig.{so,a} /etc/fonts, /usr/include/fontconfig and /usr/share/doc/fontconfig-&fontconfig-version; Short Descriptions fc-cache is used to create font information caches. fc-cache fc-cat is used to read font information caches. fc-cat fc-list is used to create font lists. fc-list fc-match is used to match available fonts, or find fonts that match a given pattern. fc-match libfontconfig.{so,a} contains functions used by the Fontconfig programs and also by other programs to configure or customize font access. libfontconfig.{so,a}