diff options
author | Michele Calgaro <[email protected]> | 2014-01-27 21:36:37 -0600 |
---|---|---|
committer | Darrell Anderson <[email protected]> | 2014-01-27 21:36:37 -0600 |
commit | 1916de86decb3b710a360dd18184fb1acd21c04a (patch) | |
tree | f2be4561057e308c1d71a708bcdcb3ea697ed69d /doc/kcontrol | |
parent | 86456cf8a94dc3cbae918f1cabad1be8865ca464 (diff) | |
download | tdebase-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.docbook | 122 |
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> |