<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<article lang="&language;">
<title>Font Installer</title>
<articleinfo>
<authorgroup>
<author>&Craig.Drummond; &Craig.Drummond.Mail;</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2009-11-20</date>
<releaseinfo>&kde; 4.4</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>Systemsettings</keyword>
<keyword>fonts</keyword>
</keywordset>
</articleinfo>

<sect1 id="fontinst">
<title>Font Installer</title>

<para>This module is responsible for installing, un-installing, previewing and managing your fonts.</para>

<sect2 id="font-groups">
<title>Font Groups</title>
<para>There are 4 special pre-defined font groups:</para>

<orderedlist>
    <listitem><para><quote>All Fonts</quote> This will display all fonts, both personal and system-wide.</para></listitem>
    <listitem><para><quote>Personal Fonts</quote> The fonts shown will be your personal fonts, and will not be available to other users.</para></listitem>
    <listitem><para><quote>System Fonts</quote> The fonts shown will be those available to all users. Installing a font system-wide, or removing a system-wide font, will require administrator privileges.</para></listitem>
    <listitem><para><quote>Unclassified</quote> This will list all fonts that have not been placed into any user-defined groups.</para></listitem>
</orderedlist>
<para>To add a font to a group, drag it from the list of fonts onto a group. To remove a font from a group, drag the font onto the <quote>All Fonts</quote> group.</para>
<para>Below this list you find buttons to create a new group, remove a group and enable or disable the fonts in the current group.</para>
<para>In the context menu of this list you have additional menuitems to print font samples and export a font to a zip archive.</para>

<sect3 id="font-hiding">
<title>Enabling and Disabling</title>
<para>Users with many fonts may find it useful to only have certain fonts enabled (or active) at certain times. To facilitate this, this module will allow you to disable individual fonts, or whole groups of fonts. Disabling a font does not remove the font from the system, it simply hides it so that it no longer appears within applications. Re-enabling a font will then allow it to be used.</para>
</sect3>

<sect3 id="font-duplicates">
<title>Duplicate Fonts</title>
<para>If you have lots of fonts installed on your system it is possible that you may have duplicates.</para> 
<para>Click on the tools icon above the group list and select the <guilabel>Scan For Duplicate Fonts...</guilabel> tool, a simple tool that will scan your system looking for fonts that have multiple files associated with them. For example, if you have <quote>times.ttf</quote> and <quote>times.TTF</quote> installed in <quote>/usr/local/share/fonts</quote> the underlying font mechanism (called <quote>FontConfig</quote>) will only see one of these. So, if you un-installed the font, it would re-appear, as only one of the files would have been removed. Running this tool will produce a dialog listing each font that has multiple files, and the corresponding list of files. To select a file for deletion, click on the column containing the trash can icon.</para>
</sect3>

<sect3 id="font-filter">
<title>Font Filtering</title>
<para>A text field on top of the font preview allows you to filter the list of fonts. You can filter fonts based upon different categories:</para>
        <orderedlist>
        <listitem><para>Family.</para></listitem>
        <listitem><para>Style.</para></listitem>
        <listitem><para>FontConfig match. This allows you to enter a family name, and see the family that fontconfig would actually use.</para></listitem>
        <listitem><para>Font file.</para></listitem>
        <listitem><para>Font file location.</para></listitem>
        <listitem><para>Writing system.</para></listitem>
        </orderedlist>
</sect3>

</sect2>

<sect2 id="font-list">
<title>Font</title>
<para>
The main display is a list of the installed fonts, grouped via the fonts' family name - the number in square brackets represents the number of installed styles for that family. e.g. The <quote>Times</quote> font may be listed as:
<itemizedlist>
<listitem>
    <para>Times [4]</para>
    <itemizedlist>
        <listitem><para>Regular</para></listitem>
        <listitem><para>Italic</para></listitem>
        <listitem><para>Bold</para></listitem>
        <listitem><para>Bold Italic</para></listitem>
    </itemizedlist>
</listitem>
</itemizedlist>
</para>

<para>To install a font, press the <guibutton>Add...</guibutton> button, and select the desired fonts from within the file dialog. The selected font group will control where the fonts will be installed.</para>
<para>To un-install fonts, select the appropriate fonts from the list, and press the <guibutton>Delete...</guibutton> button.</para>

<para>Click with the &RMB; to open a context menu with some additional actions like <guilabel>Enable</guilabel>, <guilabel>Disable</guilabel>, <guilabel>Print</guilabel>, <ulink url="help:/kfontviewer/index.html"><guilabel>Open in Font Viewer</guilabel></ulink> and <guilabel>Reload</guilabel>.</para>

</sect2>

<sect2 id="font-preview">
<title>Preview</title>
<para>This displays a preview text in different font sizes.</para>
<para>Using the context menu enables you to zoom in and out, select a preview type (<guilabel>Standard Preview</guilabel> or <guilabel>All Characters</guilabel>) and change the preview text.</para>
</sect2>
</sect1>
</article>