← Back to branch summary

~ubuntu-branches/ubuntu/utopic/kde-workspace/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/kcontrol/desktopthemedetails/index.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Michał Zając
  • Date: 2011-07-09 08:31:15 UTC
  • Revision ID: james.westby@ubuntu.com-20110709083115-ohyxn6z93mily9fc
Tags: upstream-4.6.90
Import upstream version 4.6.90

Show diffs side-by-side

added added

removed removed

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