From 6aa392e1314567b23ab733fc5e8cf8332a344452 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Tue, 17 Nov 2020 19:52:37 +0100 Subject: Move the khelpcenter guides to the directory level in which they are installed. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko (cherry picked from commit 1b6c123de102f0152d296fba8771d348329ba95c) --- .../userguide/customizing-desktop.docbook | 347 +++++++++++++++++++++ 1 file changed, 347 insertions(+) create mode 100644 doc/khelpcenter/userguide/customizing-desktop.docbook (limited to 'doc/khelpcenter/userguide/customizing-desktop.docbook') diff --git a/doc/khelpcenter/userguide/customizing-desktop.docbook b/doc/khelpcenter/userguide/customizing-desktop.docbook new file mode 100644 index 000000000..a8ed7cb42 --- /dev/null +++ b/doc/khelpcenter/userguide/customizing-desktop.docbook @@ -0,0 +1,347 @@ + + + + +Juan Carlos +Torres + + + + +Customizing the Appearance of your &tde; Desktop + +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. + + +Background +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 right-clicking +on the desktop and selecting Configure Desktop.... + +In &tde;, you have the option to use no picture, a single picture, or a +slideshow of images. If No picture is chosen to be the +desktop background, the Colors 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 All desktops or the +specific desktop name from the drop-down menu. + +Other background images can be downloaded using the +Get New Wallpapers button on the right or you can visit +the +Wallpapers section of the kde-look.org website. + + + +Colors +The Colors 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 +Save Scheme.... This will save your settings in a Color +Scheme file. Color schemes are text files, with a .kcsrc 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 +Import Scheme... and pointing to the .kcsrc 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. + +Additional color schemes can be downloaded from the Color Schemes +section of kde-look.org. + + + +Icons +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 Apply to switch to the new theme. To install new +icon themes, all you need to do is to click on Install New +Theme... 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 Remove Theme. +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 +(root) or by your distribution's +package manager. +Other icon themes can be found in the Icon Themes +subsection of kde-look.org. + + + +Splash Screen + + + + + +The default &tde; splash screen +The default &tde; splash screen + + +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 Apply. You can also test what a splash +screen will look like by selecting the splash screen and clicking on +Test. Installing a new splash theme is very easy. Just +click on Add... 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 Remove. Note that you cannot remove splash screens +installed by the administrator (root) +or by your distribution's package manager. + +Splash screen themes can be found on kde-look.org, in the Splash Screens +section. Take note that some splash screens require a specific &ksplash; +engine to be installed. + + + +Window Decorations +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. + +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 +Window Decoration 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 Apply. +Different window decorations have different capabilities and settings. Play +around with the different options available. The Buttons tab allows you to +control the buttons on the window titlebar. Enable the Use custom +titlebar button positions 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. + +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 deKorator, +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. + +To add an IceWM theme, select IceWM as the window decoration and click on +the Open &tde;'s IceWM theme folder link in the window +decoration description area. This will open a &konqueror; window +to $TDEHOME/share/apps/twin/icewm-themes. +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 +Apply. + +To add a deKorator theme after you've installed deKorator, select +deKorator from the window decorations list and go to the Themes +tab. Click on Install New Theme 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 Set Theme +Paths. Click on Apply for the changes to +take effect. + +Some more window decorations are available at kde-look.org under the +Native &tde; 3.x and the +Native &tde; 3.2+ subsections. Themes for the IceWM and +deKorator window +decorations have their own subsections under the Window Decorations +category. + + + +Style +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. + +Once a widget style has been installed, it will be added to the list of +available styles in the Style module in the &kcontrolcenter;. +The Style tab allows +you to select a widget style from the list and to configure it if the style has +a Configure... feature. Different styles have different options. A preview of the +selected style is available at the lower portion of the tab. The +Effects tab +controls different visual effects for some widgets like comboboxes and tooltips. +The Toolbar tab gives some options on the general appearance of toolbars. + +Additional widget styles can be found in the different &tde; subsections of the +Themes/Styles of kde-look.org. Take note that styles come in source +code or binary package forms. They are not &tde; theme files. + + + +&tde; Theme +&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 Create New +Theme.... Enter the details you want to give your theme, such as theme +name, author, version, &etc;, then click OK when done. +This will add your theme to the list of available themes and save your settings +in a &tde; theme. A &tde; theme (.kth 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 +Install New Theme... and locate the &tde; theme file. +Removing a theme is easily done by clicking on Remove +Theme. 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. + +The following are the settings that are saved and indicated in a &tde; +Theme: + + + +Background + + + +Screen Saver + + + +Icon Theme + + + +System Notifications + + + +Color Scheme + + + +Cursor Theme + + + +Window Decoration + + + +&konqueror; background (File Management) + + + +Panel background + + + +Style + + + +Fonts + + + +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;. + +&tde; Themes can be downloaded from the Theme-Manager +subsection of +kde-look.org, under the Themes/Styles section. + + + +Glossary + + + +Background +Background/wallpaper image or color for the +desktop + + + +Color Scheme +(.kcsrc) +Configuration file that indicates what colors to use +for certain widgets + + + +Icons +Images representing applications, files, +devices, &etc; + + + +Splash Screen +Animated image or screen that displays while &tde; +loads after logging in + + + +Window Decoration +Plugins or small programs that instruct the window +manager how to display window frames + + + +Style +Plugin or a small program that instructs &tde; +how widgets are displayed + + + +&tde; Theme +(.kth) +A file that contains instructions on what settings to use for +different GUI components + + + +Widgets +Basic elements that build up a graphical user +interface: buttons, scrollbars, menus, tabs, &etc; + + + + + + + -- cgit v1.2.1