← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/kcontrol/keys/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/keys/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
<title>Shortcuts</title>
 
10
<articleinfo>
 
11
<authorgroup>
 
12
<author>&Mike.McBride; &Mike.McBride.mail;</author>
 
13
<author>&Jost.Schenck; &Jost.Schenck.mail;</author>
 
14
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
15
</authorgroup>
 
16
 
 
17
<date>2010-09-15</date>
 
18
<releaseinfo>&kde; 4.5</releaseinfo>
 
19
 
 
20
<keywordset>
 
21
<keyword>KDE</keyword>
 
22
<keyword>KControl</keyword>
 
23
<keyword>key bindings</keyword>
 
24
<keyword>bindings</keyword>
 
25
<keyword>shortcuts</keyword>
 
26
</keywordset>
 
27
</articleinfo>
 
28
 
 
29
<sect1 id="key-bindings">
 
30
<title>Shortcuts</title>
 
31
 
 
32
<sect2 id="key-bindings-intro"> 
 
33
<title>Introduction</title> 
 
34
 
 
35
<para>While most of the functionality offered by &kde; can be accessed
 
36
using a simple <quote>point and click</quote> interface, many people
 
37
prefer using the keyboard for some tasks.  Pressing something like
 
38
<keycombo action="simul"> &Ctrl;<keycap>F</keycap></keycombo> is often
 
39
just faster than moving your hands off the keyboard to the mouse,
 
40
opening the <guimenu>Edit</guimenu> menu and selecting
 
41
<guimenuitem>Find</guimenuitem>.</para>
 
42
 
 
43
<para> As different people have different preferences about keyboard
 
44
shortcuts, &kde; offers full customization of <quote>key
 
45
bindings.</quote> A key binding or shortcut is a combination of an
 
46
action with a key or a combination of keys.</para>
 
47
 
 
48
</sect2>
 
49
 
 
50
<!-- missing
 
51
<sect2 id="custom-shortcuts">
 
52
<title>Custom Shortcuts</title>
 
53
 
 
54
</sect2>
 
55
-->
 
56
 
 
57
<sect2 id="key-bindings-use-globapp">
 
58
<title>Standard Shortcuts and Global Shortcuts</title>
 
59
 
 
60
<para>Standard shortcuts and Global shortcuts work just the same. 
 
61
Actually, in a certain way standard or application shortcuts are 
 
62
<quote>global</quote> as well. The only
 
63
difference is:</para>
 
64
 
 
65
<itemizedlist>
 
66
<listitem><para><quote>Standard keyboard shortcuts</quote> refer to actions
 
67
that are often available in applications, such as Save, Print, Copy
 
68
&etc;</para></listitem> 
 
69
<listitem><para><quote>Global keyboard shortcuts</quote> are shortcuts for
 
70
actions that make sense even when no application is opened. These
 
71
shortcuts usually refer to actions like switching desktops, manipulating
 
72
windows &etc;</para></listitem> 
 
73
</itemizedlist>
 
74
 
 
75
<para>Please note, that the application shortcuts configured here are
 
76
<emphasis>only</emphasis> the standard actions often found in
 
77
applications. Most applications will define their own actions as well,
 
78
for which you have to customize key bindings using the application's
 
79
key bindings dialog.</para>
 
80
 
 
81
<sect3 id="key-bindings-standard">
 
82
<title><guilabel>Standard Keyboard Shortcuts</guilabel> tab</title>
 
83
<para>At the top of this dialog you see an input box, where you can
 
84
search interactively for shortcut names (&eg; Copy) or combination of keys 
 
85
(&eg; <quote><userinput>Ctrl+C</userinput></quote>) by typing them literally here.</para>
 
86
<para>Below the search box you can see a list of key bindings, &ie; associations between actions 
 
87
(&eg; Copy) shown in the <guilabel>Actions</guilabel> column and keys or combination of keys 
 
88
(&eg; <keycombo action="simul">&Ctrl;<keycap>C</keycap> </keycombo>) shown in the 
 
89
<guilabel>Shortcut</guilabel> or <guilabel>Alternate</guilabel> column.
 
90
</para>
 
91
<!-- Global column is empty what's that???-->
 
92
</sect3>
 
93
 
 
94
<sect3 id="key-bindings-global">
 
95
<title><guilabel>Global Keyboard Shortcuts</guilabel> tab</title>
 
96
<para>At the top of this page is a drop down box which allows you
 
97
to select a <guilabel>KDE component</guilabel> like KWin, Plasma Desktop &etc;
 
98
The defined shortcuts for the selected component are displayed in the 
 
99
<guilabel>Action</guilabel> and <guilabel>Global</guilabel> column in the list view. 
 
100
Click the <guilabel>File</guilabel> drop down box at the right to import/export a 
 
101
Scheme, set all shortcuts to none and remove a component.</para>
 
102
<para>This page has the same search box as the <guilabel>Standard Keyboard 
 
103
Shortcuts</guilabel> tab.</para>
 
104
 
 
105
</sect3>
 
106
 
 
107
<sect3 id="key-bindings-use-confkeys">
 
108
<title>Configuring Key Bindings</title>
 
109
 
 
110
<para>Configuring key bindings is pretty easy. In the middle of
 
111
these &systemsettings; modules you will find a list of available
 
112
actions. If there's a key binding configured for that action you will
 
113
find it in the columns right to it. Just select the action you want to
 
114
configure.</para>
 
115
 
 
116
<para>After you have selected an action in the list you will notice that 
 
117
this item is highlighted and you see two additional check boxes below 
 
118
this item in the list view. There you can configure a
 
119
combination of keys or maybe no key binding at all for the selected
 
120
action. </para>
 
121
 
 
122
<itemizedlist>
 
123
 
 
124
<listitem><para><guilabel>Default</guilabel>: the selected action
 
125
will be associated with &kde;'s default value. This is a good choice
 
126
for most actions, as &kde; comes with reasonable key bindings we have
 
127
thought about. </para></listitem>
 
128
 
 
129
<listitem><para><guilabel>Custom</guilabel>: if this option is
 
130
enabled, you can create a key combination for the selected
 
131
action. Click on the button labeled either <guibutton>None</guibutton> 
 
132
or labeled with the previously selected custom shortcut. Now the button label
 
133
changes to <guibutton>Input</guibutton>. Then press any modifier key 
 
134
(&ie; &Shift;, &Ctrl;, or &Alt;) and then normal key or a function key (&eg; <keycap>F11</keycap>) 
 
135
you want to assign to this key combination.</para>
 
136
<para>Clicking on the <guilabel>Alternate</guilabel> column of a row in the list
 
137
allows to edit the second shortcut for the action.</para></listitem>
 
138
</itemizedlist>
 
139
 
 
140
</sect3>
 
141
<!-- changed in kde4
 
142
<sect3 id="key-bindings-use-confschemes">
 
143
<title>Configuring Schemes</title>
 
144
 
 
145
<para>A key binding scheme is a set of key bindings that you can
 
146
select by name. &kde; comes with several pre-defined key binding
 
147
schemes. In addition to these bundled schemes, you will always see a scheme named
 
148
<guilabel>Current scheme</guilabel> that represents the set of key
 
149
bindings you are using right now (&ie; not the current settings you
 
150
are playing with, but what you've been using up to now). </para>
 
151
 
 
152
<para>When you are playing with the key bindings for the first time
 
153
you don't have to be afraid of changing the default bindings: &kde;
 
154
won't let you overwrite the defaults, so you can always switch back to
 
155
the factory presets. By choosing <guilabel>Current scheme</guilabel>
 
156
you can return to the set of key bindings you've been using up to
 
157
now. However, be careful not to select a scheme when you've made
 
158
changes to the key bindings you don't want to lose.</para>
 
159
 
 
160
<para>When you are satisfied with a set of key bindings you've
 
161
created, you may want to save them to a scheme of your own, so that
 
162
you can still experiment with the bindings and always return to a
 
163
certain scheme. You can always do this by clicking on the
 
164
<guibutton>Add</guibutton> button.  You will be prompted for a name
 
165
and then the new scheme will appear in the key schemes listbox. You
 
166
can remove your own schemes again by selecting a scheme and clicking
 
167
the <guibutton>Remove</guibutton> button. Click the <guibutton>Save
 
168
changes</guibutton> button to save any changes you have made to the
 
169
currently selected scheme. Note that you can not remove or save
 
170
changes to <guilabel>KDE default</guilabel> or to <guilabel>Current
 
171
scheme</guilabel>.</para>
 
172
 
 
173
<important><para>If you want to save your changes while a read-only
 
174
scheme is selected, you always have to add a new scheme first! If you
 
175
select one of your own schemes because you want to save the changes to
 
176
that one, the control module will switch to the key bindings of that
 
177
scheme, discarding your changes.</para></important> 
 
178
</sect3>
 
179
-->
 
180
<!--not in kde 4
 
181
</sect2>
 
182
<sect2>
 
183
<title>Modifier Keys</title>
 
184
 
 
185
<para>Different keyboards offer different sets of modifier keys.  A
 
186
&Mac; keyboard, for example, does not have a &Ctrl; key, and instead
 
187
has an <keycap>Option</keycap> key.  Here you can see what the
 
188
available modifier keys for the current keyboard are.</para>
 
189
 
 
190
<para>If you enable <guilabel>Macintosh keyboard</guilabel> the list
 
191
of modifiers will change.</para>
 
192
 
 
193
<para>If you have enabled the &Mac; keyboard, you can further enable
 
194
<guilabel>MacOS-style modifier usage</guilabel>, to make &kde; behave
 
195
more like &MacOS;.</para>
 
196
 
 
197
<para>Finally, you can change what a keypress sends to the &X-Server;
 
198
in the <guilabel>X Modifier Mapping</guilabel> section.  A common
 
199
example is to reconfigure the <keycap>Caps Lock</keycap> key, which is
 
200
rarely used, to be another &Ctrl; key.  This is especially nice if you
 
201
are a touch typist, as <keycap>Caps Lock</keycap> is much easier to
 
202
reach than either of the &Ctrl; keys on a standard keyboard.</para>
 
203
 
 
204
</sect2>
 
205
-->
 
206
</sect2>
 
207
</sect1>
 
208
 
 
209
</article>