summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdebase/userguide/getting-started.docbook
blob: 1a89fef7871bb52afcc5f0a297e90c42ec7c9b0d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
<chapter id="getting-started">
<title
>Getting Started </title>

<epigraph>
<attribution
>Help for one of the toughest riddles in <quote
>The 7th Guest</quote
></attribution>
<para
>Using only what you see, can you get from A to B?</para>
</epigraph>

<para
>So far, you may be thinking that &kde; is little more than another window manager. Relax, and read this chapter, and we'll introduce you to some features that will assure you that &kde; is very much more than a window manager &mdash; it's a full fledged environment.</para>

<sect1 id="editing-files">
<title
>Editing Files </title>

<para
>Since you do not only have &kde; applications installed on your system, you probably know the mess of editing <abbrev
>ASCII</abbrev
> style configuration files. But in fact, there are a lot of other file types that need to be edited this way. For example, the raw &XML; source for this guide was written <abbrev
>ASCII</abbrev
> style, as was the source code for the &kde; programs themselves. We will now show you how you can use the &kwrite; facility in &kde; to edit <abbrev
>ASCII</abbrev
> files of your own. </para>

<sect2 id="the-filemanager-screen">
<title
>Opening a Window Containing Your Home Folder </title>

<para
>Click on the &ticon; button and choose <guimenuitem
>Home (Personal Files)</guimenuitem
>. A window showing the contents of your home folder will pop up. To see a more detailed listing of files in your home folder, select <guimenuitem
>Show Hidden Files</guimenuitem
> from the <guimenu
>View</guimenu
> menu.</para>

<para
>On the left hand of the window, a tree view of your file system structure should appear, while on the right hand side, you can see icons for each file in your Home folder, including any <quote
>hidden files</quote
> &mdash; files or folders beginning with a period. </para>

</sect2>

<sect2>
<title
>The File Manager Screen </title>

<para
>We tried to make the File Manager as easy as possible to use, and if you know other window managers (including those built into other Operating Systems) with integrated file management, many of the following concepts should be familiar to you.</para>

<para
>On the top, there is a <guimenu
>Location</guimenu
> menu which contains functions to open and close file manager windows. You can also print the current contents.</para>

<note
><para
>Want to visit the Internet? There are several paths you can take. You could choose <menuchoice
><guimenu
>Location</guimenu
><guimenuitem
>Open Location</guimenuitem
></menuchoice
> (or press <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
>) and enter a &URL;.</para>

<para
>The simplest way however, is to simply type in the address you want to go to in the location bar itself.</para>

<para
>For example, if you want to visit the &kde; homepage, enter <userinput
>http://www.kde.org</userinput
>. You can also quickly transfer files over &FTP; using this method. &kde; is <quote
>Internet ready</quote
>, which means that you can load and save files not only on your local hard disk, but also on remote &FTP; and other remote servers that you have write access to. While other operating systems and desktops make a distinction between local and remote file systems, &kde; does not.</para>
</note>

<para
>The <guimenu
>Edit</guimenu
> menu offers functions to select, copy and move files. We will use them later. Already having used the <guimenu
>View</guimenu
> menu, you have probably seen that you can view the content in many different ways. Just play around a bit and see what happens.</para>

<para
>You will undoubtedly find the <guimenu
>Bookmarks</guimenu
> to be extremely useful: Now you can remember virtually any link, be it on the local machine or somewhere on the Internet. &kde;'s network transparency works both ways, allowing you to treat files and folders on your hard drive as if they were Internet bookmarks.</para>

<para
>The <guimenu
>Tools</guimenu
> menu helps you find the notorious file-that-I-put-somewhere-I-do-not-remember-anymore.</para>

</sect2>

<sect2>
<title
>Navigating Through Folders </title>

<para
>We will now pick one of your configuration files and edit it. First, we must change the folder in the File Manager.</para>

<para
>&konqueror; started with your home folder as the top of the <quote
>tree</quote
>. For most day-to-day purposes, this is where you are likely to be working, so it is a practical default. Sometimes you need to see the broader picture though, so the rest of your file system is not far away.</para>

<para
>You can quickly display the <filename class="directory"
>/</filename
> or <quote
>root</quote
> folder several ways: click the small <guiicon
>folder</guiicon
> icon beside the navigation pane to switch to a full filesystem tree, use the <guiicon
>Up</guiicon
> arrow on the toolbar above to go to the top of your filesystem in the right hand pane, or type in <userinput
>/</userinput
> in the location bar.</para>

<para
>For the purpose of following this guide, press the small blue folder icon beside the navigation pane, so that the navigation pane switches to a full filesystem view. Notice that part of the tree is expanded, and your home folder is still selected. Now you can see how your home folder fits into the whole hierarchy, and your home folder files are still visible in the right hand pane.</para>

<para
>Scroll down the navigation pane on the left side of the window until you find the folder <filename
>/etc</filename
>. Double-click on <filename
>etc</filename
>. You will see a long list of files in the right window.</para>

</sect2>

<sect2 id="opening-a-file">
<title
>Opening A File </title>

<para
>Some of the files you see here are at the heart of your operating system, so making permanent changes to them require you to be the <systemitem class="username"
>root</systemitem
> or superuser. We are going to practice on a file that will not hurt anything if a mistake is made, called <filename
>motd</filename
>.</para>

<para
>Scroll down until you find the file <filename
>motd</filename
> and click on it with the <mousebutton
>right</mousebutton
> mouse button. In the <guimenu
>context menu</guimenu
>, select <guimenuitem
>Open With</guimenuitem
>. A new menu will pop up. Choose <guimenuitem
>&kwrite;</guimenuitem
>. Voila!</para>

<para
>There are many ways to open a file, and this is just one of them. &kwrite; is an editor with a simple and probably familiar interface. You could also have navigated down the small tree in the popup dialogue to the <guilabel
>Editors</guilabel
> section, and chosen another editor, or simply double click the file to open it in the default editor.</para>

<para
>In the meantime, you have the file <filename
>/etc/motd</filename
> open in &kwrite; and we're ready to do some editing.</para>

</sect2>

<sect2>
<title
>The Editor Screen </title>

<para
>The more you work with &kde;, the more you will notice that most screens and applications look and feel the same. The &kwrite; <guimenu
>File</guimenu
> menu is a great example of this. Almost every other &kde; program has the same menu, allowing you to create new files, open existing files from your local file system or (coming soon) even the web, save them (soon even on the web, too!), print it or mail it to somebody else.</para>

<para
>The <guimenu
>Edit</guimenu
> menu can also be found in most &kde; applications, allowing you to cut and paste information between programs. You can also search and replace text. Using the <guimenu
>Settings</guimenu
> Menu, you can customise the editor in many different ways. For example, you can increase the font size to suit your monitor resolution &mdash; and your eyes. Of course, as in any other &kde; application, you find a <guimenu
>Help</guimenu
> Menu, offering you on-line help whenever you need it. </para>

</sect2>

<sect2>
<title
>Using the Editor </title>

<para
>Most <filename
>motd</filename
> files contain useless stuff like <quote
>Do not forget to back up your data</quote
> or <quote
>Do not annoy the system manager</quote
>. Boring. Let's change the text so that users logging in get the really important information. You can navigate through the text using the arrow keys, and mark sections of text with <keycombo
>&Shift;<keycap
>Arrows</keycap
> </keycombo
>or by using the mouse with the <mousebutton
>left</mousebutton
> button pressed. Use the <guimenu
>Edit</guimenu
> Menu to cut and paste text. Enter whatever you want, or use the following (great) example: </para>

<screen
><userinput
>Welcome!
 
This machine now has KDE installed, providing you with a great, 
easy-to-use interface and a consistent Look-and-Feel for all your 
applications. For more information on how to get KDE running on your 
account, please email the administrator. </userinput
></screen>

</sect2>

<sect2 id="saving-files">
<title
>Saving Your Work </title>

<para
>Now that you have changed the <filename
>motd</filename
> file, it is time to save the file, putting the changes into effect. To do this, you can use either the <guimenu
>File</guimenu
> Menu, or you can use the <guiicon
>Save</guiicon
> Icon on the toolbar.</para>

<para
>At this point, reality hits us. You need to have <systemitem class="username"
>root</systemitem
> permission to save the changes to this file. &kde; handles this by asking you for the <systemitem class="username"
>root</systemitem
> password.</para>

<para
>You probably don't really want to save this file, so you can press <guibutton
>Cancel</guibutton
> in the password dialogue and <guibutton
>Cancel</guibutton
> again in the save dialogue.</para>

<para
>Finally, finish your work by closing the editor and file manager window. You can do this by clicking the <guibutton
>X</guibutton
> button on the top left of the window, by using the window menu of the title bar, or by choosing <menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Quit</guimenuitem
></menuchoice
>. Simple and elegant, isn't it? </para>

</sect2>

<sect2 id="creating-new-files">
<title
>Creating New Files</title>

<para
>As with everything in &kde;, there are several ways to create a new file. You could open up the file manager, <mousebutton
>right</mousebutton
> click on an empty space in a folder you own, and choose <menuchoice
><guisubmenu
>Create New</guisubmenu
><guisubmenu
>File</guisubmenu
><guimenuitem
>Text File...</guimenuitem
></menuchoice
>. A new empty file will appear, which you can open just like any other. You can even do this right on the desktop itself.</para>

<para
>More often you are already in an application and want to start a new file. Most &kde; applications offer a <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>New</guimenuitem
></menuchoice
> menu item, and an icon on the toolbar to complement it. A new empty document will appear that you can immediately begin working in.</para>

<para
>Both these approaches have advantages, so use the one that is most practical at the time.</para>

</sect2>

</sect1>

<sect1 id="moving-files-with-drag-and-drop">
<title
>Moving Files With Drag and Drop </title>

<para
>As you have seen in the previous section, working with files is as easy as 1-2-3. However, when you want to copy and move files, the whole copy-and-paste business can get annoying. Don't worry &mdash; a procedure called <quote
>drag and drop</quote
> allows you to copy and move files more quickly and easily. </para>

<sect2>
<title
>Opening Two File Manager Windows </title>

<para
>Before you can start, you will need to open two file manager windows. The simplest way to open a new window is to press the gear wheel button on the right of the icon bar. If you do not see the tree view in the new window, activate it (<menuchoice
><guimenu
>Window</guimenu
><guimenuitem
>Navigation Panel</guimenuitem
> </menuchoice
> or press <keycap
>F9</keycap
>).</para>

</sect2>

<sect2>
<title
>Dragging a File From One Window To Another </title>

<para
>In the first window, open the <filename
>/etc</filename
> folder and scroll until you see the <filename
>motd</filename
> file we modified in the previous section.</para>

<para
>In the second window, open your home folder.</para>

<para
>Click on the <filename
>motd</filename
> file. Hold your <mousebutton
>left</mousebutton
> mouse button and drag your file into your home folder. Release the <mousebutton
>left</mousebutton
> mouse button (this is called <emphasis
>dropping</emphasis
> the file). You will be presented up to four options: <guimenuitem
>Copy Here</guimenuitem
>, <guimenuitem
>Move Here</guimenuitem
>, <guimenuitem
>Link Here</guimenuitem
> and <guimenuitem
>Cancel</guimenuitem
>. In this example, since you are not <systemitem class="username"
>root</systemitem
>, you cannot move the file, so this option is not presented. <guimenuitem
>Link Here</guimenuitem
> will create a symbolic link to the file, while <guimenuitem
>Copy Here</guimenuitem
> and <guimenuitem
>Move Here</guimenuitem
> do exactly what they say. Select <guimenuitem
>Copy Here</guimenuitem
>. You should now have a copy of the <filename
>motd</filename
> file in your home folder. </para>

</sect2>
</sect1>

<sect1 id="using-command-line-and-terminals">
<title
>Using Command Line And Terminals </title>

<para
>So far, you have only worked with the tools and programs &kde; provides. Undoubtedly, you will want to use other &UNIX; programs as well. There are two ways of running them: The quick command line and the terminal.</para>

<sect2>
<title
>Quick Command Line </title>

<para
>Pressing <keycombo action="simul"
>&Alt; <keycap
>F2</keycap
></keycombo
> pops up a small window where you can enter a command to run. Please note that you will not see any text output generated from a program started in this manner! This method is only recommended for starting &X-Window; based programs or for running tools where you do not need to see or type anything. For other programs, you will still need to use the terminal.</para>

</sect2>

<sect2>
<title
>The &UNIX; Terminal Emulator </title>

<para
>From the application menu, choose <menuchoice
><guisubmenu
>System</guisubmenu
><guimenuitem
>Terminal</guimenuitem
> </menuchoice
>. A terminal window will open. Here you can use regular &UNIX; shell commands: <command
>ls</command
>, <command
>cat</command
>, <command
>less</command
>, and so forth. Using the <guimenu
>Settings</guimenu
> menu, you can customise the terminal emulator to suit your needs. </para>

</sect2>
</sect1>

<sect1 id="finding-your-lost-files">
<title
>Finding Your Lost Files </title>

<para
>Everyone has undoubtedly encountered the following problem: You start <command
>ftp</command
>, log into a great site like ftp.kde.org and start downloading files. It is late in the evening and you shut down your machine after completing the transfer. The next morning, you are at the keyboard again, and you start wondering into which folder you placed the recently transferred files. Using &kde;'s &kfind; utility makes finding those lost files a snap.</para>

<sect2>
<title
>Starting &kfind;</title>

<para
>Starting &kfind; is simple: Choose <guimenuitem
>Find Files</guimenuitem
> in the &kmenu;. &kfind; uses an interface part you probably have not yet met in &kde;: tabs. When &kfind; starts, you see that <guilabel
>Name/Location</guilabel
> is selected. When you click on <guilabel
>Date Range</guilabel
>, the tab content changes. Since you have never run a search before, most of the icons on the toolbar and most of the menu entries are disabled. We will change this now.</para>

</sect2>

<sect2>
<title
>Finding a File by Knowing Parts of Its Name </title>

<para
>As long as you know a bit of the file name, searching is easy. Select the <guilabel
>Name/Location</guilabel
> tab, and enter the file name in the <guilabel
>Named</guilabel
> field. Wildcards may be used as needed. As a test, type <userinput
>*.tar.gz</userinput
>. By default, the search begins in your home folder, but you can select any starting folder you wish by clicking on the <guilabel
>Look in</guilabel
> or <guibutton
>Browse...</guibutton
>. To start searching, press the <guibutton
>Find</guibutton
> button. After a moment, a list of files will appear in the search results window. If they do not appear, you started the search in the wrong folder, made a spelling mistake in the <guilabel
>Named</guilabel
> field, or no files ending with a <filename
>.tar.gz</filename
> extension are located on your machine.</para>

</sect2>

<sect2 id="finding-with-complex-criteria">
<title
>Finding a File by More Complex Criteria </title>

<para
>There are many categories you can use to make your search more precise. <emphasis
>The more you know about the file, the better are your chances of finding it</emphasis
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Date Range</guilabel
></term>
<listitem>
<para
>Here, you can specify that you only want to see files which were last touched in a given period of time. You can also specify that you only want to see files that were touched since a specified number of months or days ago.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>File Type</guilabel
> in the <guilabel
>Contents</guilabel
> tab.</term>
<listitem
><para
>If you know that the file was of a special type (&eg;, a tar/gzip archive or a jpeg picture), you can tell &kfind; to find only this type of file.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Containing text</guilabel
> in the <guilabel
>Advanced</guilabel
> tab</term>
<listitem>
<para
>You can specify text that the file must contain. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>File size is</guilabel
>, in the <guilabel
>Properties</guilabel
> tab</term>
<listitem
><para
>If you know the file size, you can limit your search in this regard, as well. </para
></listitem>
</varlistentry>
</variablelist>

<para
>&kfind; has many more options to refine searches, explore them all!</para>

</sect2>
</sect1>

<sect1 id="using-multiple-desktops">
<title
>Using Multiple Desktops </title>

<para
>Using multiple desktops helps you organise your work. You can place your programs on different desktops, and name the desktops so you know what you do there. This increases and optimises your workspace. It also helps you when you are surfing the net instead of doing your work and your boss comes in. But, of course, this is rare &mdash; at least in the office where I work. </para>

<para
>You can switch between desktops by clicking the desktop buttons on the &kicker; panel. If you want to rename them, you can do so by double-clicking on them. </para>

<para
>You can use windows on multiple desktops. If you want to have a window present everywhere, just click the sticky button on the top-left of the window. To send a window to another desktop, click on the title bar with the <mousebutton
>right</mousebutton
> mouse button, choose <guimenuitem
>To Desktop</guimenuitem
>, and select the desktop where you would like the window moved. </para>

</sect1>

<sect1 id="quitting-kde">
<title
>Quitting &kde;</title>

<para
>To quit working with &kde;, you can use the <guimenuitem
>Logout</guimenuitem
> entry in the &kmenu;. You will be asked if you really want to quit &kde;. Quitting will close all windows and return you to your console or display manager. For information on how programs can save your work during logout, please read <link linkend="kde-logout"
>the notes for logging out.</link
> </para>

</sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:("index.docbook" "book" "chapter")
End:
-->