Font Local Configuration


Table of Contents

/etc/fonts/local.conf 
Debian Etch, XOrg 
Debian Sarge, XFree86 

/etc/fonts/local.conf 

Debian Etch, XOrg 

Example 1. File /etc/fonts/local.conf from Debian Etch, XOrg

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<!-- /etc/fonts/local.conf file for system local configuration  -->
<!--
        DO NOT EDIT THE /etc/fonts/fonts.conf FILE.
        IT WILL BE REPLACED WHEN FONTCONFIG IS UPDATED.
        LOCAL CHANGES BELONG IN 'local.conf'.

        Note that the normal 'make install' procedure for fontconfig is to
        replace any existing fonts.conf file with the new version.  Place
        any local customizations in local.conf which this file references.
-->

<fontconfig>

<!-- Font directory list -->


<!--
  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>
        </match>
-->

<!--
  Font family preferences
-->

<!--
  Serif faces
 -->
  <alias>
      <family>serif</family>
      <prefer>
         <family>Bitstream Vera Serif</family>
         <family>Times New Roman</family>
         <family>Times</family>
          <family>SimSun</family><family>SimKai</family><family>SimHei</family>
          <family>AR PL New Sung</family>
          <family>AR PL Mingti2L Big5</family>
          <family>AR PL SungtiL GB</family>
          <family>Ming(ISO10646)</family>
          <family>Kochi Mincho</family>
          <family>Baekmuk Batung</family>
      </prefer>
  </alias>

<!--
  Sans-serif faces
 -->
  <alias>
      <family>sans-serif</family>
      <prefer>
         <family>Bitstream Vera Sans</family>
          <family>Arial</family>
          <family>Verdana</family>
          <family>Helvetica</family>
          <family>SimSun</family><family>SimKai</family><family>SimHei</family>
          <family>AR PL New Sung</family>
          <family>Ming(ISO10646)</family>
          <family>AR PL kaitiM Big5</family>
          <family>AR PL kaitiM GB</family>
          <family>Kochi Gothic</family>
          <family>Baekmuk Dotum</family>
      </prefer>
  </alias>

<!--
  Monospace faces
 -->
  <alias>
      <family>monospace</family>
      <prefer>
         <family>Bitstream Vera Sans Mono</family>
          <family>Courier New</family>
          <family>Courier</family>
          <family>SimSun</family><family>SimKai</family><family>SimHei</family>
          <family>AR PL New Sung</family>
          <family>Ming(ISO10646)</family>
          <family>Kochi Mincho</family>
          <family>Baekmuk Batung</family>
      </prefer>
  </alias>


<!--
  Some Asian fonts misadvertise themselves as monospaced when
  in fact they are dual-spaced (half and full).  This makes
  FreeType very confused as it forces all widths to match.
  Undo this magic by disabling the width forcing code
        <match target="font">
                <test name="family"><string>GulimChe</string></test>
                <edit name="globaladvance"><bool>false</bool></edit>
        </match>
 -->

  <!-- Disable font antialias for fonts <= 16px -->
  <match target="font">
  <!-- Disable font antialias for Chinese <= 16px -->
<!--
    <test qual="any" name="family" compare="eq">
      <string>AR PL Mingti2L Big5</string>
      <string>AR PL SungtiL Big5</string>
      <string>SimSun</string>
      <string>AR PL New Sung</string>
      <string>Ming(ISO10646)</string>
      <string>MingLiu</string>
      <string>PMingLiu</string>
      <string>Kochi Mincho</string>
      <string>Baekmuk Dotum</string>
    </test>
 -->
    <test name="pixelsize" compare="less_eq">
      <double>16</double>
    </test>
    <edit name="antialias">
      <bool>false</bool>
    </edit>
    <edit name="hinting">
      <bool>true</bool>
    </edit>
  </match>


</fontconfig>

documented on: 2006.08.27

Debian Sarge, XFree86 

Example 2. File /etc/fonts/local.conf from Debian Sarge, XFree86

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <include ignore_missing="yes">/var/lib/defoma/fontconfig.d/fonts.conf</include>
<!-- Uncomment below to enable bitmapped fonts -->
<!--
  <dir>/usr/X11R6/lib/X11/fonts</dir>
-->
<!-- Uncomment below to enable subpixel rendering -->
<!--
  <match target="font">
    <test qual="all" name="rgba">
      <const>unknown</const>
    </test>
    <edit name="rgba" mode="assign"><const>rgb</const></edit>
  </match>
-->
<!-- Uncomment below to enable the freetype autohinter module -->
<!--
  <match target="font">
    <edit name="autohint" mode="assign">
      <bool>true</bool>
    </edit>
  </match>
-->

<!-- Disable font alias for Chinese 12-16 -->
  <match target="font">
    <test qual="any" name="family" compare="eq">
      <string>SimSun</string>
      <string>SimHei</string>
    </test>
    <test name="pixelsize" compare="more_eq">
      <double>12</double>
    </test>
    <test name="pixelsize" compare="less_eq">
      <double>16</double>
    </test>
    <edit name="antialias">
      <bool>false</bool>
    </edit>
  </match>

  <alias>
    <family>Bitstream Vera Sans Mono</family>
    <prefer>
      <family>SimSun</family>
    </prefer>
  </alias>

  <alias>
    <family>SimSun</family>
    <default>
      <family>sans-serif</family>
      <family>serif</family>
      <family>monospace</family>
    </default>
  </alias>

  <match target="pattern">
    <test qual="any" name="family">
      <string>serif</string>
    </test>
    <edit name="family" mode="append" binding="strong">
      <string>Bitstream Vera Serif</string>
    </edit>
  </match>

  <match target="pattern">
    <test qual="any" name="family">
      <string>sans-serif</string>
    </test>
    <edit name="family" mode="append" binding="strong">
      <string>Bitstream Vera Sans</string>
    </edit>
  </match>

  <match target="pattern">
    <test qual="any" name="family">
      <string>monospace</string>
    </test>
    <edit name="family" mode="append" binding="strong">
      <string>Bitstream Vera Sans Mono</string>
    </edit>
  </match>

  <alias>
    <family>serif</family>
    <prefer>
      <family>Bitstream Vera Serif</family>
      <family>SimSun</family>
    </prefer>
  </alias>

  <alias>
    <family>sans-serif</family>
    <prefer>
      <family>Bitstream Vera Sans</family>
      <family>SimSun</family>
    </prefer>
  </alias>

  <alias>
    <family>monospace</family>
    <prefer>
      <family>Bitstream Vera Sans Mono</family>
      <family>SimSun</family>
    </prefer>
  </alias>

<!--
 Add by firefly@firefly.idv.tw
 Artificial bold for fonts without a bold version.
-->
  <match target="font">
    <test target="pattern" name="weight" compare="more">
      <const>medium</const>
    </test>
    <edit name="weight" mode="assign">
      <const>bold</const>
    </edit>
  </match>
<!--
Add by firefly@firefly.idv.tw
Disable "Global Advance" for all CJK mono spacing fonts.
-->
  <match target="font">
    <test target="pattern" name="lang" compare="contains">
      <string>zh-tw</string>
      <string>zh-cn</string>
      <string>ja</string>
      <string>ko</string>
    </test>
    <test name="spacing" compare="eq">
      <const>mono</const>
    </test>
    <edit name="globaladvance" mode="assign">
      <bool>false</bool>
    </edit>
  </match>
<!--
Add by firefly@firefly.idv.tw
Enable "hinting & autohint" for all fonts.
-->
    <match target="font">
      <edit name="hinting" mode="assign">
        <bool>true</bool>
      </edit>
      <edit name="autohint" mode="assign">
        <bool>true</bool>
      </edit>
    </match>
 <dir>/usr/local/share/fonts</dir>
 <dir>/usr/share/fonts</dir>
 <dir>/usr/X11R6/lib/X11/fonts</dir>
 <dir>/usr/lib/X11/fonts/misc</dir>
 <dir>/usr/lib/X11/fonts/75dpi</dir>
 <dir>/usr/lib/X11/fonts/100dpi</dir>
 <dir>/usr/lib/X11/fonts/Type1</dir>
 <dir>/usr/lib/X11/fonts/Speedo</dir>
</fontconfig>

documented on: 2005-01-14