Warning, /plasma/plasma-desktop/doc/kcontrol/keys/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY % addindex "IGNORE">
0005 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0006 ]>
0007 
0008 <article id="keys" lang="&language;">
0009 <title>Shortcuts</title>
0010 <articleinfo>
0011 <authorgroup>
0012 <author>&Mike.McBride; &Mike.McBride.mail;</author>
0013 <author>&Jost.Schenck; &Jost.Schenck.mail;</author>
0014 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0015 </authorgroup>
0016 
0017 <date>2018-03-25</date>
0018 <releaseinfo>Plasma 5.12</releaseinfo>
0019 
0020 <keywordset>
0021 <keyword>Plasma</keyword>
0022 <keyword>KControl</keyword>
0023 <keyword>key bindings</keyword>
0024 <keyword>bindings</keyword>
0025 <keyword>shortcuts</keyword>
0026 </keywordset>
0027 </articleinfo>
0028 
0029 <sect1 id="key-bindings">
0030 <title>Shortcuts</title>
0031 
0032 <sect2 id="key-bindings-intro"> 
0033 <title>Introduction</title> 
0034 
0035 <para>While most of the functionality offered by &plasma; can be accessed
0036 using a simple <quote>point and click</quote> interface, many people
0037 prefer using the keyboard for some tasks.  Pressing something like
0038 <keycombo action="simul"> &Ctrl;<keycap>F</keycap></keycombo> is often
0039 just faster than moving your hands off the keyboard to the mouse,
0040 opening the <guimenu>Edit</guimenu> menu and selecting
0041 <guimenuitem>Find</guimenuitem>.</para>
0042 
0043 <para> As different people have different preferences about keyboard
0044 shortcuts, &plasma; offers full customization of <quote>key
0045 bindings.</quote> A key binding or shortcut is a combination of an
0046 action with a key or a combination of keys.</para>
0047 
0048 </sect2>
0049 
0050 <sect2 id="key-bindings-use-globapp">
0051 <title>Standard Shortcuts and Global Shortcuts</title>
0052 
0053 <para>Standard shortcuts and Global shortcuts work just the same. 
0054 Actually, in a certain way standard or application shortcuts are 
0055 <quote>global</quote> as well. The only
0056 difference is:</para>
0057 
0058 <itemizedlist>
0059 <listitem><para><quote>Standard shortcuts</quote> refer to actions
0060 that are often available in applications, such as Save, Print, Copy
0061 &etc;</para></listitem> 
0062 <listitem><para><quote>Global shortcuts</quote> are shortcuts for
0063 actions that make sense even when no application is opened. These
0064 shortcuts usually refer to actions like switching desktops, manipulating
0065 windows &etc;</para></listitem> 
0066 </itemizedlist>
0067 
0068 <para>Please note, that the application shortcuts configured here are
0069 <emphasis>only</emphasis> the standard actions often found in
0070 applications. Most applications will define their own actions as well,
0071 for which you have to customize key bindings using the application's
0072 key bindings dialog.</para>
0073 
0074 <sect3 id="key-bindings-standard">
0075 <title>Standard Shortcuts page</title>
0076 <para>At the top of this dialog you see an input box, where you can
0077 search interactively for shortcut names (&eg; Copy) or combination of keys 
0078 (&eg; <quote><userinput>Ctrl+C</userinput></quote>) by typing them literally here.</para>
0079 <para>Below the search box you can see a list of key bindings, &ie; associations between actions 
0080 (&eg; Copy) shown in the <guilabel>Action</guilabel> column and keys or combination of keys 
0081 (&eg; <keycombo action="simul">&Ctrl;<keycap>C</keycap> </keycombo>) shown in the 
0082 <guilabel>Shortcut</guilabel> or <guilabel>Alternate</guilabel> column.
0083 </para>
0084 </sect3>
0085 
0086 <sect3 id="key-bindings-global">
0087 <title>Global Shortcuts page</title>
0088 <para>At the left of this page is a list box which allows you
0089 to select a <guilabel>Component</guilabel> like KWin, Plasma Desktop &etc;
0090 The defined shortcuts for the selected component are displayed in the 
0091 <guilabel>Action</guilabel> and <guilabel>Global</guilabel> column in the list view.</para>
0092 <para>This page has the same search box as the <guilabel>Standard 
0093 Shortcuts</guilabel> tab.</para>
0094 <para>Use <guiicon><inlinemediaobject><imageobject><imagedata fileref="list-add.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>
0095 or <guiicon><inlinemediaobject><imageobject><imagedata fileref="remove.png" format="PNG"/></imageobject></inlinemediaobject></guiicon>
0096 to add or remove a component.
0097 </para>
0098 
0099 <para>Adding a component opens a dialog to pick applications from the start menu structure to
0100 add launchers to be usable as shortcuts.
0101 If an application has jumplist options they will be available as actions.
0102 </para>
0103 
0104 <para>Click the <guilabel>File</guilabel> drop down box at the right to import/export a 
0105 Scheme, set all shortcuts to none.</para>
0106 <para>Global shortcuts can now be configured to jump to specific tasks within an application.</para>
0107 
0108 <para>By default you can open the application menu by just pressing the &Meta; key.
0109 </para>
0110 </sect3>
0111 
0112 <sect3 id="key-bindings-use-confkeys">
0113 <title>Configuring Key Bindings</title>
0114 
0115 <para>Configuring key bindings is pretty easy. In the middle of
0116 these &systemsettings; modules you will find a list of available
0117 actions. If there's a key binding configured for that action you will
0118 find it in the columns right to it. Just select the action you want to
0119 configure.</para>
0120 
0121 <para>After you have selected an action in the list you will notice that 
0122 this item is highlighted and you see two additional check boxes below 
0123 this item in the list view. There you can configure a
0124 combination of keys or maybe no key binding at all for the selected
0125 action. </para>
0126 
0127 <itemizedlist>
0128 
0129 <listitem><para><guilabel>Default</guilabel>: the selected action
0130 will be associated with &kde;'s default value. This is a good choice
0131 for most actions, as &kde; comes with reasonable key bindings we have
0132 thought about. </para></listitem>
0133 
0134 <listitem><para><guilabel>Custom</guilabel>: if this option is
0135 enabled, you can create a key combination for the selected
0136 action. Click on the button labeled either <guibutton>None</guibutton> 
0137 or labeled with the previously selected custom shortcut. Now the button label
0138 changes to <guibutton>Input</guibutton>. Then press any modifier key 
0139 (&ie; &Shift;, &Ctrl;, or &Alt;) and then normal key or a function key (&eg; <keycap>F11</keycap>) 
0140 you want to assign to this key combination.</para>
0141 <para>Clicking on the <guilabel>Alternate</guilabel> column of a row in the list
0142 allows to edit the second shortcut for the action.</para></listitem>
0143 </itemizedlist>
0144 
0145 </sect3>
0146 </sect2>
0147 </sect1>
0148 
0149 </article>