← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/kcontrol/kwindecoration/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/kwindecoration/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" > <!-- change language only here -->
 
6
]>
 
7
 
 
8
<article lang="&language;">
 
9
<articleinfo>
 
10
<title>Window Decorations</title>
 
11
<authorgroup>
 
12
<author>&Rik.Hemsley; &Rik.Hemsley.mail;</author>
 
13
<author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
 
14
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
15
</authorgroup>
 
16
 
 
17
<date>2010-06-23</date>
 
18
<releaseinfo>&kde; 4.5</releaseinfo>
 
19
 
 
20
<keywordset>
 
21
<keyword>KDE</keyword>
 
22
<keyword>Systemsettings</keyword>
 
23
<keyword>kwin</keyword>
 
24
<keyword>window</keyword>
 
25
<keyword>border</keyword>
 
26
<keyword>theme</keyword>
 
27
<keyword>style</keyword>
 
28
</keywordset>
 
29
</articleinfo>
 
30
<sect1 id="window-deco">
 
31
<title>Window Decoration</title>
 
32
 
 
33
<para>This module allows you to select a style for the buttons and borders around
 
34
windows.</para>
 
35
 
 
36
<sect2>
 
37
<title>Window Decorations</title>
 
38
 
 
39
<para>
 
40
<screenshot>
 
41
<screeninfo>Window Decoration Configuration Module</screeninfo>
 
42
  <mediaobject>
 
43
    <imageobject>
 
44
      <imagedata fileref="main.png" format="PNG"/>
 
45
    </imageobject>
 
46
    <textobject>
 
47
      <phrase>Window Decoration Configuration Module</phrase>
 
48
    </textobject>
 
49
  </mediaobject>
 
50
</screenshot>
 
51
</para>
 
52
 
 
53
<para>Choose a window decoration style from the preview list, using the 
 
54
search field at the top of the screen.</para>
 
55
 
 
56
<para>&kde; 4.5 default window decoration is called "Oxygen".</para>
 
57
 
 
58
<para>Each style has a different look, but also a different
 
59
<quote>feel</quote>. Some have (sometimes invisible)
 
60
<quote>resize</quote> borders all around the edge, which make resizing
 
61
easier but moving more difficult. Some have no borders on certain
 
62
edges. One (<quote>BII</quote>) even has a dynamically sized and
 
63
positioned title element.</para>
 
64
 
 
65
<para>You are encouraged to experiment with the different styles until
 
66
you find one which best suits your pattern of work.</para>
 
67
 
 
68
<para>Below the preview pane you find three buttons to open configuration dialogs
 
69
for decoration and buttons of the selected style or to download additional
 
70
styles.</para>
 
71
 
 
72
</sect2>
 
73
 
 
74
<sect2>
 
75
<title>Decorations</title>
 
76
 
 
77
<para>In this dialog you can change the decoration of the window. 
 
78
 
 
79
The available options depend on the selected style.
 
80
</para>
 
81
<para>
 
82
<screenshot>
 
83
<screeninfo>Oxygen Decoration Options</screeninfo>
 
84
  <mediaobject>
 
85
    <imageobject>
 
86
      <imagedata fileref="decoration.png" format="PNG"/>
 
87
    </imageobject>
 
88
    <textobject>
 
89
      <phrase>Oxygen Decoration Options</phrase>
 
90
    </textobject>
 
91
  </mediaobject>
 
92
</screenshot>
 
93
</para>
 
94
</sect2>
 
95
 
 
96
<sect2>
 
97
<title>Buttons</title>
 
98
 
 
99
<para>This dialog allows you to customize the buttons location on the titlebar. You can move Close button to the left for example. Check the <guilabel>Use custom titlebar button positions</guilabel> option in order to customize your titlebars. Then use the &kde; titlebar below and the buttons on its left and right to rearrange them as you want them.
 
100
</para>
 
101
 
 
102
<para>
 
103
<screenshot>
 
104
<screeninfo>Window Decoration Configuration Module</screeninfo>
 
105
  <mediaobject>
 
106
    <imageobject>
 
107
      <imagedata fileref="buttons.png" format="PNG"/>
 
108
    </imageobject>
 
109
    <textobject>
 
110
      <phrase>Window Decoration Configuration Module</phrase>
 
111
    </textobject>
 
112
  </mediaobject>
 
113
</screenshot>
 
114
</para>
 
115
 
 
116
<para> By default, <guilabel>Show window button tooltips</guilabel> is checked and tooltips are shown.
 
117
</para>
 
118
 
 
119
<para>This page has instructions directly on it - just drag around the
 
120
buttons until you have the order that makes you comfortable.</para>
 
121
 
 
122
<note>
 
123
<para>Not all the window decorations are able to comply with your custom
 
124
set button order.  The ones that cannot are being converted, but at the
 
125
time of this release they have not been all been changed.</para>
 
126
</note>
 
127
 
 
128
<para>Apart from choosing the window decoration itself, you can choose
 
129
here two further options: if there should be a tooltip while you hover
 
130
your mouse over a window decoration button, and if the window
 
131
decoration should attempt to use a custom set button order.</para>
 
132
 
 
133
<tip>
 
134
<para>The tooltips can be quite useful if you have set a custom button
 
135
order, and then changed to an unfamiliar window decoration.</para>
 
136
</tip>
 
137
 
 
138
<tip>
 
139
<para>For accessibility purposes, some window decorations support
 
140
extra wide borders.  If this is available, you can also choose a
 
141
border size here.  These large borders are easier to see for low
 
142
vision users, and easier to grab for people with limited mobility or
 
143
difficulty using a mouse.</para>
 
144
</tip>
 
145
 
 
146
</sect2>
 
147
 
 
148
</sect1>
 
149
 
 
150
</article>