Warning, /plasma/plasma-desktop/doc/plasma-desktop/index.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" ?> 0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ 0003 <!ENTITY kappname "&plasma;"> 0004 <!ENTITY package "kde-module"> 0005 <!ENTITY % addindex "IGNORE"> 0006 <!ENTITY % English "INCLUDE"> 0007 ]> 0008 <book id="plasma-desktop" lang="&language;"> 0009 0010 <bookinfo> 0011 <title>The &plasma; Handbook</title> 0012 0013 <authorgroup> 0014 <author> 0015 <personname> 0016 <firstname>Sebastian</firstname> 0017 <surname>Kügler</surname> 0018 </personname> 0019 <email>sebas@kde.org</email> 0020 </author> 0021 <author><firstname>Claus</firstname> <surname>Christensen</surname></author> 0022 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0023 </authorgroup> 0024 0025 <copyright> 0026 <year>2008–2010</year> 0027 <holder>Sebastian Kügler</holder> 0028 </copyright> 0029 0030 <legalnotice>&FDLNotice;</legalnotice> 0031 0032 <date>2021-07-23</date> 0033 <releaseinfo>Plasma 5.20</releaseinfo> 0034 0035 <abstract> 0036 <para> 0037 &plasma; is the core user interface to the desktop. 0038 </para> 0039 </abstract> 0040 0041 <keywordset> 0042 <keyword>KDE</keyword> 0043 <keyword>Plasma</keyword> 0044 <keyword>Plasmoid</keyword> 0045 <keyword>Widget</keyword> 0046 <keyword>Containments</keyword> 0047 <keyword>Desktop</keyword> 0048 <keyword>Runner</keyword> 0049 <keyword>Kicker</keyword> 0050 </keywordset> 0051 0052 </bookinfo> 0053 0054 <chapter id="introduction"> 0055 <title>Introduction</title> 0056 0057 <para><!--https://www.kde.org/workspaces/--> 0058 &plasma; provides a modern and customizable environment for running your favorite applications 0059 and accessing your information wherever it may be. Other common attributes of the &plasma; Desktop 0060 include advanced window management and desktop effects, support for &kde; &plasma; Widgets, 0061 integrated search, hardware management and a high degree of customizability. 0062 </para> 0063 0064 </chapter> 0065 0066 <chapter id="using-kapp"> 0067 <title>Using &plasma;</title> 0068 0069 <sect1 id="plasma-components"> 0070 <title>&plasma; Components</title> 0071 0072 <sect2 id="plasmoids-and-containments"> 0073 <title>&plasma; Widgets and Containments</title> 0074 0075 <para> 0076 The essence of &plasma; revolves around two basic concepts: 0077 </para> 0078 0079 <variablelist> 0080 <varlistentry> 0081 <term>&plasma; Widgets</term> 0082 <listitem> 0083 <para> 0084 Applets, or small applications that live on the desktop. 0085 </para> 0086 </listitem> 0087 </varlistentry> 0088 <varlistentry> 0089 <term>Containments</term><!--FIXME remove it, just a technical term with no meaning for joe user?--> 0090 <listitem> 0091 <para> 0092 Applets that act as the container for the &plasma; widgets 0093 </para> 0094 </listitem> 0095 </varlistentry> 0096 </variablelist> 0097 0098 <para> 0099 On a default desktop, there are two main elements: the Panel and the Desktop 0100 itself. Both are containments in the &plasma; sense. 0101 </para> 0102 0103 </sect2> 0104 0105 <sect2 id="default-plasma-desktop"> 0106 <title>Default &plasma; Desktop</title> 0107 0108 <para><note><para>The &plasma; Desktop can be configured in countless ways. The screenshot seen below shows a fairly standard desktop. Some distributions apply extensive customizations, so your desktop may look different. 0109 </para> 0110 <para>Similarly, the graphical appearance of the interface elements can be styled. These screenshots uses the &plasma; default style, Breeze.</para></note> 0111 </para> 0112 <para> 0113 <screenshot> 0114 <screeninfo>A fairly standard &plasma; Desktop</screeninfo> 0115 <mediaobjectco> 0116 <imageobjectco> 0117 <areaspec units="other" otherunits="imagemap"> 0118 <area id="im1" linkends="panel-launcher" coords="0,519,31,551"/> <!-- #1 kickoff launcher #--> 0119 <area id="im2" linkends="panel-launcher" coords="0,735,30,598"/><!-- #1 kickoff launcher icon --> 0120 <!--area linkends="FIXME" coords="37,483,69,516"/--><!-- #2 panel icons # --> 0121 <!--area linkends="FIXME" coords="23,558,83,597"/--><!-- #2 panel icons red box --> 0122 <!--area linkends="FIXME" coords="97,666,137,707"/--><!-- #3 pager # --> 0123 <!--area linkends="FIXME" coords="76,519,107,551"/--><!-- #3 pager plasmoid --> 0124 <area id="im3" linkends="panel-taskbar" coords="288,519,320,551"/><!-- #4 task manager # --> 0125 <area id="im4" linkends="panel-taskbar" coords="102,558,615,598"/><!-- #4 task manager red box --> 0126 <area id="im5" linkends="panel-system-tray" coords="652,519,683,551"/><!-- #5 system tray # --> 0127 <area id="im6" linkends="panel-system-tray" coords="618,557,728,598"/><!-- #5 system tray red box --> 0128 <area id="im7" linkends="panel-digital-clock" coords="739,534,772,566"/><!-- #6 clock # --> 0129 <area id="im8" linkends="panel-digital-clock" coords="729,573,781,598"/><!-- #6 clock plasmoid --> 0130 <area id="im9" linkends="panel-toolbox" coords="750,477,782,508"/><!-- #7 panel cashew # --> 0131 <area id="im10" linkends="panel-toolbox" coords="783,573,800,598"/><!-- #7 panel cashew icon --> 0132 <!--area linkends="FIXME" coords="733,11,765,44"/--><!-- #8 desktop cashew # --> 0133 <!--area linkends="FIXME" coords="772,0,800,25"/--><!-- #8 desktop cashew icon --> 0134 <!--area linkends="FIXME" coords="374,88,406,119"/--><!-- #9 folder view # --> 0135 <!--area linkends="FIXME" coords="10,18,361,204"/--><!-- #9 folder view plasmoid --> 0136 <area id = "im11" linkends="panel-launcher" coords="0,665,40,707"/> <!-- #1 kickoff launcher #--> 0137 </areaspec> 0138 <imageobject> 0139 <imagedata fileref="plasma-desktop-annotated.png" format="PNG"/> 0140 </imageobject> 0141 </imageobjectco> 0142 </mediaobjectco> 0143 </screenshot> 0144 </para> 0145 <orderedlist> 0146 <listitem><para>The program starter. Usually this will be <link linkend="panel-launcher">Application Launcher</link>.</para></listitem> 0147 <listitem><para>A couple of icons giving easy access to often used applications</para></listitem> 0148 <!--listitem><para>The Pager widget</para></listitem--> 0149 <listitem><para>The <link linkend="panel-taskbar">Task Manager</link>, which shows the titles of windows belonging to the applications currently running. No application had opened a window, when the screenshot was taken</para></listitem> 0150 <listitem><para>The <link linkend="panel-system-tray">System Tray</link></para></listitem> 0151 <listitem><para>The <link linkend="panel-digital-clock">Digital Clock</link> widget</para></listitem> 0152 <listitem><para>The <link linkend="panel-toolbox">Panel Toolbox</link></para></listitem> 0153 <listitem><para>The <link linkend="desktop">Desktop</link> Toolbox</para></listitem> 0154 <listitem><para>A Folder View widget, showing the content of the Desktop folder</para></listitem> 0155 </orderedlist> 0156 0157 </sect2> 0158 </sect1> 0159 0160 <sect1 id="panel"> 0161 <title>The Panel</title> 0162 0163 <para>The default panel holds a few &plasma; widgets: starting from the left, there is the 0164 application launcher.</para> 0165 0166 <sect2 id="panel-launcher"> 0167 <title>Application Launcher</title> 0168 0169 <screenshot> 0170 <screeninfo>Application launcher</screeninfo> 0171 <mediaobject> 0172 <imageobject> 0173 <imagedata fileref="application-launcher.png" format="PNG"/> 0174 </imageobject> 0175 <textobject> 0176 <phrase>Application launcher</phrase> 0177 </textobject> 0178 </mediaobject> 0179 </screenshot> 0180 <para>You can use it to start applications, open recently 0181 opened files and the usual logout/shutdown options. There is also a structure 0182 that allows you to browse through your applications. The layout has been 0183 optimized for the use case that is most common: starting an application. The 0184 default tab is the <guilabel>Favorites</guilabel> tab that holds the most-used 0185 entries. In the beginning, you'll probably find yourself using the 0186 <guilabel>Applications</guilabel> tab more often. 0187 Once you have found out what your most frequently started applications are, 0188 <mousebutton>right</mousebutton> click on the items and select the 0189 <guimenuitem>Add to Favorites</guimenuitem> to add them to your 0190 <guilabel>Favorites</guilabel> (or directly into the panel or on the desktop. 0191 Note that you need to <quote>unlock</quote> &plasma; by means of <mousebutton>right</mousebutton> 0192 clicking on the desktop for any kind of modification).</para> 0193 </sect2> 0194 0195 <sect2 id="panel-menu"> 0196 <title>Application Menu</title> 0197 0198 <para>If you prefer the 0199 traditional menu-style application launcher, change it by 0200 <mousebutton>right</mousebutton> clicking on the menu button and selecting 0201 <guimenuitem>Alternatives</guimenuitem>. 0202 </para> 0203 <screenshot> 0204 <screeninfo>Application menu</screeninfo> 0205 <mediaobject> 0206 <imageobject> 0207 <imagedata fileref="application-menu.png" format="PNG"/> 0208 </imageobject> 0209 <textobject> 0210 <phrase>Application menu</phrase> 0211 </textobject> 0212 </mediaobject> 0213 </screenshot> 0214 </sect2> 0215 0216 <sect2 id="panel-launcher-settings"> 0217 <title>Application Launcher Settings</title> 0218 0219 <para>If you want to configure the application launcher, change it by 0220 <mousebutton>right</mousebutton> clicking on the menu button and selecting 0221 <guimenuitem>Configure Application Launcher</guimenuitem>. 0222 </para> 0223 <screenshot> 0224 <screeninfo>Application launcher settings</screeninfo> 0225 <mediaobject> 0226 <imageobject> 0227 <imagedata fileref="application-launcher-settings.png" format="PNG"/> 0228 </imageobject> 0229 <textobject> 0230 <phrase>Application launcher settings</phrase> 0231 </textobject> 0232 </mediaobject> 0233 </screenshot> 0234 </sect2> 0235 0236 <sect2 id="panel-taskbar"> 0237 <title>Taskbar</title> 0238 0239 <para> 0240 The taskbar is another widget on the panel. It shows an area for all open windows on 0241 all desktops by default. You can make it show all open windows on the current 0242 desktop only by checking <guimenuitem>Only show tasks from the 0243 current desktop</guimenuitem> when you right click on the task manager, between 0244 two windows. The size of the text on the taskbar items can be set 0245 in &systemsettings; under the 0246 <menuchoice><guimenu>Appearance</guimenu><guisubmenu>Fonts</guisubmenu> 0247 </menuchoice>. Right-clicking on the taskbar 0248 brings the Settings dialog where you can choose several options to customize 0249 your taskbar. 0250 <screenshot> 0251 <screeninfo>Here is a screenshot of the taskbar settings dialog</screeninfo> 0252 <mediaobject> 0253 <imageobject> 0254 <imagedata fileref="taskbar-settings.png" format="PNG"/> 0255 </imageobject> 0256 <textobject> 0257 <phrase>Taskbar settings dialog</phrase> 0258 </textobject> 0259 </mediaobject> 0260 </screenshot> 0261 </para> 0262 </sect2> 0263 0264 <sect2 id="panel-system-tray"> 0265 <title>System Tray</title> 0266 0267 <para> 0268 Another default panel item is the <application>System Tray</application>, which 0269 is used by traditional applications and widgets as a dock. Right clicking on the 0270 <application>System Tray</application> allows you to open the settings dialog, 0271 where you can set entries to display and their visibility. 0272 </para> 0273 <screenshot> 0274 <screeninfo>System Tray settings dialog</screeninfo> 0275 <mediaobject> 0276 <imageobject> 0277 <imagedata fileref="system-tray-settings.png" format="PNG"/> 0278 </imageobject> 0279 <textobject> 0280 <phrase>System Tray settings dialog</phrase> 0281 </textobject> 0282 </mediaobject> 0283 </screenshot> 0284 </sect2> 0285 0286 <sect2 id="device-notifier"> 0287 <title>Device Notifier</title> 0288 0289 <para> 0290 An icon located usually in the system tray is the <application>Device Notifier</application>. 0291 Plug in a &USB; disk and a dialog will open that allows you to 0292 open the device in &dolphin; or another associated application. 0293 </para> 0294 <para> 0295 <screenshot> 0296 <screeninfo></screeninfo> 0297 <mediaobject> 0298 <imageobject> 0299 <imagedata fileref="device_notifier_widget.png" format="PNG"/> 0300 </imageobject> 0301 <textobject> 0302 <phrase></phrase> 0303 </textobject> 0304 </mediaobject> 0305 </screenshot> 0306 </para> 0307 <para>The <application>Device Notifier</application> is used for handling pluggable devices such as &USB; pendrives (also called flash drives or thumb drives), digital cameras, external &USB; hard drives, &etc; It also comes into play when a medium such as a &CD; or DVD is loaded into an optical drive. 0308 </para> 0309 <para>When you plug in an external device, or load a new medium into a drive, the <guilabel>Notifier</guilabel> window pops up (you can also open it explicitly by clicking on its Panel icon.) It stays open while the cursor is over it, otherwise it hides itself after a few seconds. 0310 </para> 0311 <para>The <guilabel>Notifier</guilabel> window shows a list of all the devices it currently knows about. Moving the mouse cursor over a device will highlight how many possible actions are associated with that device. 0312 </para> 0313 <para> 0314 <screenshot> 0315 <screeninfo></screeninfo> 0316 <mediaobject> 0317 <imageobject> 0318 <imagedata fileref="device_notifier_widget_actions.png" format="PNG"/> 0319 </imageobject> 0320 <textobject> 0321 <phrase></phrase> 0322 </textobject> 0323 </mediaobject> 0324 </screenshot> 0325 </para> 0326 <para>Clicking anywhere in the shaded box around the device name (but not on the eject/unmount icon if present) expands the entry to show the list of possible actions for that device. The set of actions depends on the device; it is configurable from the <application>Device Notifier</application>'s context menu or from the &systemsettings; modules <ulink url="help:/kcontrol/solid-actions/index.html">Device Actions</ulink> and <ulink url="help:/kcontrol/solid-device-automounter/index.html">Removable Devices</ulink>. Simply select one with the mouse or keyboard to launch that action. 0327 </para> 0328 <para>There is also a small icon to the right of each entry showing whether that device is currently accessible (or <emphasis>mounted</emphasis>) or not. Only when a device is not mounted is it safe to physically disconnect it from the computer. Clicking on the icon causes the device to be unmounted and/or the medium to be ejected if it is currently mounted, and will mount it if it is not. Note that unmounting/ejecting might fail if the device still has open files on it, ⪚ if a large file copy hasn't finished. In most cases you can just wait a while and try again. When an unmounting has succeeded, a success icon will be shown on the <application>Device Notifier</application>'s icon. 0329 </para> 0330 </sect2> 0331 0332 <sect2 id="panel-hidden"> 0333 <title>Hidden Items</title> 0334 0335 <para>The <application>System Tray</application> normally holds some more entries like 0336 &klipper;, &kmix; &etc;</para> 0337 0338 <para>Some of the default entries in the <application>System Tray</application> are hidden 0339 to save space in the bar. To display these entries click on the small white triangle 0340 <inlinemediaobject><imageobject><imagedata fileref="system-tray-up-arrow.png" format="PNG"/> 0341 </imageobject></inlinemediaobject>, then use 0342 the &LMB; to launch a widget or the &RMB; to open its settings dialog.</para> 0343 </sect2> 0344 0345 <sect2 id="panel-digital-clock"> 0346 <title>Digital Clock</title> 0347 0348 <para> 0349 The right-most &plasma; widget in the default panel holds the <application>Digital 0350 Clock</application>. 0351 This clock can display the time in different timezones as well as have its size 0352 changed. The clock will adjust its font size to the area it is given by the 0353 surrounding containment (that is the panel in this case). If you choose to 0354 display the date, this date will be rendered using the <guimenuitem>Small 0355 font</guimenuitem> option from the &systemsettings; <guilabel>Font</guilabel> 0356 dialog. The time will take the rest of the space. So in the end, you'll choose 0357 yourself the amount of information displayed, and if that fits. If you want to 0358 display more information, make the panel larger or put the clock on the desktop 0359 where it can grow freely. 0360 </para> 0361 </sect2> 0362 0363 <sect2 id="panel-pager"> 0364 <title>Pager</title> 0365 0366 <para> 0367 An optional item on your panel is the <application>Pager</application>. 0368 It allows you to switch between your virtual desktops. 0369 If you change the layout of the <application>Pager</application> 0370 through the <guimenuitem>Number of rows</guimenuitem> option, 0371 which will also affect the layout and animations that are shown in &kwin;’s 0372 <guimenuitem>Desktop Grid</guimenuitem> effect.<!-- – (Switch on desktop effect, 0373 press <keycombo action="simul">&Ctrl;<keycap>F8</keycap></keycombo> to see it.) 0374 don't see that in 4.7--> 0375 For larger pagers, selecting <guimenuitem>Display windows icons</guimenuitem> 0376 typically makes sense. 0377 </para> 0378 </sect2> 0379 <!-- other items in a kde compiled from sources --> 0380 <!-- Activity Manager --> 0381 <!-- Notifications --> 0382 <!-- Show the Desktop --> 0383 0384 </sect1> 0385 0386 <sect1 id="panel-toolbox"> 0387 <title>The Panel Toolbox</title> 0388 0389 <para>If your desktop is unlocked (you can do that by 0390 <mousebutton>right</mousebutton> clicking on the desktop, or when no 0391 application has the focus, with <keycombo 0392 action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>L</keycap>), a small &plasma; 0393 logo will appear in the bottom right corner in the panel. 0394 Click on this toolbox, and the panel controller opens.</para> 0395 0396 <screenshot> 0397 <screeninfo>Panel Settings</screeninfo> 0398 <mediaobject> 0399 <imageobject> 0400 <imagedata fileref="panel-settings.png" format="PNG"/> 0401 </imageobject> 0402 <textobject> 0403 <phrase>Panel Settings</phrase> 0404 </textobject> 0405 </mediaobject> 0406 </screenshot> 0407 0408 <para>The panel controller allows you to reposition, resize and realign the panel. The 0409 &plasma; widgets living in this panel will adjust their size automatically. 0410 &plasma; widgets have basic knowledge about sizing, provided by the containment. They 0411 are programmed to take advantage of that size, and inform the applet about how 0412 much space they possibly need. In the end, the containment gives a possible size 0413 to the applets, the applets obey.</para> 0414 0415 </sect1> 0416 0417 <sect1 id="add-applets"> 0418 <title>Adding Applets</title> 0419 0420 <para> 0421 Unlock the desktop and you'll be able to add and remove &plasma; widgets from panel 0422 or desktop. You add &plasma; widgets by simply dragging them where you want them. 0423 <mousebutton>Right</mousebutton> click on an widget to remove it. 0424 0425 <screenshot> 0426 <screeninfo>Add Widgets</screeninfo> 0427 <mediaobject> 0428 <imageobject> 0429 <imagedata fileref="add-widgets.png" format="PNG"/> 0430 </imageobject> 0431 <textobject> 0432 <phrase>Add Widgets</phrase> 0433 </textobject> 0434 </mediaobject> 0435 </screenshot> 0436 0437 The <guibutton>Get New Widgets</guibutton> button allows you to add widgets 0438 you've previously downloaded and download new &plasma; widgets. 0439 Currently it supports native &plasmagik; packages 0440 and some &Mac; OS X dashboard widgets. Widgets you install this way can then be 0441 accessed just like regular, preinstalled widgets. 0442 </para> 0443 </sect1> 0444 0445 <sect1 id="desktop"> 0446 <title>The Desktop</title> 0447 0448 <para> 0449 The desktop is in fact another containment. One that does not put size 0450 constraints on the applets. Applets can be moved and sized freely. On the 0451 unlocked desktop, &plasma; widgets will show a frame when you move the mouse over 0452 them. This applet handle allows you to move, resize, relocate and realign the 0453 panel. It also allows you to drag &plasma; widgets on the desktop. The buttons in the 0454 corner are used to resize, rotate configure and remove the applet. When 0455 rotated, a &plasma; widget will act magnetic towards 12 o'clock, so it is easy to get 0456 them back into sensible position. By default, most applets keep their aspect 0457 ratio when they are being resized. If you want to freely resize an applet, 0458 hold the &Ctrl; key pressed while resizing. 0459 </para> 0460 0461 <para> 0462 Right clicking on the desktop also offers you to configure aspects such as the 0463 wallpaper and the layout used, and the mouse actions. It offers to download new 0464 wallpapers through &knewstuff;. 0465 </para> 0466 <para>On the <guilabel>Tweaks</guilabel> page you can configure to hide the desktop Toolbox 0467 and adjust the widget handling. 0468 </para> 0469 0470 <screenshot> 0471 <screeninfo>Desktop Settings</screeninfo> 0472 <mediaobject> 0473 <imageobject> 0474 <imagedata fileref="desktop-settings.png" format="PNG"/> 0475 </imageobject> 0476 <textobject> 0477 <phrase>Desktop Settings</phrase> 0478 </textobject> 0479 </mediaobject> 0480 </screenshot> 0481 0482 <para>To change the &plasma; theme or download a new one through &knewstuff; 0483 open the <menuchoice><guimenu>Appearance</guimenu> <guimenuitem>Desktop 0484 Theme</guimenuitem></menuchoice> page in the &systemsettings;.</para> 0485 0486 <para> 0487 With open applications, it quickly gets hard to see the &plasma; widgets on your 0488 desktop. The <emphasis role="bold">Dashboard</emphasis> gets those &plasma; widgets 0489 in front of you, much like the <guilabel>Peek at Desktop</guilabel> functionality 0490 you are used to from traditional desktops. 0491 </para> 0492 0493 </sect1> 0494 0495 <sect1 id="folder-view"> 0496 <title>Folder View</title> 0497 <para>The <guilabel>Folder View</guilabel> widget is used to display entries like folders or 0498 files from a folder, by default from <filename class="directory">$<envar>HOME</envar>/Desktop</filename>. 0499 </para> 0500 <para>You can choose to view either all files, or filter either by specific regular expressions 0501 (⪚, all files with a certain extension) or by file type (⪚ just images). 0502 </para> 0503 <para>This widget also supports basic file management properties (moving, copying, cutting 0504 and pasting for example), and you can have as many as you want on your desktop. 0505 </para> 0506 0507 <screenshot> 0508 <screeninfo>Folder View</screeninfo> 0509 <mediaobject> 0510 <imageobject> 0511 <imagedata fileref="folder-view.png" format="PNG"/> 0512 </imageobject> 0513 <textobject> 0514 <phrase>Folder View</phrase> 0515 </textobject> 0516 </mediaobject> 0517 </screenshot> 0518 0519 <para>If you select the layout <guilabel>Folder View</guilabel> in the <guilabel>Desktop Settings</guilabel> 0520 you can use one Folder View as the whole desktop, effectively replicating the "old style" desktop paradigm. 0521 </para> 0522 </sect1> 0523 0524 <sect1 id="krunner"> 0525 <title>&krunner;</title> 0526 <para> 0527 &krunner; is a versatile mini command-line. You can use it to start applications, 0528 open web pages, access bookmarks, search through your desktop data, calculate 0529 short equations, and many more. Pressing <keycombo 0530 action="simul">&Alt;&Space;</keycombo> or <keycombo 0531 action="simul">&Alt;<keysym>F2</keysym></keycombo> opens the &krunner; dialog. 0532 You just start typing and &krunner; will start searching matches as soon as 0533 you've entered more than two characters. You can open the settings dialog to 0534 learn about &krunner;’s functionality, provided by plugins. You can 0535 navigate through the matches using the tab and arrow keys. 0536 </para> 0537 <!-- without tab no arrow keys--> 0538 <screenshot> 0539 <screeninfo>&krunner; dialog</screeninfo> 0540 <mediaobject> 0541 <imageobject> 0542 <imagedata fileref="krunner.png" format="PNG"/> 0543 </imageobject> 0544 <textobject> 0545 <phrase>&krunner; dialog</phrase> 0546 </textobject> 0547 </mediaobject> 0548 </screenshot> 0549 0550 <para>Use the <inlinemediaobject><imageobject><imagedata fileref="krunner-configure.png" format="PNG"/> 0551 </imageobject></inlinemediaobject> button to open the <guilabel>KRunner</guilabel> &systemsettings; 0552 module and configure where and what to search for in &krunner;. 0553 </para> 0554 0555 <para>&krunner; supports <quote>Desktop Actions</quote> which are additional actions an application can 0556 offer to perform common actions or jump directly to a certain task from Task Manager. 0557 Common examples are <guilabel>Open New Incognito Window</guilabel> to open your browser directly in private mode, 0558 <guilabel>Compose Email</guilabel> without launching the full-fledged email client first or the actions 0559 provided by &spectacle;: 0560 </para> 0561 0562 <screenshot> 0563 <screeninfo>&krunner; Desktop Actions</screeninfo> 0564 <mediaobject> 0565 <imageobject> 0566 <imagedata fileref="krunner-desktop-actions.png" format="PNG"/> 0567 </imageobject> 0568 <textobject> 0569 <phrase>&krunner; Desktop Actions</phrase> 0570 </textobject> 0571 </mediaobject> 0572 </screenshot> 0573 0574 <para>If you press the &Down; key in an empty &krunner; a history of the recent entities 0575 is shown. After invoking a search result, its query will move to the top, so repeatedly used 0576 commands never fall out of the list. 0577 </para> 0578 <para>Remove single entries from the list using the <inlinemediaobject><imageobject><imagedata fileref="remove.png" format="PNG"/> 0579 </imageobject></inlinemediaobject> button or clear the complete history in the 0580 &krunner; settings. 0581 </para> 0582 0583 <para> 0584 If you want to know what is going on on your system, pressing <keycombo 0585 action="simul">&Ctrl;&Esc;</keycombo> gives you quick access to a list of windows 0586 and processes, with options to monitor their output and kill processes. 0587 </para> 0588 </sect1> 0589 0590 <sect1 id="activities-interface"> 0591 <title>Activities</title> 0592 0593 <para> 0594 The desktop toolbox, accessed via the upper left corner has a button for 0595 displaying your activities, of which &plasma; allows you to have more than one. 0596 Basically, that is multiple desktop containments hosting multiple sets of &plasma; widgets. 0597 Display the <quote>Activities</quote> bar, select one of the predefined activities 0598 or choose <guilabel>Create Activity</guilabel> 0599 to create a new containment, select your new containment and customize suiting your taste. 0600 &plasma;’s activities and &kwin;’s desktop grid are similar in that respect, but there 0601 is a fundamental difference. While virtual desktop are used to group and organize windows, 0602 &plasma;’s activities are used to group and organize &plasma; widgets. This way, you can 0603 switch between activities and have relevant &plasma; widgets supporting the task you are 0604 currently trying to accomplish. You can create a <quote>Free time</quote> activity, with 0605 comic strips, a puzzle and other &plasma; widgets, and a <quote>Work</quote> activity, 0606 with relevant <acronym>RSS</acronym> feeds, calculator and calendar, for example. 0607 </para> 0608 0609 <para> 0610 To delete an activity, press the <guibutton>Stop Activity</guibutton> button on 0611 <quote>Activities</quote> bar (press <keycombo 0612 action="simul">&Alt;<keycap>D</keycap></keycombo> then <keycombo 0613 action="simul">&Alt;<keycap>A</keycap></keycombo> to open this bar) then click 0614 the red 'X' (or press <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo> 0615 then <keycombo action="simul">&Alt;<keycap>R</keycap></keycombo>) and confirm the 0616 deletion. 0617 </para> 0618 0619 </sect1> 0620 0621 <sect1 id="shortcuts"> 0622 <title>Shortcuts</title> 0623 0624 <para> 0625 Most of &plasma;’s functionality is also accessible through keyboard 0626 shortcuts. The various combinations should be pressed in sequence, that 0627 is for example <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>A</keycap> 0628 means: Press &Alt; and <keycap>D</keycap>, release and press <keycap>A</keycap>. 0629 </para> 0630 <para>Currently, the following default shortcuts can be used: 0631 </para> 0632 0633 <variablelist> 0634 <varlistentry> 0635 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>A</keycap></term> 0636 <listitem><para>Add Widgets</para></listitem> 0637 </varlistentry> 0638 0639 <varlistentry> 0640 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>R</keycap></term> 0641 <listitem><para>Remove Widget</para></listitem> 0642 </varlistentry> 0643 0644 <varlistentry> 0645 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>L</keycap></term> 0646 <listitem><para>Lock/Unlock Widgets</para></listitem> 0647 </varlistentry> 0648 0649 <varlistentry> 0650 <term><keycombo action="simul">&Meta;<keycap>=</keycap></keycombo></term> 0651 <listitem><para>Zoom out</para></listitem> 0652 </varlistentry> 0653 0654 <varlistentry> 0655 <term><keycombo action="simul">&Meta;<keycap>-</keycap></keycombo></term> 0656 <listitem><para>Zoom in</para></listitem> 0657 </varlistentry> 0658 0659 <varlistentry> 0660 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>N</keycap></term> 0661 <listitem><para>Next Widget</para></listitem> 0662 </varlistentry> 0663 0664 <varlistentry> 0665 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>P</keycap></term> 0666 <listitem><para>Previous Widget</para></listitem> 0667 </varlistentry> 0668 0669 <varlistentry> 0670 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>S</keycap></term> 0671 <listitem><para>Widget settings</para></listitem> 0672 </varlistentry> 0673 0674 <varlistentry> 0675 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>A</keycap></keycombo></term> 0676 <listitem><para>Activities</para></listitem> 0677 </varlistentry> 0678 0679 <varlistentry> 0680 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>R</keycap></keycombo></term> 0681 <listitem><para>Remove this Activity</para></listitem> 0682 </varlistentry> 0683 0684 <varlistentry> 0685 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>S</keycap></keycombo></term> 0686 <listitem><para>Desktop Settings</para></listitem> <!--FIXME also Panel Settings?--> 0687 </varlistentry> 0688 0689 <varlistentry> 0690 <term><keycombo action="simul">&Meta;	</keycombo></term> 0691 <listitem><para>Next Activity</para></listitem> 0692 </varlistentry> 0693 0694 <varlistentry> 0695 <term><keycombo action="simul">&Meta;&Shift;	</keycombo></term> 0696 <listitem><para>Previous Activity</para></listitem> 0697 </varlistentry> 0698 0699 <varlistentry> 0700 <term><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></term> 0701 <listitem><para>Peek at Desktop</para></listitem> 0702 </varlistentry> 0703 0704 <varlistentry> 0705 <term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>T</keycap></term> 0706 <listitem><para>Run the Associated Application</para></listitem> 0707 </varlistentry> 0708 0709 <varlistentry> 0710 <term><keycombo action="simul">&Meta;	</keycombo></term> 0711 <listitem><para>Open the Activities panel</para></listitem> 0712 </varlistentry> 0713 0714 </variablelist> 0715 0716 </sect1> 0717 0718 </chapter> 0719 0720 <chapter id="credits"> 0721 <title>Credits and License</title> 0722 0723 <para> 0724 &plasma; 0725 </para> 0726 <para> 0727 Program copyright 2008 &Aaron.J.Seigo; &Aaron.J.Seigo.mail; 0728 </para> 0729 0730 <para> 0731 Documentation Copyright © 2008–2010 Sebastian Kügler <email>sebas@kde.org</email> 0732 </para> 0733 0734 <!-- TRANS:CREDIT_FOR_TRANSLATORS --> 0735 0736 &underFDL; 0737 0738 </chapter> 0739 0740 &documentation.index; 0741 </book> 0742 0743 <!-- 0744 Local Variables: 0745 mode: xml 0746 sgml-minimize-attributes:nil 0747 sgml-general-insert-case:lower 0748 sgml-indent-step:0 0749 sgml-indent-data:nil 0750 End: 0751 0752 vim:tabstop=2:shiftwidth=2:expandtab 0753 kate: space-indent on; indent-width 2; tab-width 2; indent-mode none; 0754 -->