/usr/share/doc/kde/HTML/en/kcontrol/desktopthemedetails/index.docbook is in kde-workspace-data 4:4.8.2a-0ubuntu4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 | <?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE">
]>
<article lang="&language;">
<articleinfo>
<title>Desktop Theme</title>
<authorgroup>
<author>
<firstname>Andrew</firstname>
<surname>Lake</surname></author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<date>2010-06-22</date>
<releaseinfo>&kde; 4.5</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
<keyword>System Settings</keyword>
<keyword>desktop</keyword>
<keyword>theme</keyword>
<keyword>plasma</keyword>
</keywordset>
</articleinfo>
<sect1 id="kcm_desktoptheme">
<title><guilabel>Theme</guilabel> tab</title>
<para>A list of available themes is displayed on this tab. Select a theme by clicking on an item in the list.</para>
<para>Use the <guibutton>Get New Themes</guibutton> button to launch the <guilabel>Get Hot New Stuff</guilabel> dialog and
download additional themes from the Internet.</para>
</sect1>
<sect1 id="kcm_desktopthemedetails">
<title><guilabel>Details</guilabel> tab</title>
<para>A &kde; plasma desktop theme is made up of several components or items,
consisting mostly in svg backgrounds and colors schemes. This module allows you
to customize your desktop Plasma theme and to replace theme items
with items from other themes or from files.
</para>
<para>Desktop theme items consist in panel theme item, kickoff theme item,
analog clock, ...</para>
<note><para>
If you want to change your current theme for a full new theme (for example from
Air to Glassified) then you can do so in the <guilabel>Theme</guilabel> tab.
</para></note>
<sect2 id="start">
<title>Quick start</title>
<para>First download one or several themes you want to use to customize your
desktop items by clicking the <guibutton>Get New Themes...</guibutton>
button in the <guilabel>Theme</guilabel> tab.</para>
<para>All the available themes will be displayed on top, the current one being highlighted.</para>
<para>In the theme list, select a base theme that will be used for most widgets and start
customizing each item you want to change with a new theme, for example you can
have the panel in Glassified theme, the widget
backgrounds in Air and so on.</para>
<para>Here Air is the theme for most widgets and we changed the panel background
to Glassified, the Analog clock to Glassified and the Notes to Oxygen.</para>
<para>
<screenshot>
<screeninfo>Customizing your plasma theme</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="customizing.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Customizing your plasma theme</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
Clicking the <guibutton>Apply</guibutton> will create a new theme named
<guilabel>(Customized)</guilabel> and will apply it to your desktop.
</para>
</sect2>
<sect2 id="custom">
<title>Creating a custom theme</title>
<para>When the module is opened, it will show items from the current desktop
theme. If you would like to start customizing with a different theme, select it
from
the drop box above the list of theme items. This theme from the drop box is the
starting theme, the base for your new customized desktop theme.</para>
<para>
In the list of items, for each item you would like to replace, select
replacement item from the drop list for that item. You may select the
corresponding item from another theme, or you may select a file. Plasma
desktop theme items are svg files, except for the color scheme which is a KDE
color scheme file.
</para>
<para>
Click <guibutton>Apply</guibutton> when all the changes have been made. This
will create a new theme named <guilabel>(Customized)</guilabel> which you can
select from the Appearance Settings dialog on the desktop.
</para>
<para>
<screenshot>
<screeninfo>Your custom theme</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="clicking-apply.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Customized</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<note><para>
The theme items listed are the most visible components of the plasma
desktop theme. Other theme components are not listed. Your newly created
theme will use these unlisted components from the theme that you selected at
the start of creating the customized theme.
</para></note>
</sect2>
<sect2 id="naming">
<title>Naming a custom theme</title>
<para>
To provide a name for your customized theme, click on the
<guilabel>More</guilabel> checkbox and
enter the name of the theme. You may also provide your name (author), a theme
version and a description of your theme. Click <guibutton>Apply</guibutton>
when done.
</para>
</sect2>
<sect2 id="removing">
<title>Removing a theme</title>
<para>
Select the theme you would like to remove from the drop box above the list of
theme items. Click on the <guilabel>More</guilabel> check box. Click the
<guibutton>Remove Theme</guibutton> button to
remove the selected theme.
</para>
</sect2>
<sect2 id="exporting">
<title>Exporting a theme to a file</title>
<para>
You can share your newly customized theme with the community by exporting the
theme to a file. Select your customized theme from the drop box above the list
of theme items. Click on the <guilabel>More</guilabel> check box. Click the
<guibutton>Export Theme to
File...</guibutton>. Enter the name of the zip file to which the theme will be
saved.
</para>
</sect2>
</sect1>
</article>
<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
|