~ubuntu-branches/ubuntu/precise/kde-workspace/precise-security

« back to all changes in this revision

Viewing changes to doc/plasma-desktop/index.docbook

Tags: upstream-4.7.2
Import upstream version 4.7.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
28
28
 
29
29
<legalnotice>&FDLNotice;</legalnotice>
30
30
 
31
 
<date>2010-07-17</date>
32
 
<releaseinfo>1.10.00</releaseinfo>
 
31
<date>2011-09-04</date>
 
32
<releaseinfo>&kde; 4.7</releaseinfo>
33
33
 
34
34
<abstract>
35
35
<para>
125
125
</para>
126
126
 
127
127
<para>
128
 
The next icon (looking like either a desktop computer or a laptop, depending on
129
 
the type of machine) is the <application>Device Notifier</application>.
130
 
Plug in a <acronym>USB</acronym> disk and a dialog will open that allows you to
131
 
open the device in &dolphin;.
132
 
</para>
133
 
 
134
 
<para>
135
 
The next item on your panel is the <application>Pager</application>.
136
 
It allows you to switch between your virtual desktops.
137
 
If you change the layout of the <application>Pager</application>
138
 
through the <guimenuitem>Number of rows</guimenuitem> option,
139
 
which will also affect the layout and animations that are shown in &kwin;’s
140
 
<guimenuitem>Desktop Grid</guimenuitem> effect &ndash; (Switch on desktop effect,
141
 
press <keycombo action="simul">&Ctrl;<keycap>F8</keycap></keycombo> to see it.)
142
 
For larger pagers, selecting <guimenuitem>Display windows icons</guimenuitem>
143
 
typically makes sense.
144
 
</para>
145
 
 
146
 
<para>
147
 
The taskbar is up next on the panel. It shows an area for all open windows on
 
128
The taskbar is another widget on the panel. It shows an area for all open windows on
148
129
all desktops by default. You can make it show all open windows on the current
149
130
desktop only by checking <guimenuitem>Only show tasks from the
150
131
current desktop</guimenuitem> when you right click on the task manager, between
168
149
</para>
169
150
 
170
151
<para>
171
 
Next on our default panel is the <application>System Tray</application>, which
172
 
is used by traditional applications as a dock. Right clicking on the
173
 
<application>System Tray</application> allows you to hide or show icons.
174
 
</para>
 
152
Another default panel item is the <application>System Tray</application>, which
 
153
is used by traditional applications and widgets as a dock. Right clicking on the
 
154
<application>System Tray</application> allows you to open the settings dialog,
 
155
where you can set entries to display and their visibility.
 
156
</para>
 
157
<screenshot>
 
158
<screeninfo>System Tray settings dialog</screeninfo>
 
159
  <mediaobject>
 
160
    <imageobject>
 
161
      <imagedata fileref="system-tray-settings.png" format="PNG"/>
 
162
    </imageobject>
 
163
      <textobject>
 
164
      <phrase>System Tray settings dialog</phrase>
 
165
    </textobject>
 
166
  </mediaobject>
 
167
</screenshot>
 
168
<para>
 
169
An icon located usually in the system tray is the <application>Device Notifier</application>.
 
170
Plug in a <acronym>USB</acronym> disk and a dialog will open that allows you to
 
171
open the device in &dolphin; or another associated application.
 
172
</para>
 
173
 
 
174
<para>The <application>System Tray</application> normally holds some more entries like 
 
175
&klipper;, &kmix; &etc;.</para>
 
176
 
 
177
<para>Some of the default entries in the <application>System Tray</application> are hidden 
 
178
to save space in the bar. To display these entries click on the small white triangle 
 
179
<inlinemediaobject><imageobject><imagedata fileref="system-tray-up-arrow.png" format="PNG"/>
 
180
</imageobject></inlinemediaobject>, then use
 
181
the &LMB; to launch a widget or the &RMB; to open its settings dialog.</para>
175
182
 
176
183
<para>
177
184
The right-most &plasma; widget in the default panel holds the <application>Digital
187
194
where it can grow freely.
188
195
</para>
189
196
 
 
197
<para>
 
198
An optional item on your panel is the <application>Pager</application>.
 
199
It allows you to switch between your virtual desktops.
 
200
If you change the layout of the <application>Pager</application>
 
201
through the <guimenuitem>Number of rows</guimenuitem> option,
 
202
which will also affect the layout and animations that are shown in &kwin;’s
 
203
<guimenuitem>Desktop Grid</guimenuitem> effect &ndash; <!--(Switch on desktop effect,
 
204
press <keycombo action="simul">&Ctrl;<keycap>F8</keycap></keycombo> to see it.)
 
205
don't see that in 4.7-->
 
206
For larger pagers, selecting <guimenuitem>Display windows icons</guimenuitem>
 
207
typically makes sense.
 
208
</para>
 
209
 
 
210
<!-- other items in a kde compiled from sources -->
 
211
<!-- Activity Manager -->
 
212
<!-- Notifications -->
 
213
<!-- Show the Desktop -->
 
214
 
190
215
</sect1>
191
216
 
192
217
<sect1 id="toolboxes">
193
218
<title>The Panel Toolboxes</title>
194
219
 
195
 
<para>
196
 
If your desktop is unlocked (you can do that by
 
220
<para>If your desktop is unlocked (you can do that by
197
221
<mousebutton>right</mousebutton> clicking on the desktop, or when no
198
222
application has the focus, with <keycombo
199
 
action="simul">&Ctrl;<keycap>L</keycap></keycombo>), a small &plasma;
200
 
logo will appear in the bottom right corner (it is commonly named the
201
 
“cashew”). Click on this cashew, and the panel controller opens. The
202
 
panel controller allows you to reposition, resize and realign the panel. The
 
223
action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>L</keycap>), a small &plasma;
 
224
logo will appear in the bottom right corner in the panel (it is commonly named the
 
225
“cashew”). Click on this cashew, and the panel controller opens.</para>
 
226
 
 
227
<screenshot>
 
228
<screeninfo>Panel Settings</screeninfo>
 
229
  <mediaobject>
 
230
    <imageobject>
 
231
      <imagedata fileref="panel-settings.png" format="PNG"/>
 
232
    </imageobject>
 
233
      <textobject>
 
234
      <phrase>Panel Settings</phrase>
 
235
    </textobject>
 
236
  </mediaobject>
 
237
</screenshot>
 
238
 
 
239
<para>The panel controller allows you to reposition, resize and realign the panel. The
203
240
&plasma; widgets living in this panel will adjust their size automatically.
204
241
&plasma; widgets have basic knowledge about sizing, provided by the containment. They
205
242
are programmed to take advantage of that size, and inform the applet about how
206
243
much space they possibly need. In the end, the containment gives a possible size
207
 
to the applets, the applets obey.
208
 
</para>
 
244
to the applets, the applets obey.</para>
209
245
 
210
246
</sect1>
211
247
 
255
291
 
256
292
<para>
257
293
Right clicking on the desktop also offers you to configure aspects such as the
258
 
wallpaper used, and the &plasma; theme. Both actions offer to download new
259
 
wallpapers and themes through &knewstuff;.
 
294
wallpaper and the layout used, and the mouse actions. It offers to download new
 
295
wallpapers through &knewstuff;.
260
296
</para>
261
297
 
 
298
<screenshot>
 
299
<screeninfo>Desktop Settings</screeninfo>
 
300
  <mediaobject>
 
301
    <imageobject>
 
302
      <imagedata fileref="desktop-settings.png" format="PNG"/>
 
303
    </imageobject>
 
304
      <textobject>
 
305
      <phrase>Desktop Settings</phrase>
 
306
    </textobject>
 
307
  </mediaobject>
 
308
</screenshot>
 
309
 
 
310
<para>To change the &plasma; theme or download a new one through &knewstuff; 
 
311
open the <menuchoice><guimenu>Workspace Appearance</guimenu> <guimenuitem>Desktop 
 
312
Theme</guimenuitem></menuchoice> page in the &systemsettings;.</para>
 
313
 
262
314
<para>
263
315
With open applications, it quickly gets hard to see the &plasma; widgets on your
264
316
desktop. The <emphasis role="bold">Dashboard</emphasis> gets those &plasma; widgets
294
346
<title>Activities</title>
295
347
 
296
348
<para>
297
 
The desktop toolbox, accessed via the top right corner has a button for displaying your activities, of which &plasma; allows you to have more than one. Basically, that is multiple desktop containments hosting multiple sets of &plasma; widgets. Display the “Activities” bar, choose <guilabel>Add activity</guilabel> to create a new containment, select your new containment and customize suiting your taste. &plasma;’s activities and &kwin;’s desktop grid are similar in that respect, but there is a fundamental difference. While virtual desktop are used to group and organize windows, &plasma;’s activities are used to group and organize &plasma; widgets. This way, you can switch between activities and have relevant &plasma; widgets supporting the task you're currently trying to accomplish. You can create a “Free time” activity, with comic strips, a puzzle and other &plasma; widgets, and a work activity, with relevant <acronym>RSS</acronym> feeds, calculator and calendar, for example.
 
349
The desktop toolbox, accessed via the upper right corner has a button for 
 
350
displaying your activities, of which &plasma; allows you to have more than one. 
 
351
Basically, that is multiple desktop containments hosting multiple sets of &plasma; widgets. 
 
352
Display the <quote>Activities</quote> bar, select one of the predefined activities 
 
353
or choose <guilabel>Create Activity</guilabel> 
 
354
to create a new containment, select your new containment and customize suiting your taste. 
 
355
&plasma;’s activities and &kwin;’s desktop grid are similar in that respect, but there 
 
356
is a fundamental difference. While virtual desktop are used to group and organize windows, 
 
357
&plasma;’s activities are used to group and organize &plasma; widgets. This way, you can 
 
358
switch between activities and have relevant &plasma; widgets supporting the task you are 
 
359
currently trying to accomplish. You can create a <quote>Free time</quote> activity, with 
 
360
comic strips, a puzzle and other &plasma; widgets, and a <quote>Work</quote> activity, 
 
361
with relevant <acronym>RSS</acronym> feeds, calculator and calendar, for example.
298
362
</para>
299
363
 
300
364
</sect1>
301
365
 
 
366
<!-- print shortcuts settings dialog in branch 4.7)
 
367
Shortcuts for Plasma Desktop Shell
 
368
Action          Shortcut      Global
 
369
Activities ...  Alt+D, Alt+A  Meta+Q
 
370
Activities ...  Alt+D, Alt+A  Meta+Q
 
371
Activity Settings Alt+D, Alt+S
 
372
Add Widgets ...   Alt+D, A
 
373
Lock Widgets      Alt+D, L
 
374
Lock Widgets      Alt+D, L
 
375
Next Widget       Alt+D, N
 
376
Previous Widget   Alt+D, P
 
377
Remove this Activity  Alt+D, Alt+R
 
378
Remove this Widget    Alt+D, R
 
379
Run the Associated Application  Alt+D, T
 
380
Run the Associated Application  Alt+D, T
 
381
Widget Settings   Alt+D, S
 
382
Why these duplicated entries? 
 
383
-->
302
384
<sect1 id="shortcuts">
303
385
<title>Shortcuts</title>
304
386
 
305
387
<para>
306
388
Most of &plasma;’s functionality is also accessible through keyboard
307
 
shortcuts. Currently, the following default shortcuts can be used:
 
389
shortcuts. The various combinations should be pressed in sequence, that 
 
390
is for example <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>A</keycap> 
 
391
means: Press &Alt; and <keycap>D</keycap>, release and press <keycap>A</keycap>.
 
392
</para>
 
393
<para>Currently, the following default shortcuts can be used:
308
394
</para>
309
395
 
310
396
<variablelist>
311
397
<varlistentry>
312
 
<term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term>
313
 
<listitem><para>Add widgets</para></listitem>
314
 
</varlistentry>
315
 
 
316
 
<varlistentry>
317
 
<term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term>
318
 
<listitem><para>Lock widgets</para></listitem>
319
 
</varlistentry>
320
 
 
321
 
<varlistentry>
322
 
<term><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></term>
 
398
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>A</keycap></term>
 
399
<listitem><para>Add Widgets</para></listitem>
 
400
</varlistentry>
 
401
 
 
402
<varlistentry>
 
403
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>R</keycap></term>
 
404
<listitem><para>Remove Widget</para></listitem>
 
405
</varlistentry>
 
406
 
 
407
<varlistentry>
 
408
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>L</keycap></term>
 
409
<listitem><para>Lock/Unlock Widgets</para></listitem>
 
410
</varlistentry>
 
411
 
 
412
<!-- zoom still valid in 4.7?
 
413
<varlistentry>
 
414
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>-</keycap></term>
323
415
<listitem><para>Zoom out</para></listitem>
324
416
</varlistentry>
325
417
 
326
418
<varlistentry>
327
 
<term><keycombo action="simul">&Ctrl;<keycap>=</keycap></keycombo></term>
 
419
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>+</keycap></term>
328
420
<listitem><para>Zoom in</para></listitem>
329
421
</varlistentry>
330
 
 
331
 
<varlistentry>
332
 
<term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term>
333
 
<listitem><para>Next applet</para></listitem>
334
 
</varlistentry>
335
 
 
336
 
<varlistentry>
337
 
<term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term>
338
 
<listitem><para>Previous applet</para></listitem>
339
 
</varlistentry>
340
 
 
 
422
-->
 
423
<varlistentry>
 
424
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>N</keycap></term>
 
425
<listitem><para>Next Widget</para></listitem>
 
426
</varlistentry>
 
427
 
 
428
<varlistentry>
 
429
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>P</keycap></term>
 
430
<listitem><para>Previous Widget</para></listitem>
 
431
</varlistentry>
 
432
 
 
433
<varlistentry>
 
434
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>S</keycap></term>
 
435
<listitem><para>Widget settings</para></listitem>
 
436
</varlistentry>
 
437
 
 
438
<varlistentry>
 
439
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>A</keycap></keycombo></term>
 
440
<listitem><para>Activities</para></listitem>
 
441
</varlistentry>
 
442
 
 
443
<varlistentry>
 
444
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>R</keycap></keycombo></term>
 
445
<listitem><para>Remove this Activity</para></listitem>
 
446
</varlistentry>
 
447
 
 
448
<varlistentry>
 
449
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycombo action="simul">&Alt;<keycap>S</keycap></keycombo></term>
 
450
<listitem><para>Activities Settings</para></listitem>
 
451
</varlistentry>
 
452
 
 
453
<varlistentry>
 
454
<term><keycombo action="simul"><keycap>Meta</keycap>&Tab;</keycombo></term>
 
455
<listitem><para>Next Activity</para></listitem>
 
456
</varlistentry>
 
457
 
 
458
<varlistentry>
 
459
<term><keycombo action="simul"><keycap>Meta</keycap>&Shift;&Tab;</keycombo></term>
 
460
<listitem><para>Previous Activity</para></listitem>
 
461
</varlistentry>
 
462
 
 
463
<varlistentry>
 
464
<term><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></term>
 
465
<listitem><para>Show Dashboard</para></listitem>
 
466
</varlistentry>
 
467
 
 
468
<varlistentry>
 
469
<term><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>, <keycap>T</keycap></term>
 
470
<listitem><para>Run the Associated Application</para></listitem>
 
471
</varlistentry>
 
472
 
 
473
<!-- still valid in 4.7?
341
474
<varlistentry>
342
475
<term><keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo></term>
343
476
<listitem><para>Next containment</para></listitem>
349
482
</varlistentry>
350
483
 
351
484
<varlistentry>
352
 
<term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term>
353
 
<listitem><para>Applet settings</para></listitem>
354
 
</varlistentry>
355
 
 
356
 
<varlistentry>
357
485
<term>
358
486
<keycombo action="simul">
359
487
&Shift;&Ctrl;<keycap>S</keycap>
361
489
</term>
362
490
<listitem><para>Containment settings</para></listitem>
363
491
</varlistentry>
364
 
 
365
 
<varlistentry>
366
 
<term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term>
367
 
<listitem><para>Remove applet</para></listitem>
368
 
</varlistentry>
369
 
 
 
492
-->
370
493
</variablelist>
371
494
 
 
495
<para>To change shortcuts, click with the &LMB; on the desktop <guilabel>Toolbox</guilabel> 
 
496
(the cashew usually at the top right of the desktop) and select <guilabel>Shortcut Settings</guilabel>.</para>
 
497
 
372
498
</sect1>
373
499
 
374
500
</chapter>
383
509
Program copyright 2008 &Aaron.J.Seigo; &Aaron.J.Seigo.mail;
384
510
</para>
385
511
 
386
 
<!-- ADD CONTRIBUTORS AS NEEDED
387
 
<para>
388
 
Contributors:
389
 
<itemizedlist>
390
 
<listitem><para>Konqui the KDE Dragon <email>konqui@kde.org</email></para>
391
 
</listitem>
392
 
<listitem><para>Tux the Linux Penguin <email>tux@linux.org</email></para>
393
 
</listitem>
394
 
</itemizedlist>
395
 
</para>
396
 
-->
397
 
 
398
512
<para>
399
513
Documentation Copyright &copy; 2008&ndash;2010 Sebastian Kügler <email>sebas@kde.org</email>
400
514
</para>