2
<title>Common Tasks</title>
7
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
8
<!-- TRANS:ROLES_OF_TRANSLATORS -->
11
<title>Navigating Documents</title>
13
Add auto scroll feature Konqueror with KHTML/Okular/more apps here?
14
automatic scrolling with Shift+Down Arrow or Shift+Up Arrow
16
<sect2 id="nav-scroll">
17
<title>Scrolling</title>
19
<para>You're probably familiar with the scrollbar that appears on the right side
20
(and sometimes the bottom) of documents, allowing you to move within documents.
21
However, there are several other ways you can navigate documents, some of which
22
are faster and easier.</para>
24
<para>Several mice have a wheel in the middle. You can move it up and down to
25
scroll within a document. If you press the &Shift; key while using the mouse
26
wheel, the document will scroll faster.</para>
28
<para>If you're using a portable computer like a laptop, you might also be able
29
to scroll using the touchpad. Some computers allow you to scroll vertically
30
by moving your finger up and down the rightmost side of the touchpad, and allow
31
you to scroll horizontally by moving your finger across the bottommost side
32
of the touchpad. Others let you scroll using two fingers: move both fingers
33
up and down anywhere on the touchpad to scroll vertically, and move them left
34
and right to scroll horizontally. Since this functionality emulates the mouse
35
wheel functionality described above, you can also press the &Shift; key while
36
you do this to scroll faster.</para>
38
<para>If you use the &plasma-workspaces;, you can control mouse wheel behavior
39
in the <ulink url="help:/kcontrol/mouse/">Mouse module in &systemsettings;</ulink>,
40
and you can control touchpad scrolling behavior in the Touchpad module in
41
&systemsettings;. Otherwise, look in the configuration area of your operating
42
system or desktop environment.</para>
44
<para>Additionally, the scrollbar has several options in its context menu. You
45
can access these by right-clicking anywhere on the scrollbar. The following
46
options are available:</para>
50
<varlistentry id="nav-scroll-here">
51
<term><guimenuitem>Scroll here</guimenuitem></term>
52
<listitem><para>Scroll directly to the location represented by where you
53
right-clicked on the scrollbar. This is the equivalent of simply clicking on
54
that location on the scrollbar.</para></listitem>
57
<varlistentry id="nav-scroll-top">
59
<shortcut><keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo></shortcut>
60
<guimenuitem>Top</guimenuitem>
62
<listitem><para>Go to the beginning of the document.</para></listitem>
65
<varlistentry id="nav-scroll-bottom">
67
<shortcut><keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo></shortcut>
68
<guimenuitem>Bottom</guimenuitem>
70
<listitem><para>Go to the end of the document.</para></listitem>
73
<varlistentry id="nav-scroll-page-up">
75
<shortcut><keycap>PgUp</keycap></shortcut>
76
<guimenuitem>Page up</guimenuitem>
78
<listitem><para>Navigate to the previous page in a document that represents a
79
printed document, or one screen up in other types of documents.</para></listitem>
82
<varlistentry id="nav-scroll-page-down">
84
<shortcut><keycap>PgDown</keycap></shortcut>
85
<guimenuitem>Page down</guimenuitem>
87
<listitem><para>Navigate to the next page in a document that represents a
88
printed document, or one screen down in other types of documents.
92
<varlistentry id="nav-scroll-up">
93
<term><guilabel>Scroll up</guilabel></term>
94
<listitem><para>Scroll up one unit (usually a line) in the document. This is
95
the equivalent of clicking the up arrow at the top of the scrollbar.</para>
99
<varlistentry id="nav-scroll-down">
100
<term><guilabel>Scroll down</guilabel></term>
101
<listitem><para>Scroll down one unit (usually a line) in the document. This is
102
the equivalent of clicking the down arrow at the bottom of the scrollbar.</para>
110
<sect2 id="nav-zoom">
111
<title>Zooming</title>
113
<para>Many applications permit you to zoom. This makes the text or image you
114
are viewing larger or smaller. You can generally find the zoom function in the
115
<link linkend="menus-view">View menu</link>, and sometimes in the status bar
116
of the application.</para>
118
<para>You can also zoom using the keyboard by pressing
119
<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> to zoom in, or
120
<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> to zoom out. If you
121
can scroll with the mouse wheel or touchpad as described in
122
<xref linkend="nav-scroll"/>, you can also zoom by pressing &Ctrl; and scrolling
133
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
134
<!-- TRANS:ROLES_OF_TRANSLATORS -->
137
<title>Opening and Saving Files</title>
139
<sect2 id="files-intro">
140
<title>Introduction</title>
142
<para>Many &kappname; applications work with files. Most applications have a
143
<guimenu>File</guimenu> menu with options that allow you to open and save files.
144
For more information on that, see <xref linkend="menus-file"/>. However,
145
there are lots of different operations that require selecting a file. Regardless
146
of the method, all &kappname; applications generally use the same file selection
149
<screenshot id="screenshot-files-open">
150
<screeninfo>The File Open Window</screeninfo>
152
<imageobject><imagedata fileref="files-open.png" format="PNG"/></imageobject>
153
<textobject><phrase>The File Open window.</phrase></textobject>
154
<caption><para>Opening a file in
155
<ulink url="http://kde.org/applications/internet/konqueror/">&konqueror;</ulink>.
162
<sect2 id="files-ui">
163
<title>The File Selection Window</title>
165
<!--large portions of this section were taken from the "Filesystem Browser"
166
section of kate/plugins.docbook (kde-baseapps/kate_plugins.po) -->
170
<varlistentry id="files-ui-toolbar">
171
<term>The Toolbar</term>
173
<para>This contains standard navigation tool buttons:</para>
176
<varlistentry id="files-ui-toolbar-back">
177
<term><guibutton>Back</guibutton></term>
178
<listitem><para>Causes the folder view to change to the previously displayed
179
folder in its history. This button is disabled, if there is no previous item.
183
<varlistentry id="files-ui-toolbar-forward">
184
<term><guibutton>Forward</guibutton></term>
185
<listitem><para>Causes the folder view to change to the next folder in its
186
history. This button is disabled, if there is no next folder.</para></listitem>
189
<varlistentry id="files-ui-toolbar-parent">
190
<term><guibutton>Parent Folder</guibutton></term>
191
<listitem><para>This will cause the folder view to change to the immediate
192
parent of the currently displayed folder, if possible.</para></listitem>
195
<varlistentry id="files-ui-toolbar-reload">
196
<term><guibutton>Reload</guibutton> (<keycap>F5</keycap>)</term>
197
<listitem><para>Reloads the folder view, displaying any changes that have been
198
made since it was first loaded or last reloaded.</para></listitem>
201
<varlistentry id="files-ui-toolbar-show-preview">
202
<term><guibutton>Show Preview</guibutton></term>
203
<listitem><para>Displays a preview of each file inside the folder view.
207
<varlistentry id="files-ui-toolbar-zoom">
208
<term>Zoom Slider</term>
209
<listitem><para>This allows you to change the size of the icon or preview
210
shown in the folder view.</para></listitem>
213
<varlistentry id="files-ui-toolbar-options">
214
<term><guibutton>Options</guibutton></term>
218
<varlistentry id="files-ui-toolbar-options-sorting">
220
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
225
<varlistentry id="files-ui-toolbar-options-sorting-name">
227
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
228
<guimenuitem>By Name</guimenuitem>
230
<listitem><para>Sort files listed in the folder view alphabetically by name.
234
<varlistentry id="files-ui-toolbar-options-sorting-size">
236
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
237
<guimenuitem>By Size</guimenuitem>
239
<listitem><para>Sort files listed in the folder view in order of their file
240
size.</para></listitem>
243
<varlistentry id="files-ui-toolbar-options-sorting-date">
245
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
246
<guimenuitem>By Date</guimenuitem>
248
<listitem><para>Sort files listed in the folder view by the date they were last
249
modified. <!--FIXME: which date?--></para></listitem>
252
<varlistentry id="files-ui-toolbar-options-sorting-type">
254
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
255
<guimenuitem>By Type</guimenuitem>
257
<listitem><para>Sort files listed in the folder view alphabetically by their
258
file type.</para></listitem>
261
<varlistentry id="files-ui-toolbar-options-sorting-descending">
263
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
264
<guimenuitem>Descending</guimenuitem>
266
<listitem><para>When unchecked (the default), files in the folder view will be
267
sorted in ascending order. (For instance, files sorted alphabetically will
268
be sorted from A to Z, while files sorted numerically will be sorted from
269
smallest to largest.) When checked, files in the folder will be sorted in
270
descending order (in reverse).</para></listitem>
273
<varlistentry id="files-ui-toolbar-options-sorting-folders-first">
275
<guimenu>Options</guimenu><guisubmenu>Sorting</guisubmenu>
276
<guimenuitem>Folders First</guimenuitem>
278
<listitem><para>When enabled (the default), folders will appear before regular
279
files.</para></listitem>
286
<varlistentry id="files-ui-toolbar-options-view">
288
<guimenu>Options</guimenu><guisubmenu>View</guisubmenu>
293
<varlistentry id="files-ui-toolbar-options-view-short">
295
<guimenu>Options</guimenu><guisubmenu>View</guisubmenu>
296
<guimenuitem>Short View</guimenuitem>
298
<listitem><para>Displays only the filenames.</para></listitem>
301
<varlistentry id="files-ui-toolbar-options-view-detailed">
303
<guimenu>Options</guimenu><guisubmenu>View</guisubmenu>
304
<guimenuitem>Detailed View</guimenuitem>
306
<listitem><para>Displays <guilabel>Name</guilabel>, <guilabel>Date</guilabel>,
307
<guilabel>Size</guilabel> and <guilabel>Type</guilabel> of the files.</para></listitem>
310
<varlistentry id="files-ui-toolbar-options-view-tree">
312
<guimenu>Options</guimenu><guisubmenu>View</guisubmenu>
313
<guimenuitem>Tree View</guimenuitem>
315
<listitem><para>Like Short View, but folders can be expanded to view their contents.</para></listitem>
318
<varlistentry id="files-ui-toolbar-options-view-detailed-tree">
320
<guimenu>Options</guimenu><guisubmenu>View</guisubmenu>
321
<guimenuitem>Detailed Tree View</guimenuitem>
323
<listitem><para>This also allows folders to be expanded, but displays the additional columns
324
available in Detailed View.</para></listitem>
331
<varlistentry id="files-ui-toolbar-options-hidden">
334
<keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
336
<guimenu>Options</guimenu><guimenuitem>Show Hidden Files</guimenuitem>
338
<listitem><para>Displays files or folders normally hidden by your operating system.
340
Explain what is a hidden file/folder - in unix/linux with leading period/full stop character
341
Use case - user settings, operating system files in linux/unix
342
how does this work on Mac/Windows?
344
The alternate shortcut for this action is <keycap>F8</keycap>.
348
<varlistentry id="files-ui-toolbar-options-show-places">
350
<shortcut><keycap>F9</keycap></shortcut>
351
<guimenu>Options</guimenu><guimenuitem>Show Places Navigation Panel</guimenuitem>
353
<listitem><para>Displays the places panel which provides quick access
354
to bookmarked locations and disks or other media.</para></listitem>
357
<varlistentry id="files-ui-toolbar-options-show-bookmarks">
359
<guimenu>Options</guimenu><guimenuitem>Show Bookmarks</guimenuitem>
361
<listitem><para>Displays an additional icon on the toolbar that provides
362
access to <quote>bookmarks</quote>, a list of saved locations.</para></listitem>
365
<varlistentry id="files-ui-toolbar-options-show-preview">
367
<guimenu>Options</guimenu><guimenuitem>Show Aside Preview</guimenuitem>
369
<listitem><para>Displays a preview of the currently highlighted file to the
370
right of the folder view.</para></listitem>
377
<varlistentry id="files-ui-toolbar-bookmarks">
378
<term><guibutton>Bookmarks</guibutton></term>
379
<listitem><para>Opens a submenu to edit or add bookmarks and to add a new
380
bookmark folder.</para></listitem>
387
<!--adapted from dolphin documentation-->
388
<varlistentry id="files-ui-location">
389
<term>Location Bar</term>
391
<para>The location bar, which can be found on top of the folder view, displays
392
the path to the current folder. The location bar has two modes:</para>
395
<varlistentry id="files-ui-location-breadcrumb">
396
<term>Bread Crumb Mode</term>
398
<para>In the <quote>bread crumb</quote> mode, which is the default, each folder
399
name in the path to the current folder is a button which can be clicked to quickly
400
open that folder. Moreover, clicking the <quote>></quote> sign to the right of
401
a folder opens a menu which permits to quickly open a subfolder of that folder.
404
<screenshot id="screenshot-files-locationbar-breadcrumb">
405
<screeninfo>Screenshot of the location bar in bread crumb mode</screeninfo>
408
<imagedata fileref="files-locationbar-breadcrumb.png" format="PNG"/>
411
<phrase>Location bar in bread crumb mode.</phrase>
413
<caption><para>Location bar in bread crumb mode.</para></caption>
420
<varlistentry id="files-ui-location-editable">
421
<term>Editable Mode</term>
423
<para>When in bread crumb mode, clicking in the gray area to the right of the path
424
with the &LMB; switches the location bar to the <quote>editable</quote> mode,
425
in which the path can be edited using the keyboard. To switch back to bread
426
crumb mode, click the check mark at the right of the location bar with the &LMB;.
430
<screeninfo>Screenshot of the location bar in editable mode</screeninfo>
433
<imagedata fileref="files-locationbar-editable.png" format="PNG"/>
436
<phrase>Location bar in editable mode.</phrase>
438
<caption><para>Location bar in editable mode.</para></caption>
445
<!--currently in dolphin only, should be added to 4.9 file dialog
446
<varlistentry id="files-ui-location-context">
450
<para>If the <guilabel>Places</guilabel> panel is hidden; in both modes an
451
additional icon in front of the path is displayed. This icon can be clicked with
452
the &LMB; to open a menu which offers quick access to <quote>places</quote> and
453
storage media. See the <link linkend="files-ui-places">section about the Places
454
Panel</link> for details.</para>
456
<screenshot id="screenshot-files-locationbar-places-icon">
457
<screeninfo>Location bar with Places icon</screeninfo>
460
<imagedata fileref="files-locationbar-places-icon.png" format="PNG"/>
463
<phrase>Location bar with Places icon</phrase>
473
<para>The context menu of the location bar offers action to switch between the modes and
474
to copy and paste the path using the clipboard. Check the last option in this context menu to
475
display either the full path starting with the root folder of the file system or to display
476
the path starting with the current places entry.
479
<screenshot id="screenshot-files-locationbar-context-menu">
480
<screeninfo>Location bar context menu</screeninfo>
483
<imagedata fileref="files-locationbar-context-menu.png" format="PNG"/>
486
<phrase>Location bar context menu</phrase>
494
<varlistentry id="files-ui-places">
495
<term>The <guilabel>Places</guilabel> List</term>
496
<listitem><para>This provides the standard &kde; list of Places, shared with
497
&dolphin; and other file management tools.</para></listitem>
500
<varlistentry id="files-ui-folder-view">
501
<term>The Folder View</term>
503
<para>The largest part of the file selection window is the area that lists all
504
items in the current directory. To select a file, you can double-click on it,
505
or choose one and hit <guibutton>Open</guibutton> or
506
<guibutton>Save</guibutton>.</para>
508
<para>You can also select multiple files at once. To select specific files, or
509
to unselect specific files that are already selected, press and hold &Ctrl;,
510
click on each file, then release &Ctrl;. To select a
511
contiguous group of files, click the first file, press and hold &Shift;, click
512
on the last file in the group, and release &Shift;.</para>
514
<para>The Folder View supports a limited set of file operations, which can be
515
accessed by right-clicking on a file to access its context menu, or using
516
keyboard shortcuts. The following items are available in the context menu:</para>
521
<term><guimenuitem>Create New...</guimenuitem></term>
522
<listitem><para>Create a new file or folder.</para></listitem>
526
<term><guimenuitem>Move to Trash...</guimenuitem>
527
(<keycombo action="simul"><keycap>Del</keycap></keycombo>)</term>
528
<listitem><para>Move the currently selected item to the trash.</para></listitem>
532
<term><guisubmenu>Sorting</guisubmenu></term>
533
<listitem><para>This submenu can also be accessed from the toolbar, and is
534
described in <xref linkend="files-ui-toolbar-options-sorting"/>.</para></listitem>
538
<term><guisubmenu>View</guisubmenu></term>
539
<listitem><para>This submenu can also be accessed from the toolbar, and is
540
described in <xref linkend="files-ui-toolbar-options-view"/>.</para></listitem>
544
<term><guimenuitem>Open File Manager</guimenuitem></term>
545
<listitem><para>Opens the current folder in your default file manager
546
application.</para></listitem>
550
<term><guimenuitem>Properties</guimenuitem>
551
(<keycombo action="simul">&Alt;&Enter;</keycombo>)</term>
552
<listitem><para>Open the Properties window that allows you to view and modify
553
various types of metadata related to the currently selected file.</para></listitem>
560
<varlistentry id="files-ui-preview">
561
<term>The Preview Pane</term>
562
<listitem><para>If enabled, this displays a preview of the currently highlighted
563
file.</para></listitem>
566
<varlistentry id="files-ui-name">
567
<term>The <guilabel>Name</guilabel> Entry</term>
568
<listitem><para>When a file is selected, a name will appear in this text box.
569
You may also manually enter a file name or path in this text box.</para></listitem>
572
<varlistentry id="files-ui-filter">
573
<term>The <guilabel>Filter</guilabel> Entry</term>
575
<para>When opening a file, the <guilabel>Filter</guilabel> entry allows you to
576
enter a filter for the files displayed in the folder view. The filter uses
577
standard globs; patterns must be separated by white space. For instance, you can
578
enter <userinput>*.cpp *.h *.moc</userinput> to display several different
579
common &Qt; programming files.</para>
581
<para>To display all files, enter a single asterisk
582
(<userinput>*</userinput>).</para>
584
<para>The filter entry saves the last 10 filters entered between
585
sessions. To use one, press the arrow button on the right of the entry
586
and select the desired filter string. You can disable the filter by pressing
587
the <guibutton>Clear text</guibutton> button to the left of the autocompletion
590
<para>When saving a file, the <guilabel>Filter</guilabel> entry will instead
591
display a drop down box that allows you to select from all the file types the
592
application supports. Select one to save a file in that format.</para>
596
<varlistentry id="files-ui-autoselect-extension">
597
<term><guilabel>Automatically select filename extension</guilabel></term>
598
<listitem><para>When saving a file, this check box will appear. When selected
599
(the default), the application will automatically append the default file
600
extension for the selected file type to the end of the file name, if it does
601
not already appear in the <guilabel>Name</guilabel> entry. The file extension
602
that will be used is listed in parenthesis at the end of the check box label.
605
<screenshot id="screenshot-files-save">
606
<screeninfo>The File Save Window</screeninfo>
608
<imageobject><imagedata fileref="files-save.png" format="PNG"/></imageobject>
609
<textobject><phrase>The File Save window.</phrase></textobject>
610
<caption><para>Saving a file in
611
<ulink url="http://kde.org/applications/internet/konqueror/">&konqueror;</ulink>.
619
<varlistentry id="files-ui-open-save">
620
<term>The <guibutton>Open</guibutton> or <guibutton>Save</guibutton> Button</term>
621
<listitem><para>Depending on the action being performed, an
622
<guibutton>Open</guibutton> or <guibutton>Save</guibutton> button will be
623
displayed. Clicking on this button will close the file selection window and
624
perform the requested action.</para></listitem>
627
<varlistentry id="files-ui-cancel">
628
<term>The <guibutton>Cancel</guibutton> Button</term>
629
<listitem><para>Clicking <guibutton>Cancel</guibutton> will close the file
630
dialog without performing any action.</para></listitem>
637
<sect2 id="files-ack">
638
<title>Thanks and Acknowledgments</title>
640
<para>Special thanks to Google Code-In 2011 participant Alexey Subach for
641
writing parts of this section.</para>
648
<sect1 id="spellcheck">
651
<author>&David.Sweet; &David.Sweet.mail;</author>
652
<author><firstname>Salma</firstname> <surname>Sultana</surname></author>
653
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
654
<!-- TRANS:ROLES_OF_TRANSLATORS -->
657
<title>Check Spelling</title>
659
<para>&sonnet;; is the spelling checker used by &kde; applications such as &kate;,
660
&kmail;, and &kword;. It is a &GUI; frontend to various free spell checkers.</para>
662
<para>To use &sonnet; you need to install a spell checker like
663
<application>&GNU; Aspell</application>, <application>Enchant</application>,
664
<application>Hspell</application>, <application>ISpell</application> or
665
<application>Hunspell</application> and additionally the corresponding
666
dictionaries for the languages that you wish to use.</para>
668
<sect2 id="spellcheck-check">
669
<title>Check Spelling</title>
671
<screenshot id="screenshot-spellcheck-check">
672
<screeninfo>The Check Spelling Window</screeninfo>
675
<imagedata fileref="spellcheck-check.png" format="PNG"/>
678
<phrase>The Check spelling window.</phrase>
680
<caption><para>Correcting a misspelling.</para></caption>
684
<para>To check spelling, go to <menuchoice><guimenu>Tools</guimenu>
685
<guimenuitem>Spelling</guimenuitem></menuchoice>.</para>
687
<para>If a word is possibly misspelled in your document, it is displayed in the
688
top line in the dialog. &sonnet; tries to appropriate word(s) for replacement.
689
The best guess is displayed to the right of <guilabel>Replace with</guilabel>.
690
To accept this replacement, click on <guibutton>Replace</guibutton>.</para>
692
<para>&sonnet; also allows you to select a word from the list of suggestions and
693
replace the misspelled word with that selected word. With the help of the
694
<guibutton>Suggest</guibutton> button, you can add more suggestions from the
695
dictionary to the suggestions list.</para>
697
<para>Click on <guibutton>Ignore</guibutton> to keep your original spelling.</para>
699
<para>Click on <guibutton>Finished</guibutton> to stop spellchecking and
700
<emphasis>keep</emphasis> the changes made.</para>
702
<para>Click on <guibutton>Cancel</guibutton> to stop spellchecking and
703
<emphasis>cancel</emphasis> the changes already made.</para>
705
<para>Click on <guibutton>Replace All</guibutton> to automatically replace
706
the misspelled word(s) with the chosen replacement word, if they appear again in
707
your document later.</para>
709
<para>Click on <guibutton>Ignore All</guibutton> to ignore the spelling at
710
that point and all the future occurrences of the word misspelled.</para>
712
<para>Click on <guibutton>Add to Dictionary</guibutton> to add the misspelled
713
word to your personal dictionary.</para>
715
<para>The <guilabel>Personal Dictionary</guilabel> is a distinct dictionary from the
716
system dictionary and the additions made by you will not be seen by others.</para>
718
<para>The drop down box <guilabel>Language</guilabel> at the bottom of this
719
dialog allows you to switch to another dictionary temporarily.</para>
723
<sect2 id="spellcheck-auto">
724
<title>Automatic Spell Checking</title>
726
<!--FIXME:screenshot-->
728
<para>In many applications, you can automatically check spelling as you type.
729
To enable this feature, select <menuchoice><guimenu>Tools</guimenu>
730
<guimenuitem>Automatic Spell Checking</guimenuitem></menuchoice>.</para>
732
<para>Potentially misspelled words will be underlined in red. To select a
733
suggestion, right click on the word, select the <guisubmenu>Spelling</guisubmenu>
734
submenu, and select the suggestion. You may also instruct &sonnet; to ignore
735
this spelling for this document by selecting <guimenuitem>Ignore Word</guimenuitem>,
736
or you may select <guimenuitem>Add to Dictionary</guimenuitem> to save it in your
737
personal dictionary.</para>
741
<sect2 id="spellcheck-config">
742
<title>Configuring &sonnet;</title>
744
<para>To change your dictionary, go to <menuchoice><guimenu>Tools</guimenu>
745
<guimenuitem>Change Dictionary</guimenuitem></menuchoice>. A small window will
746
appear at the bottom of the current document that will allow you to change your
749
<!--FIXME: maybe move kcm handbook here too?-->
750
<para>For more information on configuring &sonnet;, see the
751
<ulink url="help:kcontrol/spellchecking">Spell Checker &systemsettings; module
752
documentation</ulink></para>
756
<sect2 id="spellcheck-ack">
757
<title>Thanks and Acknowledgments</title>
759
<para>Special thanks to Google Code-In 2011 Participant Salma Sultana for writing
760
much of this section.</para>
770
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
771
<!-- TRANS:ROLES_OF_TRANSLATORS -->
774
<title>Find and Replace</title>
777
different visual appearance, lot of common options for all Find/Search bars or windows
778
Find window used in KMail Composer, where else?
779
Search bar used e.g. in Konsole/Konqueror Views (readonly)
780
Search+Replace bar in Kate/KWrite
782
<para>The Find function of many &kappname; applications lets you find specific
783
text in a document, while the Replace function allows you to replace text that
784
is found with different text you provide.</para>
786
<para>You can find both these functions in the <guimenu>Edit</guimenu> menu of
787
many &kde; applications. For more information on this menu, see
788
<xref linkend="menus-edit"/>.</para>
790
<sect2 id="find-find">
791
<title>The Find Function</title>
793
<para>The Find function searches for text in a document and selects it.</para>
795
<screenshot id="screenshot-find-find">
796
<screeninfo>The Find Window</screeninfo>
798
<imageobject><imagedata fileref="find-find.png" format="PNG"/></imageobject>
799
<textobject><phrase>The Find window.</phrase></textobject>
800
<caption><para>Searching for <userinput>software</userinput> in
801
<ulink url="http://kde.org/applications/internet/kmail/">&kmail;</ulink>.
806
<para>To use Find in many applications, go to <menuchoice><guimenu>Edit</guimenu>
807
<guimenuitem>Find</guimenuitem></menuchoice> or press
808
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>. Then, in the
809
<guilabel>Text to find:</guilabel> text box, enter the text that you want to
812
<para>If <guilabel>Regular expression</guilabel> is checked you will be able to
813
search using regular expressions. Click on <guibutton>Edit</guibutton> to select
814
from and enter commonly used regular expression characters, like
815
<guilabel>White Space</guilabel> or <guilabel>Start of Line</guilabel>. If
816
&kate; is installed, you can find
817
<ulink url="help:/kate/regular-expressions.html">more information on writing
818
regular expressions in its documentation</ulink>.</para>
821
<para>You can limit the found results by configuring these options:</para>
825
<term><guilabel>Case sensitive</guilabel></term>
826
<listitem><para>Capital and lowercase characters are considered different. For
827
example, if you search for <quote>This</quote>, results that contain
828
<quote>this</quote> will not be returned.</para></listitem>
832
<term><guilabel>Whole words only</guilabel></term>
833
<listitem><para>By default, when the application searches for text, it will
834
return results even in the middle of other text. For instance, if you search
835
for <quote>is</quote> it will stop on every word that contains that,
836
like <quote>th<emphasis>is</emphasis></quote> or
837
<quote>h<emphasis>is</emphasis>tory</quote>. If you check this option, the
838
application will only return results when the search text a word by itself,
839
that is, surrounded by whitespace.</para></listitem>
843
<term><guilabel>From cursor</guilabel></term>
844
<listitem><para>The search will start from the location of the cursor and stop
845
at the end of the text.</para></listitem>
849
<term><guilabel>Find backwards</guilabel></term>
850
<listitem><para>By default, the application searches for the text starting at
851
the beginning of the document, and move through it to the end. If you check this
852
option, it will instead start at the end and work its way to the beginning.
857
<term><guilabel>Selected text</guilabel></term>
858
<listitem><para>Select this option to search only the text that is currently
859
selected, not the entire document. It is disabled when no text is selected.
865
<para>The Find function only selects the first match that it finds. You can
866
continue searching by selecting
867
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem></menuchoice>
868
or by pressing <keycap>F3</keycap>.</para>
870
<screenshot id="screenshot-find-found">
871
<screeninfo>Example of a Search</screeninfo>
873
<imageobject><imagedata fileref="find-found.png" format="PNG"/></imageobject>
874
<textobject><phrase>Example of a search.</phrase></textobject>
875
<caption><para>&kmail; displays a match for <userinput>software</userinput>.
882
<sect2 id="find-replace">
883
<title>The Replace Function</title>
885
<para>The Replace function searches for text in a document and replaces it with
886
other text. You can find it in many application at
887
<menuchoice><guimenu>Edit</guimenu><guisubmenu>Replace</guisubmenu></menuchoice>
888
or by pressing <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>.</para>
890
<screenshot id="screenshot-find-replace">
891
<screeninfo>The Replace Window</screeninfo>
893
<imageobject><imagedata fileref="find-replace.png" format="PNG"/></imageobject>
894
<textobject><phrase>The Replace window.</phrase></textobject>
895
<caption><para>Replacing <userinput>food</userinput> with
896
<userinput>drink</userinput> in &kmail;</para></caption>
900
<para>The window of the Replace function is separated into 3 sections:</para>
904
<term><guilabel>Find</guilabel></term>
905
<listitem><para>Here you may enter the text you wish to search for. See
906
<xref linkend="find-find"/> for more information on the options provided here.
911
<term><guilabel>Replace</guilabel></term>
913
<para>Here you may enter the text you wish to replace the found text with.</para>
915
<para>You can reuse the found text in the replacement text by selecting the
916
<guilabel>Use placeholders</guilabel> checkbox. Placeholders, sometimes known as
917
backreferences, are a special character sequence that will be replaced with all
918
or part of the found text. For instance, <quote>\0</quote> represents the
919
entire found string.</para>
920
<para> You may insert placeholders into the text box by clicking the
921
<guibutton>Insert Placeholder</guibutton> button, then selecting an option from
922
the menu like <guimenuitem>Complete Match</guimenuitem>. For example, if you are
923
searching for <quote>message</quote>, and you want to replace it with
924
<guilabel>messages</guilabel> insert the <guimenuitem>Complete Match</guimenuitem>
925
placeholder and add an <quote>s</quote>. The replace field will then
926
contain <quote>\0s</quote>.</para>
928
<para>If &kate; is installed, you can learn more about placeholders in the
929
<ulink url="help:/kate/regular-expressions.html">Regular Expressions appendix
930
of its documentation</ulink>.</para>
935
<term><guilabel>Options</guilabel></term>
936
<listitem><para>This contains all the same options that the
937
<link linkend="find-find">Find</link> function does, with one addition:</para>
938
<para>If the <guilabel>Prompt on replace</guilabel> option is checked a window
939
will appear on every found word, allowing you to confirm whether you would like
940
to replace the found text.</para></listitem>
946
<sect2 id="find-ack">
947
<title>Thanks and Acknowledgments</title>
948
<para>Thanks to an anonymous Google Code-In 2011 participant for writing much
949
of this section.</para>
958
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
959
<!-- TRANS:ROLES_OF_TRANSLATORS -->
962
<title>Choosing Fonts</title>
964
<para>The font selector appears in many different &kde; applications. It lets
965
you select the font face, font style, and font size of the text that appears in
966
your application.</para>
968
<screenshot id="screenshot-fonts">
969
<screeninfo>The Font Selector</screeninfo>
971
<imageobject><imagedata fileref="fonts.png" format="PNG"/></imageobject>
972
<textobject><phrase>The font selector.</phrase></textobject>
973
<caption><para>Selecting a font in
974
<ulink url="help:/systemsettings">&systemsettings;</ulink>.</para></caption>
981
<term><guilabel>Font</guilabel></term>
982
<listitem><para>This is the leftmost selection box, and lets you choose the
983
font face from a list of fonts on your system.</para></listitem>
987
<term><guilabel>Font style</guilabel></term>
989
<para>This is the center selection box, and lets you choose the font style from
990
the following choices:</para>
993
<listitem><para><guilabel>Italic</guilabel> - this displays text in a cursive,
994
or slanted fashion, and is commonly used for citations or to emphasize text.
997
<listitem><para><guilabel>Regular</guilabel> - the default. Text is displayed
998
without any special appearance.</para></listitem>
1000
<listitem><para><guilabel>Bold Italic</guilabel> - a combination of both
1001
<guilabel>Bold</guilabel> and <guilabel>Italic</guilabel></para></listitem>
1003
<listitem><para><guilabel>Bold</guilabel> - this displays text in a darker,
1004
thicker fashion, and is commonly used for titles of documents or to emphasize
1005
text.</para></listitem>
1012
<term><guilabel>Size</guilabel></term>
1013
<listitem><para>This is the rightmost selection box, and lets you select the
1014
size of your text. Font size is measured in <emphasis>points</emphasis>, a
1015
standard unit of measure in typography. For more information on this, see
1016
<ulink url="http://en.wikipedia.org/wiki/Point_(typography)">the <quote>Point
1017
(typography)</quote> article on Wikipedia</ulink>.</para></listitem>
1021
<term>Preview</term>
1022
<listitem><para>The bottom of the font selector displays a preview of text using
1023
the font settings that are currently selected. You may change this text if you
1024
wish.</para></listitem>
1034
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
1035
<!-- TRANS:ROLES_OF_TRANSLATORS -->
1038
<title>Choosing Colors</title>
1040
<para>The color chooser appears in many &kde; applications, whenever you need
1041
to select a color. It lets you pick from a <quote>palette</quote> consisting of many
1042
predefined colors or mix your own when you want a specific color.</para>
1044
<screenshot id="screenshot-colors">
1045
<screeninfo>The Color Selector</screeninfo>
1047
<imageobject><imagedata fileref="colors.png" format="PNG"/></imageobject>
1048
<textobject><phrase>The color selector.</phrase></textobject>
1049
<caption><para>Selecting a color in
1050
<ulink url="help:/systemsettings">&systemsettings;</ulink>.</para></caption>
1054
<sect2 id="colors-palette">
1055
<title>Using Palettes</title>
1057
<para>A palette is a set of predefined colors. You can find it on the right
1058
side of the color chooser window.</para>
1060
<para>To select a color from a palette, simply click on it. The color will be
1061
displayed below the palette, along with its &HTML; hexadecimal code and name, if
1064
<para>To switch between them, use the drop down box above the color palette.
1065
Most palettes will display a grid consisting of the colors, except for the
1066
<guilabel>Named Colors</guilabel>, which lets you select from a list of names.
1067
Other special palettes include <guilabel>* Recent Colors *</guilabel>, which
1068
will display colors that you have recently selected, and
1069
<guilabel>* Custom Colors *</guilabel>, which will display custom colors that
1070
you have saved. For more information on setting custom colors, see
1071
<xref linkend="colors-custom"/></para>
1075
<sect2 id="colors-mixing">
1076
<title>Mixing Colors</title>
1078
<para>The color chooser also lets you mix your own colors. There are several
1079
ways to do this:</para>
1081
<sect3 id="colors-mixing-select">
1082
<title>Using the Grid</title>
1084
<para>The left side of the color chooser contains a large box, and a thinner box
1085
immediately to its right. You can use the left box to select the Hue and
1086
Saturation of the desired color based on the visual guide provided in the box.
1087
The right bar adjusts the Value. Adjust these to select the desired color,
1088
which is displayed in the lower-right corner of the window.</para>
1090
<para>For more information on Hue, Saturation, and Value, see
1091
<xref linkend="colors-mixing-hsv"/></para>
1095
<sect3 id="colors-mixing-eyedropper">
1096
<title>Using the Eyedropper</title>
1098
<para>The eyedropper tool allows you to select a color from your screen. To use
1099
it, select the <guibutton>eyedropper</guibutton> button to the right of the
1100
<guibutton>Add to Custom Colors</guibutton> button, and then click anywhere on
1101
your screen to select that color.</para>
1105
<sect3 id="colors-mixing-hsv">
1106
<title>Hue/Saturation/Value</title>
1108
<para>The lower-left corner of the screen allows you to manually enter the
1109
coordinates of the desired color in the Hue/Saturation/Value
1110
(<acronym>HSV</acronym>) color space. For more information on this, see
1111
<ulink url="https://en.wikipedia.org/wiki/HSL_and_HSV">the <quote>HSL and
1112
HSV</quote> article on Wikipedia</ulink>.</para>
1114
<para>These values are also updated when selecting a color by other methods,
1115
so they always accurately represent the currently selected color.</para>
1119
<sect3 id="colors-mixing-rgb">
1120
<title>Red/Green/Blue</title>
1122
<para>The lower-left corner of the screen also allows you to manually enter the
1123
coordinates of the desired color in the Red/Green/Blue (<acronym>RGB</acronym>)
1124
color model. For more information on this, see
1125
<ulink url="https://en.wikipedia.org/wiki/RGB_color_model">the <quote>RGB color
1126
model</quote> article on Wikipedia</ulink>.</para>
1128
<para>These values are also updated when selecting a color by other methods,
1129
so they always accurately represent the currently selected color.</para>
1133
<sect3 id="colors-mixing-HTML">
1134
<title>&HTML; Hexadecimal Code</title>
1136
<para>You may enter the &HTML; hexadecimal code representing
1137
the color in the lower-right corner of the screen. For more information on this,
1138
see <ulink url="http://en.wikipedia.org/wiki/Web_colors">the <quote>Web
1139
colors</quote> article on Wikipedia</ulink>.</para>
1141
<para>This value is also updated when selecting a color by other methods,
1142
so it always accurately represents the currently selected color.</para>
1147
<sect2 id="colors-custom">
1148
<title>Saving Custom Colors</title>
1150
<para>After selecting a color, you may save it to the Custom Colors palette so
1151
you can find it later. To do so, click the
1152
<guibutton>Add to Custom Colors</guibutton> button. You can then find it by
1153
selecting the <guilabel>* Custom Colors *</guilabel> palette from the drop
1154
down box in the upper-right corner of the screen. For more information on using
1155
palettes, see <xref linkend="colors-palette"/>.</para>