1 files changed, 0 insertions, 347 deletions
diff --git a/doc/userguide/customizing-desktop.docbook b/doc/userguide/customizing-desktop.docbook
deleted file mode 100644
index a8ed7cb42..000000000
--- a/doc/userguide/customizing-desktop.docbook
+++ /dev/null
@@ -1,347 +0,0 @@
-<chapter id="customizing-desktop">
-<chapterinfo>
-<authorgroup>
-<author>
-<firstname>Juan Carlos</firstname>
-<surname>Torres</surname>
-</author>
-</authorgroup>
-</chapterinfo>
-
-<title>Customizing the Appearance of your &tde; Desktop</title>
-
-<para>Changing the appearance of your &tde; desktop can be done quite easily and
-flexibly by either individually controlling different parts of the visual
-appearance or by using a predefined theme. This guide explains the various
-customizable parts of &tde; and how to control their appearance.</para>
-
-<sect1 id="background">
-<title>Background</title>
-<para>The desktop background, more commonly known as the wallpaper, allows you
-to display certain images on your desktop. The settings for the background are
-found in the &kcontrolcenter;, or by <mousebutton>right</mousebutton>-clicking
-on the desktop and selecting <guilabel>Configure Desktop...</guilabel>.</para>
-
-<para>In &tde;, you have the option to use no picture, a single picture, or a
-slideshow of images. If <guilabel>No picture</guilabel> is chosen to be the
-desktop background, the <guilabel>Colors</guilabel> options are used instead.
-You can also choose whether to use a single
-background on all virtual desktops or to apply a different background for each
-desktop. This is done by selecting <guilabel>All desktops</guilabel> or the
-specific desktop name from the drop-down menu.</para>
-
-<para>Other background images can be downloaded using the
-<guibutton>Get New Wallpapers</guibutton> button on the right or you can visit
-the <ulink url="http://www.kde-look.org/index.php?xcontentmode=1x2x3x4x5x6x7">
-Wallpapers section</ulink> of the kde-look.org website.</para>
-</sect1>
-
-<sect1 id="colors">
-<title>Colors</title>
-<para>The <guilabel>Colors</guilabel> settings of the &kcontrolcenter; allow you to control the
-colors that are used for various window elements, such as window titlebars,
-window backgrounds, text, and buttons. You can change the color of each window
-element by selecting the element from the drop down list and choosing a color
-for it. You can then save your changes by clicking on
-<guibutton>Save Scheme...</guibutton>. This will save your settings in a Color
-Scheme file. Color schemes are text files, with a <literal
-role="extension">.kcsrc</literal> extension, that contain
-entries for each window widget and its color, in RGB format. It is also very
-easy to add color schemes that you have downloaded by clicking on
-<guibutton>Import Scheme...</guibutton> and pointing to the <literal
-role="extension">.kcsrc</literal> file. With color schemes, you can save the
-changes you have done in one convenient file or easily change to a predefined
-color setting, without having to change each window element separately.</para>
-
-<para>Additional color schemes can be downloaded from <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=28">the Color Schemes
-section</ulink> of kde-look.org.</para>
-</sect1>
-
-<sect1 id="icons">
-<title>Icons</title>
-<para>An icon theme contains the images used to represent actions, files,
-devices, and applications. Managing icon themes is easily done through the Icons
-module in the &kcontrolcenter;. Simply select the icon theme you want to use and
-click on <guibutton>Apply</guibutton> to switch to the new theme. To install new
-icon themes, all you need to do is to click on <guibutton>Install New
-Theme...</guibutton> and browse to the location of the icon theme archive. There
-is no need to extract the contents of the archive into a directory. In fact, the
-Icons module only accepts archived icon themes. To remove an icon theme, simply
-select the theme from the list and click on <guibutton>Remove Theme</guibutton>.
-Note that you cannot remove the icon theme that you are currently using. You
-need to switch to some other theme before the current one will become removable.
-You also cannot remove icon themes that were installed by the administrator
-(<systemitem class="username">root</systemitem>) or by your distribution's
-package manager.</para>
-<para>Other icon themes can be found in <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=27">the Icon Themes
-subsection</ulink> of kde-look.org.</para>
-</sect1>
-
-<sect1 id="splash-screen">
-<title>Splash Screen</title>
-
-<mediaobject>
-<imageobject>
-<imagedata fileref="splash-screen.png" format="PNG" />
-</imageobject>
-<textobject><phrase>The default &tde; splash screen</phrase></textobject>
-<caption><para>The default &tde; splash screen</para></caption>
-</mediaobject>
-
-<para>The splash screen is the animated image or screen that is displayed while
-&tde; loads after you log in. Each user can have a different splash screen.
-Changing the splash screen for the current user can be done in the Splash
-Screen module of the &kcontrolcenter;. Select the splash screen you want to
-use and click on <guibutton>Apply</guibutton>. You can also test what a splash
-screen will look like by selecting the splash screen and clicking on
-<guibutton>Test</guibutton>. Installing a new splash theme is very easy. Just
-click on <guibutton>Add...</guibutton> and browse to the splash screen archive you
-want to add. There is no need to extract the contents of the archive. Removing
-splash screens is also easily done by selecting the splash screen and clicking
-on <guibutton>Remove</guibutton>. Note that you cannot remove splash screens
-installed by the administrator (<systemitem class="username">root</systemitem>)
-or by your distribution's package manager.</para>
-
-<para>Splash screen themes can be found on kde-look.org, in <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=35">the Splash Screens
-section</ulink>. Take note that some splash screens require a specific &ksplash;
-engine to be installed.</para>
-</sect1>
-
-<sect1 id="win-deco">
-<title>Window Decorations</title>
-<para>You can change the appearance of window borders, titlebars and buttons in
-&tde; using window decorations. Some window decorations even have the capability
-to apply effects such as translucency. Window decorations must be able to do all
-these without sacrificing speed and performance. This is the reason why window
-decorations come in source code that must be compiled, or as binary packages
-that must be installed. Basically, Window decorations are plugins or small
-programs that instruct &twin;, &tde;'s Window Manager,
-how to display window frames.</para>
-
-<para>In order to add a new window decoration, you need to compile it from
-source code. If a binary package for your distribution or system is provided,
-you simply need to install it using your distribution's package manager. Please
-refer to your distribution's manual for instructions on how to do this. Once the
-window decoration has been installed, it can be accessed in the Window
-Decorations settings in the &kcontrolcenter;. In the
-<guilabel>Window Decoration</guilabel> tab,
-a list of installed window decorations can be seen in the drop down box. Simply
-select the decoration you want to use and click on <guibutton>Apply</guibutton>.
-Different window decorations have different capabilities and settings. Play
-around with the different options available. The <guilabel>Buttons</guilabel> tab allows you to
-control the buttons on the window titlebar. Enable the <guilabel>Use custom
-titlebar button positions</guilabel> check box in order to rearrange, remove, or
-add buttons. To add buttons to the titlebar, drag an item from the list to the
-titlebar preview above it. To remove a button, drag the button from the titlebar
-preview to the item list. Simply drag buttons in the titlebar preview to
-rearrange them.</para>
-
-<para>While all window decorations need to be compiled from source code, some
-window decorations can load pixmap-based theme files that do not need to be
-compiled. &tde; ships with a pixmap-based window decoration called the IceWM
-window decoration. Another pixmap-based window decoration is <ulink
-url="http://www.kde-look.org/content/show.php?content=31447">deKorator</ulink>,
-which can be found on kde-look.org. Please refer to your distribution's
-documentation on how to install these. The advantage of using pixmap-based
-window decorations is it is relatively easy to make themes for them, by using
-images and editing a configuration file. The tradeoff is a slight loss of performance,
-while this may be unnoticeable on very fast systems.</para>
-
-<para>To add an IceWM theme, select IceWM as the window decoration and click on
-the <guilabel>Open &tde;'s IceWM theme folder</guilabel> link in the window
-decoration description area. This will open a &konqueror; window
-to <filename>$<envar>TDEHOME</envar>/share/apps/twin/icewm-themes</filename>.
-Extract your IceWM theme to this folder. The theme will then be added to
-the list of IceWM themes. Select the theme you want to use and click on
-<guibutton>Apply</guibutton>.</para>
-
-<para>To add a deKorator theme after you've installed deKorator, select
-deKorator from the window decorations list and go to the <guilabel>Themes</guilabel>
-tab. Click on <guibutton>Install New Theme</guibutton> and locate
-your deKorator theme archive. Make sure that the version of the deKorator theme
-matches the deKorator version installed on your system. Once the theme has been
-added, select the theme you want to use and click on <guibutton>Set Theme
-Paths</guibutton>. Click on <guibutton>Apply</guibutton> for the changes to
-take effect.</para>
-
-<para>Some more window decorations are available at kde-look.org under <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=17">the
-Native &tde; 3.x</ulink> and <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=20">the
-Native &tde; 3.2+</ulink> subsections. Themes for the <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=18">IceWM</ulink> and
-<ulink
-url="http://www.kde-look.org/index.php?xcontentmode=21">deKorator</ulink> window
-decorations have their own subsections under the Window Decorations
-category.</para>
-</sect1>
-
-<sect1 id="style">
-<title>Style</title>
-<para>Widgets are the basic elements of a graphical user interface, such as
-buttons, scrollbars, tabs, and menus. A widget style is a plugin or a small
-program that instructs &tde; how widgets are displayed. Since widgets are the
-very basic parts of an interface, they are frequently accessed and must be able
-to respond very quickly. This is why widget styles must come as source code to
-be compiled or as binary packages to be installed, just like window decorations.
-Please refer to your distribution's documentation on how to compile from source
-or install binary packages.</para>
-
-<para>Once a widget style has been installed, it will be added to the list of
-available styles in the <guilabel>Style</guilabel> module in the &kcontrolcenter;.
-The <guilabel>Style</guilabel> tab allows
-you to select a widget style from the list and to configure it if the style has
-a <guibutton>Configure...</guibutton> feature. Different styles have different options. A preview of the
-selected style is available at the lower portion of the tab. The
-<guilabel>Effects</guilabel> tab
-controls different visual effects for some widgets like comboboxes and tooltips.
-The <guilabel>Toolbar</guilabel> tab gives some options on the general appearance of toolbars.</para>
-
-<para>Additional widget styles can be found in <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=
-8x9x10x11x12x13x14x15x16">the different &tde; subsections of the
-Themes/Styles</ulink> of kde-look.org. Take note that styles come in source
-code or binary package forms. They are not &tde; theme files.</para>
-</sect1>
-
-<sect1 id="kde-theme">
-<title>&tde; Theme</title>
-<para>&tde; allows you to save the different changes you made to your desktop's
-appearance in one file, using the Theme Manager in &kcontrolcenter;. Once you
-have set up your desktop the way you want, click on <guibutton>Create New
-Theme...</guibutton>. Enter the details you want to give your theme, such as theme
-name, author, version, &etc;, then click <guibutton>OK</guibutton> when done.
-This will add your theme to the list of available themes and save your settings
-in a &tde; theme. A &tde; theme (<literal role="extension">.kth</literal> file)
-instructs &tde; on what window decoration, style, or color scheme to use for
-that particular theme. To add a &tde; theme from an outside source, click on
-<guibutton>Install New Theme...</guibutton> and locate the &tde; theme file.
-Removing a theme is easily done by clicking on <guibutton>Remove
-Theme</guibutton>. If you made changes to your theme, you have to either create
-a new theme name for it, or remove the previous version first to be able to use
-the same theme name.</para>
-
-<para>The following are the settings that are saved and indicated in a &tde;
-Theme:</para>
-
-<itemizedlist>
-<listitem><para>
-Background</para>
-</listitem>
-<listitem>
-<para>
-Screen Saver</para>
-</listitem>
-<listitem>
-<para>
-Icon Theme</para>
-</listitem>
-<listitem>
-<para>
-System Notifications</para>
-</listitem>
-<listitem>
-<para>
-Color Scheme</para>
-</listitem>
-<listitem>
-<para>
-Cursor Theme</para>
-</listitem>
-<listitem>
-<para>
-Window Decoration</para>
-</listitem>
-<listitem>
-<para>
-&konqueror; background (File Management)</para>
-</listitem>
-<listitem>
-<para>
-Panel background</para>
-</listitem>
-<listitem>
-<para>
-Style</para>
-</listitem>
-<listitem>
-<para>
-Fonts</para>
-</listitem>
-</itemizedlist>
-
-<para>One very important thing to consider when using or installing a &tde;
-Theme is that it only indicates what settings to use for the above. A &tde;
-Theme includes only system notifications, desktop background, panel background,
-&konqueror; background, and  the color scheme in its package. The other
-components must be installed separately if they do not already come with
-&tde;.</para>
-
-<para>&tde; Themes can be downloaded from the <ulink
-url="http://www.kde-look.org/index.php?xcontentmode=8">Theme-Manager
-subsection</ulink> of
-kde-look.org, under the Themes/Styles section.</para>
-</sect1>
-
-<sect1 id="desktop-glossary">
-<title>Glossary</title>
-
-<glosslist>
-<glossentry id="gloss-background">
-<glossterm>Background</glossterm>
-<glossdef><para>Background/wallpaper image or color for the
-desktop</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-color-scheme">
-<glossterm>Color Scheme</glossterm>
-<glossdef><para>(<literal role="extension">.kcsrc</literal>)
-Configuration file that indicates what colors to use
-for certain widgets</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-icons">
-<glossterm>Icons</glossterm>
-<glossdef><para>Images representing applications, files,
-devices, &etc;</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-splash-screen">
-<glossterm>Splash Screen</glossterm>
-<glossdef><para>Animated image or screen that displays while &tde;
-loads after logging in</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-win-deco">
-<glossterm>Window Decoration</glossterm>
-<glossdef><para>Plugins or small programs that instruct the window
-manager how to display window frames</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-style">
-<glossterm>Style</glossterm>
-<glossdef><para>Plugin or a small program that instructs &tde;
-how widgets are displayed</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-kde-theme">
-<glossterm>&tde; Theme</glossterm>
-<glossdef><para>(<literal role="extension">.kth</literal>)
-A file that contains instructions on what settings to use for
-different GUI components</para></glossdef>
-</glossentry>
-
-<glossentry id="gloss-widgets">
-<glossterm>Widgets</glossterm>
-<glossdef><para>Basic elements that build up a graphical user
-interface: buttons, scrollbars, menus, tabs, &etc;</para></glossdef>
-</glossentry>
-
-</glosslist>
-</sect1>
-
-
-</chapter>