summaryrefslogtreecommitdiffstats
path: root/doc/kcontrol
diff options
context:
space:
mode:
authorMichele Calgaro <[email protected]>2014-01-27 21:36:37 -0600
committerDarrell Anderson <[email protected]>2014-01-27 21:36:37 -0600
commit1916de86decb3b710a360dd18184fb1acd21c04a (patch)
treef2be4561057e308c1d71a708bcdcb3ea697ed69d /doc/kcontrol
parent86456cf8a94dc3cbae918f1cabad1be8865ca464 (diff)
downloadtdebase-1916de86decb3b710a360dd18184fb1acd21c04a.tar.gz
tdebase-1916de86decb3b710a360dd18184fb1acd21c04a.zip
Add new kcontrol theme manager help handbook.
This resolves bug report 1847.
Diffstat (limited to 'doc/kcontrol')
-rw-r--r--doc/kcontrol/kthememanager/index.docbook122
1 files changed, 95 insertions, 27 deletions
diff --git a/doc/kcontrol/kthememanager/index.docbook b/doc/kcontrol/kthememanager/index.docbook
index 5feda9388..d9525a528 100644
--- a/doc/kcontrol/kthememanager/index.docbook
+++ b/doc/kcontrol/kthememanager/index.docbook
@@ -1,60 +1,128 @@
<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE">
]>
-<!-- Note: When updating this empty handbook, remember that usually most handbooks -->
-<!-- use the book model rather than article. Feel free to use article if the new handbook -->
-<!-- remains really short. -->
-
<article lang="&language;">
-<title>Theme Manager</title>
<articleinfo>
+<title>Theme Manager</title>
<authorgroup>
-<corpauthor>&tde-team;</corpauthor>
+<author>
+<firstname>Andrew</firstname>
+<surname>Lake</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>Andrew Lake</holder>
+</copyright>
<copyright>
<year>&tde-copyright-date;</year>
<holder>&tde-team;</holder>
</copyright>
-<abstract>
-<para>
-This handbook describes the Theme Manager.
-</para>
-</abstract>
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
<keywordset>
<keyword>TDE</keyword>
+<keyword>System Settings</keyword>
+<keyword>desktop</keyword>
+<keyword>theme</keyword>
</keywordset>
</articleinfo>
-<sect1 id="apologies">
-<title>We Apologize</title>
-<para>No documentation has yet been written for this module.</para>
+<sect1 id="thememanager">
+<title>Theme Manager</title>
+
+<sect2 id="thememanager-introduction">
+<title>Introduction</title>
+
+<para>Use this module to customize your desktop theme and to replace theme items
+with items from other themes or from files.</para>
+
+<para>A &tde; desktop theme uses several components or items. Desktop theme components
+include the background, colors, widget style, icons, fonts, and the screen saver.</para>
+
+<para>This module supports four basic functions: 1) applying themes, 2) installing themes,
+3) creating new themes, and 4) removing themes.</para>
+
+</sect2>
+
+<sect2 id="thememanager-applytheme">
+<title>Apply A Theme</title>
+
+<para>In the <guibutton>Themes</guibutton> list box on the left is a list of premade
+themes currently available on your computer. Use different themes by selecting themes
+in the list and then selecting the <guibutton>Apply</guibutton> button.</para>
+
+<para>When selecting a theme, a preview image will appear to the right of the list.</para>
+
+<warning><para>Testing and creating new themes is fun but do know that themes are comprehensive
+changes to the desktop. When applying a new theme, many related options are not restored
+when reverting to the previous theme. Generally this is not important to many users who
+accept all components of a theme, but to those who like to customize the desktop using
+individual features, installing new themes will override many desktop customizations.
+To avoid this result requires 1) saving the existing settings as a new theme, 2) manually
+configuring and testing each setting one at a time, or 3) using a backup copy of your Trinity
+profile directory ($TDEHOME, normally $HOME/.trinity).</para></warning>
+
+<para>Select the <guibutton>Apply</guibutton> button to make the selection permanent.</para>
+
+</sect2>
+
+<sect2 id="thememanager-installnewtheme">
+<title>Install A Theme</title>
+
+<para>Use the <guilabel>Get new themes...</guilabel> link in the top right corner to download
+additional themes from the Internet.</para>
+
+<para>Use the <guibutton>Install New Theme...</guibutton> button to install new themes
+downloaded or copied to your computer but not yet seen in the Themes list box. Using this
+option installs themes to your user profile directory. After installing the theme then will
+be listed in the <guibutton>Themes</guibutton> list box.</para>
+
+<note><para>Using the link only downloads the themes to your computer. Use the <guibutton>Install New Theme...</guibutton> button to install the themes to your user profile directory ($TDEHOME).</para></note>
+
+<para>When the new themes are in the <guibutton>Themes</guibutton> list box, select the theme and
+then select the <guibutton>Apply</guibutton> button to make the selection permanent.</para>
+
+</sect2>
+
+<sect2 id="thememanager-createnewtheme">
+<title>Create A New Theme</title>
+
+<para>From the <guibutton>Themes</guibutton> list box, select a theme to be used as a base theme.</para>
+
+<para>Next use the <guibutton>Create New Theme...</guibutton> button to provide the new theme a name.</para>
+
+<para>Then use the big buttons at the bottom of the module to customize the items you want to change.
+You can change the background, colors, widget style, icons, fonts, and the screen saver.</para>
+
+<para>After creating your new masterpiece, select the <guibutton>Apply</guibutton>
+button to make the selection permanent.</para>
+
+</sect2>
+
+<sect2 id="thememanager-removetheme">
+<title>Remove A Theme</title>
-<para>If you need help, please check <ulink url="http://www.trinitydesktop.org">The &tde;
-web site</ulink>, submit questions to the <ulink url="http://www.trinitydesktop.org/mailinglist.php">
-&tde; mail lists</ulink>, or file a bug report at the <ulink url="http://bugs.trinitydesktop.org/">
-&tde; bug tracker</ulink>.</para>
+<para>From the <guibutton>Themes</guibutton> list box, select a custom theme to remove.</para>
-<para>If you are interested in helping, please consider writing the help file.
-Submitting a basic text file is acceptable as the &tde-team; will convert the text.</para>
+<note><para>The default system themes installed with &tde; cannot be removed.</para></note>
-<para>Thank you for helping and thank you for your patience.</para>
+<para>When the theme is selected the <guibutton>Remove Theme</guibutton>
+button will be enabled. Select the <guibutton>Remove Theme</guibutton> button. A confirmation dialog appears. Select the <guibutton>OK</guibutton> button.</para>
-&underFDL;
+</sect2>
</sect1>
-&documentation.index;
</article>