index.docbook 6.03 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
"dtd/kdedbx45.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->

<article id="keys" lang="&language;">
<author>&Mike.McBride; &Mike.McBride.mail;</author>
<author>&Jost.Schenck; &Jost.Schenck.mail;</author>

Burkhard Lück's avatar
Burkhard Lück committed
17 18
<releaseinfo>Plasma 5.12</releaseinfo>
19 20

Burkhard Lück's avatar
Burkhard Lück committed
22 23 24 25 26 27 28 29 30 31 32 33 34
<keyword>key bindings</keyword>

<sect1 id="key-bindings">

<sect2 id="key-bindings-intro"> 

Burkhard Lück's avatar
Burkhard Lück committed
<para>While most of the functionality offered by &plasma; can be accessed
36 37 38 39 40 41 42 43
using a simple <quote>point and click</quote> interface, many people
prefer using the keyboard for some tasks.  Pressing something like
<keycombo action="simul"> &Ctrl;<keycap>F</keycap></keycombo> is often
just faster than moving your hands off the keyboard to the mouse,
opening the <guimenu>Edit</guimenu> menu and selecting

<para> As different people have different preferences about keyboard
Burkhard Lück's avatar
Burkhard Lück committed
shortcuts, &plasma; offers full customization of <quote>key
45 46 47 48 49 50 51 52 53 54 55 56 57 58
bindings.</quote> A key binding or shortcut is a combination of an
action with a key or a combination of keys.</para>


<sect2 id="key-bindings-use-globapp">
<title>Standard Shortcuts and Global Shortcuts</title>

<para>Standard shortcuts and Global shortcuts work just the same. 
Actually, in a certain way standard or application shortcuts are 
<quote>global</quote> as well. The only
difference is:</para>

Burkhard Lück's avatar
Burkhard Lück committed
<listitem><para><quote>Standard shortcuts</quote> refer to actions
60 61
that are often available in applications, such as Save, Print, Copy
Andreas Kainz's avatar
Andreas Kainz committed
<listitem><para><quote>Global shortcuts</quote> are shortcuts for
63 64 65 66 67 68 69 70 71 72 73 74
actions that make sense even when no application is opened. These
shortcuts usually refer to actions like switching desktops, manipulating
windows &etc;</para></listitem> 

<para>Please note, that the application shortcuts configured here are
<emphasis>only</emphasis> the standard actions often found in
applications. Most applications will define their own actions as well,
for which you have to customize key bindings using the application's
key bindings dialog.</para>

<sect3 id="key-bindings-standard">
Burkhard Lück's avatar
Burkhard Lück committed
<title>Standard Shortcuts page</title>
76 77 78 79
<para>At the top of this dialog you see an input box, where you can
search interactively for shortcut names (&eg; Copy) or combination of keys 
(&eg; <quote><userinput>Ctrl+C</userinput></quote>) by typing them literally here.</para>
<para>Below the search box you can see a list of key bindings, &ie; associations between actions 
Burkhard Lück's avatar
Burkhard Lück committed
(&eg; Copy) shown in the <guilabel>Action</guilabel> column and keys or combination of keys 
81 82 83 84 85 86
(&eg; <keycombo action="simul">&Ctrl;<keycap>C</keycap> </keycombo>) shown in the 
<guilabel>Shortcut</guilabel> or <guilabel>Alternate</guilabel> column.

<sect3 id="key-bindings-global">
Andreas Kainz's avatar
Andreas Kainz committed
<title>Global Shortcuts page</title>
Burkhard Lück's avatar
Burkhard Lück committed
88 89
<para>At the left of this page is a list box which allows you
to select a <guilabel>Component</guilabel> like KWin, Plasma Desktop &etc;
The defined shortcuts for the selected component are displayed in the 
Burkhard Lück's avatar
Burkhard Lück committed
91 92
<guilabel>Action</guilabel> and <guilabel>Global</guilabel> column in the list view.</para>
<para>This page has the same search box as the <guilabel>Standard 
Shortcuts</guilabel> tab.</para>
Burkhard Lück's avatar
Burkhard Lück committed
94 95 96 97
<para>Use <guiicon><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>
or <guiicon><inlinemediaobject><imageobject><imagedata fileref="remove.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>
to add or remove a component.
Burkhard Lück's avatar
Burkhard Lück committed
98 99 100 101 102 103

<para>Adding a component opens a dialog to pick applications from the start menu structure to
add launchers to be usable as shortcuts.
If an application has jumplist options they will be available as actions.

Burkhard Lück's avatar
Burkhard Lück committed
104 105 106
<para>Click the <guilabel>File</guilabel> drop down box at the right to import/export a 
Scheme, set all shortcuts to none.</para>
<para>Global shortcuts can now be configured to jump to specific tasks within an application.</para>

<para>By default you can open the application menu by just pressing the &Meta; key.
Burkhard Lück's avatar
Burkhard Lück committed
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

<sect3 id="key-bindings-use-confkeys">
<title>Configuring Key Bindings</title>

<para>Configuring key bindings is pretty easy. In the middle of
these &systemsettings; modules you will find a list of available
actions. If there's a key binding configured for that action you will
find it in the columns right to it. Just select the action you want to

<para>After you have selected an action in the list you will notice that 
this item is highlighted and you see two additional check boxes below 
this item in the list view. There you can configure a
combination of keys or maybe no key binding at all for the selected
action. </para>


<listitem><para><guilabel>Default</guilabel>: the selected action
will be associated with &kde;'s default value. This is a good choice
for most actions, as &kde; comes with reasonable key bindings we have
thought about. </para></listitem>

<listitem><para><guilabel>Custom</guilabel>: if this option is
enabled, you can create a key combination for the selected
action. Click on the button labeled either <guibutton>None</guibutton> 
or labeled with the previously selected custom shortcut. Now the button label
changes to <guibutton>Input</guibutton>. Then press any modifier key 
(&ie; &Shift;, &Ctrl;, or &Alt;) and then normal key or a function key (&eg; <keycap>F11</keycap>) 
you want to assign to this key combination.</para>
<para>Clicking on the <guilabel>Alternate</guilabel> column of a row in the list
allows to edit the second shortcut for the action.</para></listitem>