summaryrefslogtreecommitdiffstats
path: root/gnome2-system-admin-guide/C/fontconfig.xml
diff options
context:
space:
mode:
Diffstat (limited to 'gnome2-system-admin-guide/C/fontconfig.xml')
-rw-r--r--gnome2-system-admin-guide/C/fontconfig.xml101
1 files changed, 101 insertions, 0 deletions
diff --git a/gnome2-system-admin-guide/C/fontconfig.xml b/gnome2-system-admin-guide/C/fontconfig.xml
new file mode 100644
index 0000000..0bd3f58
--- /dev/null
+++ b/gnome2-system-admin-guide/C/fontconfig.xml
@@ -0,0 +1,101 @@
+<chapter id="fontconfig-0">
+ <title>Configuring Fonts</title>
+ <highlights>
+ <para>This chapter describes how to configure fonts in the GNOME
+Desktop.</para>
+ </highlights>
+ <sect1 id="fontconfig-1">
+ <title>Introduction to Configuring Fonts</title>
+ <indexterm>
+ <primary>configuring fonts</primary>
+ <see>fonts</see>
+ </indexterm>
+ <indexterm>
+ <primary>fontconfig</primary>
+ <see>fonts</see>
+ </indexterm>
+ <indexterm>
+ <primary>fonts</primary>
+ <secondary>introduction</secondary>
+ </indexterm>
+ <para>GNOME Desktop uses the <literal>fontconfig</literal> font configuration and
+customization library. The <literal>fontconfig</literal> library can use all
+kinds of fonts, including PostScript Type 1 fonts and TrueType fonts.</para>
+ <para>The <literal>fontconfig</literal> library provides a list of all the
+fonts available on a GNOME Desktop system. To compile this list, <literal>fontconfig</literal> searches the directories listed in the <filename>/etc/fonts/fonts.conf</filename> file. To view all the fonts available on a system, access the <literal>fonts:///</literal> location in the file manager on the system.</para>
+ <para>For more information about the <literal>fontconfig</literal> library,
+see the following URL: </para>
+ <literallayout>
+ <ulink url="http://freedesktop.org/software/fontconfig">http://freedesktop.org/software/fontconfig</ulink>
+ </literallayout>
+ </sect1>
+ <sect1 id="fontconfig-4">
+ <title>Font Substitution</title>
+ <indexterm>
+ <primary>fonts</primary>
+ <secondary>substitution</secondary>
+ </indexterm>
+ <para>The <literal>fontconfig</literal> library performs font substitution
+when either entire fonts, or individual characters, are not present. If the
+system needs to display a font that is not available, <literal>fontconfig</literal> attempts to display another, similar font. For example, if a web
+page requests to display the Verdana font, and that font is not installed
+on the system, <literal>fontconfig</literal> displays a similar font, such
+as Helvetica. The list of similar fonts is defined in the <filename>/etc/fonts/fonts.conf</filename> file. </para>
+ <para>If the system needs to display a character that is not present in the
+selected font, <literal>fontconfig</literal> attempts to display the character
+in another, similar font. For example, you might select Bitstream Vera Sans
+as the font for the Text Editor application. The Bitstream Vera font family
+does not include Cyrillic characters. If you open a document which contains
+a Cyrillic character, Text Editor uses a similar font that includes Cyrillic
+characters to display the character.</para>
+ <para>The <literal>fontconfig</literal> library also defines aliases for fonts,
+for example, <literal>serif</literal>, <literal>sans-serif</literal>, and <literal>monospace</literal>. When you select one of the aliases for a font, the system
+uses the first font that is defined for that alias in the <filename>/etc/fonts/fonts.conf</filename>. </para>
+ </sect1>
+ <sect1 id="fontconfig-2">
+ <title>To Add a Font for All Users</title>
+ <indexterm>
+ <primary>fonts</primary>
+ <secondary>adding for all users</secondary>
+ </indexterm>
+ <para>To add a font for all users, perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Copy the font file to one of the directories in the <filename>/etc/fonts/fonts.conf</filename> file. Typically, fonts are stored in the <filename>/usr/share/fonts/</filename> directory.</para>
+ </listitem>
+ <listitem>
+ <para>The <literal>fontconfig</literal> library updates the list
+of fonts automatically. If the list of fonts is not updated, run the following
+command:</para>
+ <para>
+ <computeroutput>#</computeroutput>
+ <userinput>fc-cache <replaceable>directory-name</replaceable></userinput>
+ </para>
+ </listitem>
+ </orderedlist>
+ </sect1>
+ <sect1 id="fontconfig-3">
+ <title>To Add a Font for an Individual User</title>
+ <indexterm>
+ <primary>fonts</primary>
+ <secondary>adding for individual users</secondary>
+ </indexterm>
+ <para>To add a font for an individual users, perform
+the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Copy the font file to the <filename>$HOME/.fonts</filename>
+directory of the user. If you drag the font file to the <literal>fonts:///</literal> location in the file manager, the font file is copied to the <filename>$HOME/.fonts</filename> directory.</para>
+ </listitem>
+ <listitem>
+ <para>The <literal>fontconfig</literal> library updates the list
+of fonts automatically. If the list of fonts is not updated, run the following
+command:</para>
+ <para>
+ <computeroutput>#</computeroutput>
+ <userinput>fc-cache <replaceable>directory-name</replaceable></userinput>
+ </para>
+ </listitem>
+ </orderedlist>
+ </sect1>
+</chapter>