Add new tdefontview help handbook.

5 files changed, 127 insertions, 0 deletions

diff --git a/doc/tdefontview/CMakeLists.txt b/doc/tdefontview/CMakeLists.txt
new file mode 100644
index 000000000..5b510531e
--- /dev/null
+++ b/doc/tdefontview/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdefontview )
diff --git a/doc/tdefontview/Makefile.am b/doc/tdefontview/Makefile.am
new file mode 100644
index 000000000..967880cdb
--- /dev/null
+++ b/doc/tdefontview/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdefontview
diff --git a/doc/tdefontview/index.docbook b/doc/tdefontview/index.docbook
new file mode 100644
index 000000000..df7fb9f43
--- /dev/null
+++ b/doc/tdefontview/index.docbook
@@ -0,0 +1,115 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY tdefontview "<application>TDEFontview</application>">
+  <!ENTITY kappname "&tdefontview;">
+  <!ENTITY package "tdebase">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+]>
+
+<article id="tdefontview" lang="&language;">
+
+<articleinfo>
+
+<title>Font Viewer</title>
+<authorgroup>
+<author><firstname>Burkhard</firstname><surname>Lück</surname></author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>2010</year>
+<holder>Burkhard Lück</holder>
+</copyright>
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>fontview</keyword>
+<keyword>fonts</keyword>
+</keywordset>
+
+</articleinfo>
+
+<para>
+&tdefontview; is an application to view and install different types of fonts:
+<itemizedlist>
+<listitem><para>TrueType (<filename class="extension">.ttf</filename>)</para></listitem>
+<listitem><para>OpenType (<filename class="extension">otf</filename>, <filename class="extension">.ttf</filename>)</para></listitem>
+<listitem><para>Postscript type 1 (file extension on &Windows; &amp; OS/2 <filename class="extension">.pfb</filename>/<filename class="extension">.pfm</filename>; on &UNIX;/&Linux; <filename class="extension">.pfa</filename>/<filename class="extension">.afm</filename>)</para></listitem> 
+<listitem><para>BDF (Bitmap Distribution Format, file extension <filename class="extension">.bdf</filename>)</para></listitem> 
+<listitem><para>PCF (Portable Compiled Format, file extension <filename class="extension">.pcf</filename>)</para></listitem>
+</itemizedlist>
+</para>
+<para>You can use it as standalone program to preview and install a font 
+downloaded from the Internet. In the preview you can check that the font 
+has all characters you need.
+</para>
+<para>
+Additionally &tdefontview; can be launched from 
+the &kcontrol; module <ulink url="help:/kcontrol/fontinst/index.html">
+<guilabel>Font Installer</guilabel></ulink> to use the extended preview capabilities
+of &tdefontview;.</para>
+<para>To use &tdefontview; in &konqueror; select <guilabel>Services</guilabel> in
+the sidebar and go to the folders <filename class="directory">Fonts/Personal
+</filename> or <filename class="directory">Fonts/System</filename>.
+Then open the context menu with a &RMB; click on a font and start &tdefontview; 
+by selecting it from the context menu.</para>
+<!-- used by others as well? -->
+
+<para>
+<screenshot>
+<screeninfo>&tdefontview; application</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="tdefontview.png" format="PNG"/>
+    </imageobject>
+    <textobject>
+      <phrase>&tdefontview; application</phrase>
+    </textobject>
+  </mediaobject>
+</screenshot>
+</para>
+
+<!--<para>
+&tdefontview;'s <guilabel>Standard Preview</guilabel> displays your font in several
+different sizes, so you can get a good idea of what it will look like.
+From the drop down box in the toolbar you can choose additional preview types:
+<itemizedlist>
+<listitem><para>All Characters</para></listitem>
+<listitem><para>Unicode Block: The Unicode standard arranges groups of characters
+together in blocks</para></listitem>
+<listitem><para>Unicode Script: In Unicode, a script is a collection of letters
+and other written signs used to represent textual information in one or more
+writing systems</para></listitem>
+<listitem><para>Change Text: Using this button opens the <guilabel>Preview 
+String</guilabel> dialog where you can insert a user defined text.
+This feature enables you to check that a font supports the characters you need.
+</para></listitem>
+</itemizedlist></para>-->
+
+<!--<para>In <guilabel>Unicode Block</guilabel> and <guilabel>Unicode Script</guilabel>
+preview mode additional tooltip info's are displayed hovering a character with the
+mouse pointer:
+The character's Unicode <guilabel>Category</guilabel> and the value in <guilabel>
+UCS-4</guilabel>, <guilabel>UTF-16</guilabel>, <guilabel>UTF-8</guilabel> and
+as <guilabel>XML Decimal Entity</guilabel>.</para>-->
+
+<!-- <para> -->
+<!-- To install a font you downloaded from the Internet, click the <guibutton>Install -->
+<!-- </guibutton> button in the lower-right corner. -->
+<!--System / personal fonts?-->
+<!-- </para> -->
+
+<!-- para>
+zipped fonts and ark?
+</para-->
+
+</article>
diff --git a/doc/tdefontview/tdefontview.png b/doc/tdefontview/tdefontview.png
new file mode 100644
index 000000000..3f4c8adb3
--- /dev/null
+++ b/doc/tdefontview/tdefontview.png
diff --git a/kcontrol/tdefontinst/viewpart/tdefontview.desktop b/kcontrol/tdefontinst/viewpart/tdefontview.desktop
index 3e52511b5..81d82cf4d 100644
--- a/kcontrol/tdefontinst/viewpart/tdefontview.desktop
+++ b/kcontrol/tdefontinst/viewpart/tdefontview.desktop
@@ -98,3 +98,4 @@ GenericName[zh_TW]=字型檢視器
 Terminal=false
 InitialPreference=1
 Categories=Qt;TDE;Graphics;
+DocPath=tdefontview/index.html