Difference between revisions of "Font configuration/Examples"

From ArchWiki
Jump to: navigation, search
m (Basic config with no hinting for italic or bold and some other tuning: - very nice brebs, clean up style a little bit)
(defaults to .config if XDG_CONFIG_HOME is not defined, details are in XDG base directory support)
 
(42 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
[[Category:Fonts]]
 
[[Category:Fonts]]
Configurations can vary to a degree.  Please feel free to post your fontconfig configurations and the rationale behind them.
+
[[ja:フォント設定/サンプル]]
 +
[[ru:Font configuration/Examples]]
 +
See [[Font configuration]] for the main article.  
  
== brebs' configuration ==
+
Configurations can vary to a degree.  Please post Fontconfig configurations with an explanation for why they were done.
  
This is a quest to get all fonts looking beautiful at all sizes, weights, etc., by tweaking the fontconfig rules. The latest version is [http://forums.gentoo.org/viewtopic-p-6183606.html#6183606 maintained here] -- brebs
+
== Hinted fonts ==
  
== Basic config with no hinting for ''italic'' or '''bold''' and some other tuning==
+
{{hc|~/.config/fontconfig/fonts.conf|<nowiki>
 +
<?xml version='1.0'?>
 +
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
 +
<fontconfig>
 +
<match target="font">
 +
<edit mode="assign" name="antialias">
 +
<bool>true</bool>
 +
</edit>
 +
<edit mode="assign" name="embeddedbitmap">
 +
<bool>false</bool>
 +
</edit>
 +
<edit mode="assign" name="hinting">
 +
<bool>true</bool>
 +
</edit>
 +
<edit mode="assign" name="hintstyle">
 +
<const>hintslight</const>
 +
</edit>
 +
<edit mode="assign" name="lcdfilter">
 +
<const>lcddefault</const>
 +
</edit>
 +
<edit mode="assign" name="rgba">
 +
<const>rgb</const>
 +
</edit>
 +
</match>
 +
</fontconfig>
 +
</nowiki>}}
 +
 
 +
== No hinting for ''italic'' or '''bold''' ==
  
 
<pre>
 
<pre>
Line 42: Line 71:
 
</pre>
 
</pre>
  
==Sharp fonts==
+
== Sharp fonts ==
It took me a while to find font settings that are sharp and not overly blurred. This font config does exactly that and seems to work fine everywhere. I searched for this because "Chromium" wasn't looking good with no aliasing at all. The below config fixes that as well.
+
  
 
  <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
 
  <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
Line 50: Line 78:
 
     <edit name="antialias" mode="assign"><bool>true</bool></edit>
 
     <edit name="antialias" mode="assign"><bool>true</bool></edit>
 
     <edit name="hinting" mode="assign"><bool>true</bool></edit>
 
     <edit name="hinting" mode="assign"><bool>true</bool></edit>
     <edit name="hintstyle" mode="assign"><const>hintfull</const></edit>
+
     <edit name="hintstyle" mode="assign"><const>hintfull</const></edit>  &lt;!-- try hintmedium if it looks bad -->
 
     <edit name="lcdfilter" mode="assign"><const>lcddefault</const></edit>
 
     <edit name="lcdfilter" mode="assign"><const>lcddefault</const></edit>
     <edit name="rgba" mode="assign"><const>rgb</const></edit>
+
     <edit name="rgba" mode="assign"><const>rgb</const></edit>            &lt;!-- set to match your display -->
 
   </match>
 
   </match>
 
  </fontconfig>
 
  </fontconfig>
 +
 +
== Enable anti-aliasing only for bigger fonts ==
 +
 +
Some users prefer the sharper rendering that anti-aliasing does not offer:
 +
 +
{{bc|<nowiki>
 +
<?xml version="1.0"?>
 +
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
 +
<fontconfig>
 +
  <match target="font">
 +
    <edit name="antialias" mode="assign">
 +
      <bool>false</bool>
 +
    </edit>
 +
  </match>
 +
 +
  <match target="font" >
 +
    <test name="size" qual="any" compare="more">
 +
      <double>12</double>
 +
    </test>
 +
    <edit name="antialias" mode="assign">
 +
      <bool>true</bool>
 +
    </edit>
 +
  </match>
 +
 +
  <match target="font" >
 +
    <test name="pixelsize" qual="any" compare="more">
 +
      <double>16</double>
 +
    </test>
 +
    <edit name="antialias" mode="assign">
 +
      <bool>true</bool>
 +
    </edit>
 +
  </match>
 +
</fontconfig>
 +
</nowiki>}}
 +
 +
== Default fonts ==
 +
 +
For font consistency, all applications should be set to use the serif, sans-serif, and monospace aliases, which are mapped to particular fonts by fontconfig. See [[Metric-compatible fonts]] for options and examples.
 +
 +
=== Japanese ===
 +
 +
Example fonts.conf which also specifies a default font for the Japanese locale (ja_JP) and keeps western style fonts for Latin letters.
 +
 +
{{bc|<nowiki>
 +
<?xml version='1.0'?>
 +
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
 +
<fontconfig>
 +
 +
<!-- Default font (no fc-match pattern) -->
 +
<match>
 +
  <edit mode="prepend" name="family">
 +
  <string>Noto Sans</string>
 +
  </edit>
 +
</match>
 +
 +
<!-- Default font for the ja_JP locale (no fc-match pattern) -->
 +
<match>
 +
  <test compare="contains" name="lang">
 +
  <string>ja</string>
 +
  </test>
 +
  <edit mode="prepend" name="family">
 +
  <string>Noto Sans CJK JP</string>
 +
  </edit>
 +
</match>
 +
 +
<!-- Default sans-serif font -->
 +
<match target="pattern">
 +
  <test qual="any" name="family"><string>sans-serif</string></test>
 +
  <!--<test qual="any" name="lang"><string>ja</string></test>-->
 +
  <edit name="family" mode="prepend" binding="same"><string>Noto Sans</string>  </edit>
 +
</match>
 +
 +
<!-- Default serif fonts -->
 +
<match target="pattern">
 +
  <test qual="any" name="family"><string>serif</string></test>
 +
  <edit name="family" mode="prepend" binding="same"><string>Noto Serif</string>  </edit>
 +
  <edit name="family" mode="append" binding="same"><string>IPAPMincho</string>  </edit>
 +
  <edit name="family" mode="append" binding="same"><string>HanaMinA</string>  </edit>
 +
</match>
 +
 +
<!-- Default monospace fonts -->
 +
<match target="pattern">
 +
  <test qual="any" name="family"><string>monospace</string></test>
 +
  <edit name="family" mode="prepend" binding="same"><string>Inconsolatazi4</string></edit>
 +
  <edit name="family" mode="append" binding="same"><string>IPAGothic</string></edit>
 +
</match>
 +
 +
<!-- Fallback fonts preference order -->
 +
<alias>
 +
  <family>sans-serif</family>
 +
  <prefer>
 +
  <family>Noto Sans</family>
 +
  <family>Open Sans</family>
 +
  <family>Droid Sans</family>
 +
  <family>Ubuntu</family>
 +
  <family>Roboto</family>
 +
  <family>NotoSansCJK</family>
 +
  <family>Source Han Sans JP</family>
 +
  <family>IPAPGothic</family>
 +
  <family>VL PGothic</family>
 +
  <family>Koruri</family>
 +
  </prefer>
 +
</alias>
 +
<alias>
 +
  <family>serif</family>
 +
  <prefer>
 +
  <family>Noto Serif</family>
 +
  <family>Droid Serif</family>
 +
  <family>Roboto Slab</family>
 +
  <family>IPAPMincho</family>
 +
  </prefer>
 +
</alias>
 +
<alias>
 +
  <family>monospace</family>
 +
  <prefer>
 +
  <family>Inconsolatazi4</family>
 +
  <family>Ubuntu Mono</family>
 +
  <family>Droid Sans Mono</family>
 +
  <family>Roboto Mono</family>
 +
  <family>IPAGothic</family>
 +
  </prefer>
 +
</alias>
 +
 +
<dir>~/.fonts</dir>
 +
</fontconfig>
 +
</nowiki>}}
 +
 +
== Patched packages ==
 +
 +
{{Warning|AUR packages are maintained separately from applications in the [[official repositories]]. The whole graphical system can become inoperable, if the user-installed core graphical libraries become incompatible.}}
 +
 +
{{Note|
 +
* Configuration is usually necessary.
 +
* The new font rendering will not be available until applications restart.
 +
* Applications which [[Wikipedia:Static library|statically link]] to a library will not be affected by the system library, or patches applied to it.
 +
}}
 +
 +
* {{App|freetype2-ubuntu|Font configuration shipped with Ubuntu. [http://bazaar.launchpad.net/~ubuntu-branches/ubuntu/wily/fontconfig/wily/files/head:/debian/patches/] [http://bazaar.launchpad.net/~ubuntu-branches/ubuntu/wily/freetype/wily/files/head:/debian/patches-freetype/]|https://launchpad.net/ubuntu/+source/freetype|{{AUR|freetype2-ubuntu}} {{AUR|fontconfig-ubuntu}}}}
 +
* {{App|[[Infinality]]|Font configuration files, patches, and scripts.|https://github.com/bohoomil/fontconfig-ultimate|{{AUR|freetype2-infinality}} {{AUR|fontconfig-infinality}}}}
 +
 +
To restore the original packages, reinstall {{Pkg|freetype2}}, {{pkg|cairo}}, and {{pkg|fontconfig}} as dependencies (use the {{ic|--asdeps}} flag with pacman when reinstalling). Include {{pkg|lib32-cairo}}, {{pkg|lib32-fontconfig}}, and {{pkg|lib32-freetype2}} if you also installed 32-bit versions.
 +
 +
== See also ==
 +
 +
* [http://forums.gentoo.org/viewtopic-p-7273876.html#7273876 Gentoo forums]

Latest revision as of 16:55, 9 August 2016

See Font configuration for the main article.

Configurations can vary to a degree. Please post Fontconfig configurations with an explanation for why they were done.

Hinted fonts

~/.config/fontconfig/fonts.conf
<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
<fontconfig>
	<match target="font">
		<edit mode="assign" name="antialias">
			<bool>true</bool>
		</edit>
		<edit mode="assign" name="embeddedbitmap">
			<bool>false</bool>
		</edit>
		<edit mode="assign" name="hinting">
			<bool>true</bool>
		</edit>
		<edit mode="assign" name="hintstyle">
			<const>hintslight</const>
		</edit>
		<edit mode="assign" name="lcdfilter">
			<const>lcddefault</const>
		</edit>
		<edit mode="assign" name="rgba">
			<const>rgb</const>
		</edit>
	</match>
</fontconfig>

No hinting for italic or bold

<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
<fontconfig>
  <match target="font" >
    <edit mode="assign" name="autohint">  <bool>true</bool></edit>
    <edit mode="assign" name="hinting">	  <bool>false</bool></edit>
    <edit mode="assign" name="lcdfilter"> <const>lcddefault</const></edit>
    <edit mode="assign" name="hintstyle"> <const>hintslight</const></edit>
    <edit mode="assign" name="antialias"> <bool>true</bool></edit>
    <edit mode="assign" name="rgba">      <const>rgb</const></edit>
  </match>

  <match target="font">
    <test name="pixelsize" qual="any" compare="more"><double>15</double></test>
    <edit mode="assign" name="lcdfilter"><const>lcdlight</const></edit>
    <edit mode="assign" name="hintstyle"><const>hintnone</const></edit>
  </match>

  <match target="font">
    <test name="weight" compare="more"><const>medium</const></test>
    <edit mode="assign" name="hintstyle"><const>hintnone</const></edit>
    <edit mode="assign" name="lcdfilter"><const>lcdlight</const></edit>
  </match>

  <match target="font">
    <test name="slant"  compare="not_eq"><double>0</double></test>
    <edit mode="assign" name="hintstyle"><const>hintnone</const></edit>
    <edit mode="assign" name="lcdfilter"><const>lcdlight</const></edit>
  </match>

</fontconfig>

Sharp fonts

<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <match target="font">
    <edit name="antialias" mode="assign"><bool>true</bool></edit>
    <edit name="hinting" mode="assign"><bool>true</bool></edit>
    <edit name="hintstyle" mode="assign"><const>hintfull</const></edit>   <!-- try hintmedium if it looks bad -->
    <edit name="lcdfilter" mode="assign"><const>lcddefault</const></edit>
    <edit name="rgba" mode="assign"><const>rgb</const></edit>             <!-- set to match your display -->
  </match>
</fontconfig>

Enable anti-aliasing only for bigger fonts

Some users prefer the sharper rendering that anti-aliasing does not offer:

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <match target="font">
    <edit name="antialias" mode="assign">
      <bool>false</bool>
    </edit>
  </match>

  <match target="font" >
    <test name="size" qual="any" compare="more">
      <double>12</double>
    </test>
    <edit name="antialias" mode="assign">
      <bool>true</bool>
    </edit>
  </match>

  <match target="font" >
    <test name="pixelsize" qual="any" compare="more">
      <double>16</double>
    </test>
    <edit name="antialias" mode="assign">
      <bool>true</bool>
    </edit>
  </match>
</fontconfig>

Default fonts

For font consistency, all applications should be set to use the serif, sans-serif, and monospace aliases, which are mapped to particular fonts by fontconfig. See Metric-compatible fonts for options and examples.

Japanese

Example fonts.conf which also specifies a default font for the Japanese locale (ja_JP) and keeps western style fonts for Latin letters.

<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
<fontconfig>

<!-- Default font (no fc-match pattern) -->
 <match>
  <edit mode="prepend" name="family">
   <string>Noto Sans</string>
  </edit>
 </match>

<!-- Default font for the ja_JP locale (no fc-match pattern) -->
 <match>
  <test compare="contains" name="lang">
   <string>ja</string>
  </test>
  <edit mode="prepend" name="family">
   <string>Noto Sans CJK JP</string>
  </edit>
 </match>

<!-- Default sans-serif font -->
 <match target="pattern">
   <test qual="any" name="family"><string>sans-serif</string></test>
   <!--<test qual="any" name="lang"><string>ja</string></test>-->
   <edit name="family" mode="prepend" binding="same"><string>Noto Sans</string>  </edit>
 </match>
 
<!-- Default serif fonts -->
 <match target="pattern">
   <test qual="any" name="family"><string>serif</string></test>
   <edit name="family" mode="prepend" binding="same"><string>Noto Serif</string>  </edit>
   <edit name="family" mode="append" binding="same"><string>IPAPMincho</string>  </edit>
   <edit name="family" mode="append" binding="same"><string>HanaMinA</string>  </edit>
 </match>

<!-- Default monospace fonts -->
 <match target="pattern">
   <test qual="any" name="family"><string>monospace</string></test>
   <edit name="family" mode="prepend" binding="same"><string>Inconsolatazi4</string></edit>
   <edit name="family" mode="append" binding="same"><string>IPAGothic</string></edit>
 </match>

<!-- Fallback fonts preference order -->
 <alias>
  <family>sans-serif</family>
  <prefer>
   <family>Noto Sans</family>
   <family>Open Sans</family>
   <family>Droid Sans</family>
   <family>Ubuntu</family>
   <family>Roboto</family>
   <family>NotoSansCJK</family>
   <family>Source Han Sans JP</family>
   <family>IPAPGothic</family>
   <family>VL PGothic</family>
   <family>Koruri</family>
  </prefer>
 </alias>
 <alias>
  <family>serif</family>
  <prefer>
   <family>Noto Serif</family>
   <family>Droid Serif</family>
   <family>Roboto Slab</family>
   <family>IPAPMincho</family>
  </prefer>
 </alias>
 <alias>
  <family>monospace</family>
  <prefer>
   <family>Inconsolatazi4</family>
   <family>Ubuntu Mono</family>
   <family>Droid Sans Mono</family>
   <family>Roboto Mono</family>
   <family>IPAGothic</family>
  </prefer>
 </alias>

 <dir>~/.fonts</dir>
</fontconfig>

Patched packages

Warning: AUR packages are maintained separately from applications in the official repositories. The whole graphical system can become inoperable, if the user-installed core graphical libraries become incompatible.
Note:
  • Configuration is usually necessary.
  • The new font rendering will not be available until applications restart.
  • Applications which statically link to a library will not be affected by the system library, or patches applied to it.
  • freetype2-ubuntu — Font configuration shipped with Ubuntu. [1] [2]
https://launchpad.net/ubuntu/+source/freetype || freetype2-ubuntuAUR fontconfig-ubuntuAUR
  • Infinality — Font configuration files, patches, and scripts.
https://github.com/bohoomil/fontconfig-ultimate || freetype2-infinalityAUR fontconfig-infinalityAUR

To restore the original packages, reinstall freetype2, cairo, and fontconfig as dependencies (use the --asdeps flag with pacman when reinstalling). Include lib32-cairo, lib32-fontconfig, and lib32-freetype2 if you also installed 32-bit versions.

See also