dolphin/doc/konqueror/index.docbook

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&konqueror;">
  <!ENTITY package "kde-baseapps">
  <!ENTITY fsview "<application>FSView</application>">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book id="konqueror" lang="&language;"> 

<bookinfo>
<title>The &konqueror; Handbook</title>

<authorgroup>
<author>&Pamela.Roberts; &Pamela.Roberts.mail;</author>

<othercredit role="developer">
<othername>The &kde; Team</othername>
<contrib>Developers</contrib>
</othercredit> 

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2000</year> <year>2002</year>
<holder>&Erwan.Loisant;</holder>
<holder>&Pamela.Roberts;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2013-07-02</date>
<releaseinfo>&kde; 4.11</releaseinfo>

<abstract><para>&konqueror; is &kde;'s advanced File Manager, Web Browser and
 Universal Viewing Application.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Konqueror</keyword>
<keyword>Kdebase</keyword>
<keyword>File Manager</keyword>
<keyword>Browser</keyword>
<keyword>Viewer</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"> <!-- 4.11-->
<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>Overview</title>

<para><emphasis>&konqueror;</emphasis> is an advanced  
<link linkend="filemanager">file manager</link> for the 
&kde; Software compilation, providing file management functions ranging from simple 
cut/copy and paste operations to advanced local and remote network file 
browsing. Folder contents can be displayed in a variety of text and icon 
<link linkend="viewmode">view modes</link>, which can include thumbnail 
preview images of file contents. File and folder properties can easily be 
examined and changed, and applications launched with a simple click of the
&LMB;.</para>

<para>In &kde; SC 4 &dolphin; is the default file manger. To change the
default component for browsing folders, open <guimenu>Default Applications</guimenu>
in the &systemsettings; and select &konqueror; as file manager.</para>

<para><emphasis>&konqueror;</emphasis> is an <acronym>HTML</acronym> 4.01
compliant <link linkend="browser">web browser</link> with built in support for
JavaScript (ECMA-262), <acronym>CSS</acronym> (Cascading Style Sheets) and
bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure
running of &Java; applets, &Netscape; plugins for viewing &Flash;, &RealAudio; 
and &RealVideo; and <acronym>SSL</acronym> for secure
communications. Advanced features include automatic &URL; and form completion,
the ability to import bookmarks from other browsers and tabbed browsing.
</para>

<para><emphasis>&konqueror;</emphasis> is also an excellent full featured 
<link linkend="ftp">FTP</link> client.</para>

<para><emphasis>&konqueror;</emphasis> is a universal viewing application, 
capable of displaying images and documents without having to launch another 
application. It does this by embedding components (&kde; Parts) provided by 
other applications; from <application>Gwenview</application>; for image viewing, 
&okular; for <acronym>PDF</acronym>, &PostScript; and other documents.
</para>

<para><emphasis>&konqueror;</emphasis> is a fully customizable application 
which anyone can <link linkend="config">configure</link> to suit their own 
needs, from changing the overall style and the sizes of text and icons to 
selecting which items appear in the Menubar, changing the number and 
positions of the toolbars and even defining new shortcut key combinations. 
Different configuration <link linkend="save-settings">profiles</link> can be 
saved for easy recall as needed.
</para>

</chapter>

<chapter id="basics"><!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>&konqueror; Basics</title>

<important><para>Like all &kde; applications, &konqueror; is highly
 configurable. This document describes how &konqueror; behaves with the normal,
 default settings.</para>
<para> A three button mouse can be useful when you are running
&konqueror; or any other &kde; application. If your mouse only has two buttons
then you should be able to set your system up so that you can simulate a &MMB;
by pressing both buttons at the same time.</para>
<para>You can read more about mouse usage in <xref
linkend="lmb-mmb"/></para>
<para>If you are used to having to double-click to perform an action,
then take care, because in common with the rest of &kde;, &konqueror; defaults
to single-clicking.</para></important>

<sect1 id="konq-start">
<title>Starting &konqueror;</title>

<para>Being a combined File Manager and Browser,
&konqueror; will automatically
switch between the two modes as needed when it is running, but it is convenient
to be able to choose which mode is to be used when you start it up.</para>

<itemizedlist>
<!--
<listitem><para>If you have a <guiicon>house</guiicon> shaped icon on the panel 
or desktop, then <mousebutton>left</mousebutton> click on it to open 
&konqueror; as a file manager.</para></listitem>

<listitem><para>Or <mousebutton>left</mousebutton> click on <guiicon>world
</guiicon> shaped icon on the panel or desktop to open &konqueror; in browser 
mode.</para></listitem>
-->
<listitem><para>From the application launcher menu, select
<menuchoice><guisubmenu>Internet</guisubmenu><guimenuitem>Konqueror (Web
Browser)</guimenuitem></menuchoice> to start it as a browser.
</para></listitem>

<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>
will open &krunner;, enter a path to a folder and press
&Enter; to start in file manager mode, or just enter a &URL; such as
 <userinput>http://www.konqueror.org</userinput> to start &konqueror; as a
browser.</para></listitem>

</itemizedlist>

<note><para>Click on the black arrow to the right of the <guiicon>Home Page</guiicon> icon
to switch to your <guiicon>Home Folder</guiicon> in the file manager mode and vice versa.
</para></note>

<para>If &konqueror; is the default file manager it also starts automatically when you 
<mousebutton>left</mousebutton> click on a desktop icon that represents a 
folder, such as a hard disk drive or the <guiicon>Trash</guiicon> icon.
</para>


</sect1>

<sect1 id="parts">
<title>The Parts of &konqueror;</title>

<para>A brief look at the main parts of &konqueror;'s window:</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="parts.png"/></imageobject>
<textobject>
<phrase>Here's a screenshot of &konqueror;</phrase>
</textobject>
</mediaobject>

<para>The <interface>Titlebar</interface> is the strip across the top of
&konqueror;'s window, and operates in the same way as for other &kde;
applications. <mousebutton>Right</mousebutton> click on the central portion to
bring up the neat Titlebar menu.</para>

<para>The <interface>Menubar</interface> is the strip containing the names of
the drop-down menus. <mousebutton>Left</mousebutton> click on a name to 
alternately show and hide that menu, or use <keycombo 
action="simul">&Alt;<keycap>the underlined 
letter</keycap></keycombo> in the name as a hot key, for example <keycombo 
action="simul">&Alt;<keycap>E</keycap></keycombo> to show the 
<guimenu>Edit</guimenu> menu. The various menus are described in the <link 
linkend="menubar">Menubar</link> section of this document.</para>

<para>The <interface>Toolbar</interface> contains icons for commonly used
operations. <mousebutton>Left</mousebutton> clicking on an icon will activate
it. A brief description of what that icon does will appear when you hover
the pointer over it.</para>

<para>Some icons, for example the Up and Back icons in the previous screenshot,
have a small black arrow at the right. If you click with the &LMB;
at this arrow a small dropdown menu will
appear.</para> <para><mousebutton>Right</mousebutton> clicking on the
<interface>Toolbar</interface> will bring up the <link
linkend="rmb-menus"><guilabel>Toolbar Settings</guilabel> menu</link> which you can use
to change the <interface>Toolbar</interface>'s appearance and position.</para>

<para>The <interface>Location Toolbar</interface> shows the path to the
directory, &URL; or file being viewed. You can type a path or &URL; here and
press &Enter; or <mousebutton>left</mousebutton> click on the
<guiicon>Go</guiicon> icon at the right hand end of the <interface>Location
Toolbar</interface> to go to it. The black icon at the right hand end of the
<interface>Location Toolbar</interface> clears the text entry box.</para>

<para>The <interface>Bookmark Toolbar</interface> is the area under the 
<interface>Location Toolbar</interface> in the previous screenshot. You can add
frequently used bookmarks here; see the <link
linkend="orgbmark">Organizing
Your
Bookmarks</link> section of this document.</para>

<para>The <interface>Window</interface> is the main area of &konqueror; and 
can show you the contents of a directory, web page, document or image. Using 
the <link linkend="menu-window"><guimenu>Window</guimenu></link> menu you can 
split &konqueror;'s main window into one or more separate views, useful for 
drag and drop operations, or set it to contain two or more tabbed views.
</para>

<para>The <interface>Status Bar</interface> runs across the bottom of the
&konqueror;'s window
and often shows general information about whatever the mouse pointer is
hovering
over. If you have split the main window into a number of views you will get a
Status Bar for each view, and it will include a small green light at the left 
hand end to show which is the <quote>active</quote>
view. <mousebutton>Right</mousebutton> clicking on the Status Bar brings up the
Status Bar <link linkend="rmb-menus"><mousebutton>Right</mousebutton> Mouse 
Button Menu</link>.</para>

<note><para>Don't worry if your &konqueror; doesn't look exactly like this
screenshot; it is highly configurable. In particular:</para>

<itemizedlist>
<listitem><para>You can use the <link
linkend="menu-settings"><guimenu>Settings</guimenu></link> menu  to choose 
whether to show or hide the Menubar, Main Toolbar, Location Toolbar and
Bookmark Toolbar, or even to add an Extra Toolbar.</para></listitem>
<listitem><para>If the toolbars are unlocked, you can also drag them to a new position by
<mousebutton>left</mousebutton> clicking on the handle at the left hand end
of a bar and move it around by holding the &LMB; down while you
drag it. </para></listitem>
<listitem><para>This screenshot does not show the optional <link linkend="sidebar">
Sidebar</link>.</para></listitem>
</itemizedlist>

<para>For more details of how to change &konqueror;'s appearance, see the <link
linkend="config">Configuring &konqueror;</link> section</para></note>

</sect1>

<sect1 id="bubble">
<title>Tooltips and What's This?</title>

<para>You can find out a lot about how &konqueror; works without needing to
read
this entire document if you take advantage of <guilabel>Tooltips</guilabel> and
 the 
<guimenuitem>What's This?</guimenuitem> feature.</para>

<para>When you hover the mouse pointer over a Toolbar or Sidebar tab 
button it should bring up a terse description of what that button does.</para>

<para><guimenuitem>What's This?</guimenuitem> is invoked by the Menubar
<menuchoice><guimenu>Help</guimenu><guimenuitem>What's This?</guimenuitem></menuchoice> item 
or by <keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>.
It changes the cursor to show a question mark alongside the arrow.</para>

<para>When this question mark is visible, a &LMB; click won't actually do
anything until you have clicked on a control (or the text alongside it) that
supports <guimenuitem>What's This?</guimenuitem>, in which case it will
display
a reasonably comprehensive description of what the control does.
Most of the dialog boxes that &konqueror; brings up support the
<guimenuitem>What's This?</guimenuitem> feature.</para>

</sect1>

<sect1 id="lmb-mmb">
<title><mousebutton>Left</mousebutton> and <mousebutton>Middle</mousebutton>
Mouse Button Actions</title>

<para>If you click the &LMB; on an item in &konqueror;'s window, it will
 be
<quote>activated</quote>. Thus</para>

<itemizedlist>

<listitem><para><mousebutton>Left</mousebutton> click on an icon in the Toolbar
to perform the action that icon represents. </para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on an item in the Menubar
to make that menu drop down.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a menu item to do that
thing.</para></listitem> 
<listitem><para><mousebutton>Left</mousebutton> click on an icon in the
Bookmark
 Toolbar
to open that &URL;.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a link in a web page 
to make &konqueror; follow that link.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a folder icon or 
name and &konqueror; will descend into (show the contents of) that folder.
</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a file name or icon 
and &konqueror; will do whatever it thinks appropriate, based on the file type. 
In general this means opening <acronym>HTML</acronym> pages, or previewing 
text, image or 
&okular; documents, showing them within &konqueror;'s
window (<quote>Preview</quote> means that you can see the file but not change
it).</para> 

<para>&konqueror; decides what the file type is by matching the filename
extension against a list of known types. If that fails it tries to guess
the type from the file contents. You can change the list of known file types
and associated actions with the <guilabel>File Associations</guilabel> page of 
the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
</guimenuitem></menuchoice> dialog.</para></listitem>

</itemizedlist>

<para>Clicking the &MMB; on a file or folder name or icon does essentially the
same as <mousebutton>left</mousebutton> clicking except that it usually does it
in a new &konqueror; window, unless the <guilabel>Open links in new tab instead
of in new window</guilabel> box has been checked in the
<guimenuitem>General</guimenuitem> page of the
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Konqueror...</guimenuitem></menuchoice> dialog. &konqueror; can open
links on pages and <menuchoice><guimenu>Bookmarks</guimenu></menuchoice>,
as well as the
<guibutton>Home</guibutton>, <guibutton>Up</guibutton>,
<guibutton>Back</guibutton> and <guibutton>Forward</guibutton>
entries in a new tab or window.</para>

<para>Holding the &Shift; key down while pressing the &MMB; will open the link 
in the background.</para>
<!-- not in 4.4.0
<important><para>If you click the &MMB; when the mouse cursor is over a blank 
part of the main view (not over a link or file name or icon) &konqueror; will 
copy the contents of the clipboard into the Location Toolbar and try to use 
that as a &URL;.</para></important>
-->
</sect1>

<sect1 id="rmb-menus">
<title><mousebutton>Right</mousebutton> Mouse Button Menus</title>

<para>Clicking the &RMB; on almost any part of &konqueror;'s window
will bring up an appropriate context menu.</para>

<note><para>If you have enabled the <guilabel>Right click goes back in 
history</guilabel> option in &konqueror;'s <link linkend="othersettings">
configuration</link> settings a
simple <mousebutton>right</mousebutton> click is equivalent to clicking on the 
<guibutton>Back</guibutton> button. In this case you can access the context 
menu by moving the mouse with the <mousebutton>right</mousebutton> button held 
down.</para></note>

<variablelist>

<varlistentry>
<term>On the Titlebar</term>
<listitem><para><mousebutton>Right</mousebutton> clicking on any free area of
the Titlebar brings up the Titlebar Menu, allowing you to control the position
of &konqueror;'s window as well as the decoration applied to all &kde; program
windows. </para></listitem>
</varlistentry>

<varlistentry>
<term>On the Main Toolbar</term>
<listitem><para><mousebutton>Right</mousebutton> click on any free area of the
Toolbar to bring up the Toolbar Menu.  You can use it to control whether the
Toolbar is at the top, bottom, left or right of &konqueror;'s window.
You can also use the Toolbar Menu to set the size of the buttons on the
Toolbar,
and whether they are shown as icons, text or both.</para></listitem> 
</varlistentry>

<varlistentry>
<term>On the Location Toolbar</term>
<listitem><para><mousebutton>Right</mousebutton> click in the
 &URL;
entry box area to perform Cut, Copy, Paste or Clear operations in this area, or
to change the automatic <link linkend="path-complete">Text Completion</link>
features.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Within a View</term>
<listitem><para>If you <mousebutton>right</mousebutton> click on any free area
of a view then you will get a menu that contains, among other options, the
 <guiicon>Up</guiicon>,
<guiicon>Back</guiicon>, <guiicon>Forward</guiicon> and
<guiicon>Reload</guiicon> navigation commands.
 </para></listitem>
</varlistentry>

<varlistentry>
<term>On a File or Folder</term>
<listitem><para>This is a most useful feature. <mousebutton>Right</mousebutton>
clicking on the name or icon of any file or folder not only
<quote>selects</quote> that item but also brings up a menu allowing you to
<guimenuitem>Cut</guimenuitem>, <guimenuitem>Move</guimenuitem>, <guimenuitem>Copy</guimenuitem> or <guimenuitem>Remove</guimenuitem> the item in
various ways, open it with the program of
your choice or preview it, rename it, or edit the file type or 
properties.</para></listitem> </varlistentry>

<varlistentry>
<term>On the Status Bar</term>
<listitem><para><mousebutton>Right</mousebutton> click on the Status Bar at the
bottom of a window or view to add or remove a view within &konqueror;'s
window.</para></listitem> 
</varlistentry>
<!--FIXME Split / Lock to Current Location / Close 
#: src/konqmainwindow.cpp:4000
msgid "A locked view cannot change folders. Use in combination with 'link view' to explore many files from one folder"
#: src/konqmainwindow.cpp:4001
msgid "Sets the view as 'linked'. A linked view follows folder changes made in other linked views."
-->
</variablelist>

</sect1>

<sect1 id="man-info">
<title>Viewing Help, Man and Info Pages</title>

<para>You can view &kde; Help and &UNIX; Man and Info pages directly in 
&konqueror;, without having to start up <application>KHelpCenter</application>.
</para>

<para>To view a &kde; Help page, enter
<userinput>help:/<replaceable>application name</replaceable></userinput> (for
example <userinput>help:/kmail</userinput> to view the &kmail; documentation.)
into &konqueror;'s Location Toolbar window.
</para>

<para>
If you want to read &UNIX; Man pages &konqueror; makes it easy. For 
example type <userinput>man:/touch</userinput> or 
<userinput>#touch</userinput> into the Location Toolbar to see the page for 
the <command>touch</command> command.</para> 

<para>To browse through &UNIX; Info pages, entering
<userinput>info:/dir</userinput> takes you to Info's top level directory, then
it's just a matter of clicking on the right links to find the page you
want. Alternatively, use <userinput>info:/<replaceable>command
name</replaceable></userinput> to go straight to the Info page you want.</para>

<note><para>Unfortunately, &kde; Help pages are stored in such a way that they 
cannot be viewed in other browsers. If you really need to do this your only 
recourse is to go online and visit <ulink url="http://docs.kde.org">
http://docs.kde.org</ulink>.</para></note>
</sect1>

</chapter>

<chapter id="filemanager"> <!-- 4.11-->
<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup> 

</chapterinfo>

<title>&konqueror; the File Manager</title>

<sect1 id="dirfolders">
<title>Folders and Paths</title>
<para>In &UNIX; and &Linux; all folders are arranged in a simple 
hierarchy. Starting from a top level folder (also called the root directory), 
the structure descends and branches containing various files and subfolders. 
This means that you can get from any folder to any other by going <quote>up
</quote> until you reach a common point then <quote>down</quote> through 
the appropriate subfolders until you reach your target.</para>

<para>The position of any file or folder in the structure (also called a 
directory tree) can be described by its <quote>path</quote>, which is a simple 
list of the folders you would have to descend through to get to the target 
folder or file. For example <filename class="directory">/home/pam</filename> 
is the subfolder <filename class="directory">pam</filename> of the subfolder 
<filename class="directory">home</filename> of the top level folder, and 
<filename>/home/pam/words.txt</filename> is the file <filename>words.txt
</filename> in that subfolder. The leading <quote>/</quote> in these paths 
represents the top level folder.</para>

<para>Every folder accessible by your system &mdash; including those on
other hard disk partitions, a USB device or &CD-ROM; &mdash; will appear
in the tree descending from /, their exact paths will depend on how your system
was set up (see also the section on <link linkend="removable-devices">Removable Devices</link>).
</para>
<para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote> 
folder to hold their personal files and settings; for example
<filename class="directory">/home/john</filename> and  
<filename class="directory">/home/mary</filename>. The 
symbol <keycap>~</keycap> is often used to represent the user's home 
folder, so that <filename>~/letter.txt</filename> refers to the file 
<filename>letter.txt</filename> in my home folder.</para>
<para>Note that the term <quote>directory</quote> is often used instead of 
<quote>folder</quote>.</para>
</sect1>

<sect1 id="viewmode">
<title>View Modes</title>
<para>In File Manager mode, &konqueror; lists which files and subfolders are
contained within a given folder and can provide you with some information about
them. The <quote>path</quote> of the current folder is shown in the Location
Toolbar. The way that &konqueror; displays the files and folders depends mainly
on your choice of view mode which can be selected from the
<menuchoice><guimenu>View</guimenu><guisubmenu>View
Mode</guisubmenu></menuchoice > sub menu. The view modes &konqueror; provides
are outlined below.
</para>

<note><para>In File Manager mode, &konqueror; uses an embedded &dolphin;  
component.</para></note>
<!-- begin copy from dolphin docbook synced for 4.11--> 
<itemizedlist>

<listitem><para>
In the <guibutton>Icons</guibutton> view, which is the default, files will be
represented by an icon that visualizes the file type, and a folder icon will be
shown for subfolders. The names of folders and files, and the items enabled in
<menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice>,
are displayed below the icons.
</para></listitem>

<listitem><para>
The <guilabel>Compact</guilabel> view shows the folder contents as icons with 
the name beside it and the items enabled in
<menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice> 
below the name. The items are grouped in columns similar to the <guilabel>Short View</guilabel> 
in the &kde; file dialog.
</para></listitem>

<listitem><para>
In the <guibutton>Details</guibutton> view, the folder contents are displayed
as a detailed list which contains the name, size and last modification time of
each item. Additional columns can be added by clicking a column header with the
&RMB;.
</para>
<para>In the context menu of the header line you can choose between custom or automatic 
column width. Automatic width adjusts the width of all columns once to display the longest 
item in the column completely, except for the <guilabel>Name</guilabel> column where 
the extension is replaced by <quote>...</quote> 
</para>
<para>The order of columns can be changed by drag and drop of column headers, except for
the <guilabel>Name</guilabel> header, which is always the first column in this view.
</para>
<para>
The details view allows you to view the current directory in a tree-like fashion if
<guilabel>Expandable folders</guilabel> are enabled: 
Each subfolder of the current folder can be
<quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>&gt;</guiicon>
or <guiicon>v</guiicon> icon next to it.</para></listitem>
</itemizedlist>

<screenshot>
<screeninfo>Grouped View</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="grouping-view.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Grouped View</phrase>
</textobject>
<caption><para>All view modes support grouping by the sort type selected 
in <menuchoice><guimenu>View</guimenu><guisubmenu>Sort by</guisubmenu></menuchoice></para></caption>
</mediaobject>
</screenshot>
<!-- end copy from dolphin docbook synced for 4.11 --> 

<sect2 id="filetipinfo">
<title>File Tip Info</title>
<para>Checking the <guilabel>Show tooltips</guilabel> box in the <menuchoice>
<guimenu>File Management</guimenu><guimenuitem>General</guimenuitem></menuchoice> 
page of the &konqueror; Configuration dialog causes a 
small pop up information window to appear when the mouse pointer is hovered over
a file or folder name or icon. 
</para>
</sect2>

<sect2 id="previews">
<title>File Previews</title>
<para>The <guilabel>Previews</guilabel> tab of the <menuchoice><guimenu>File Management</guimenu>
<guimenuitem>General</guimenuitem></menuchoice> settings page 
lets you enable file previews for certain types of file.</para>
<para>Generally this means that the file's icon will be replaced by a small 
image showing the file contents.</para>
<para>Because &konqueror; has to read much more data than just the file name 
to generate a preview, file previews may not be appropriate when viewing 
files from a remote system. To disable previews for remote files where reading 
the extra data would take too long set a file size limit at the bottom of the 
<guilabel>Previews</guilabel> tab.</para>
</sect2>

<!-- begin copy from dolphin docbook synced for 4.11--> 
<sect2 id="dolphin-view-information">
<title>Information in the View</title>
<para>
In all view modes &kappname; shows at least an icon and a name for each item. 
Using <guisubmenu>Additional Information</guisubmenu> in the <guimenu>View</guimenu> 
menu or the context menu of the header in <guilabel>Details</guilabel> mode, you can select
more information for each item to be shown:
</para>

<para>
<guimenuitem>Size</guimenuitem>, <guimenuitem>Date</guimenuitem>,
<guimenuitem>Type</guimenuitem>, <guimenuitem>Rating</guimenuitem>,
<guimenuitem>Tags</guimenuitem> or <guimenuitem>Comment</guimenuitem>.
</para>

<para>Depending on the file type, additionally, sorting criteria can be selected:
<simplelist>
  <member><guimenuitem>Document</guimenuitem>: Number of words and lines</member>
  <member><guimenuitem>Image</guimenuitem>: Size and orientation</member>
  <member><guimenuitem>Audio</guimenuitem>: Artist, album, duration and track</member>
</simplelist>
</para>

<para>The <guisubmenu>Other</guisubmenu> submenu allows to select 
<guimenuitem>Path</guimenuitem>, <guimenuitem>Link Destination</guimenuitem>, 
<guimenuitem>Copied From</guimenuitem>,
<guimenuitem>Permissions</guimenuitem>, <guimenuitem>Owner</guimenuitem> or 
<guimenuitem>User Group</guimenuitem>.
</para>

</sect2>
<!-- end copy from dolphin docbook synced for 4.11 --> 
</sect1>

<!-- begin copy from dolphin docbook synced for 4.11--> 
<sect1 id="view-properties">
<title>Folder View Properties</title>

<para>
The following settings control how the contents of a folder are displayed in the
&kappname; view, and are stored on a per-folder basis by default:
</para>
<itemizedlist>

<listitem><para>
The view mode (Icons, Compact, Details)
</para></listitem>

<listitem><para>
The sorting of items, which is determined by the sort order (ascending,
descending) and the attribute (such as name, size,...) that the items are
sorted by
</para></listitem>

<listitem><para>
Sorting of folders and files &ndash; are folders shown first or not?
</para></listitem>

<listitem><para>
Previews &ndash; are they shown instead of icons (based on the settings made in
<guilabel>Previews</guilabel> tab of &kappname;'s General settings) or not?
</para></listitem>

<listitem><para>
Are items shown in groups in the views?
</para></listitem>

<listitem><para>
Are hidden files shown?
</para></listitem>

<listitem><para>
What additional information (besides the name) is shown in the Icons or Details view?
</para></listitem>

</itemizedlist>
<para>
The view properties can be configured in the
<menuchoice><guimenu>View</guimenu></menuchoice> menu, some (such as the view
mode) can also be changed using toolbar buttons.
</para>

<sect2 id="view-properties-dialog">
<title>The View Properties Dialog</title>

<para>

<screenshot>
<screeninfo>Screenshot of the View Properties dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="viewproperties-dialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The View Properties dialog.</phrase>
</textobject>
<caption><para>The View Properties Dialog.</para></caption>
</mediaobject>
</screenshot>

The <guilabel>View Properties</guilabel> dialog can be used to quickly modify
several view properties at once. This is done for the current folder, for the
current folder including all subfolders, or even for all folders, depending on
the choice made in the <guilabel>Apply View Properties To</guilabel> section.
</para>

<para>
If <guilabel>Use these view properties as default</guilabel> is enabled, the chosen view
properties will also be used for all folders which do not have customized view
properties yet.
</para>

</sect2>

</sect1>
<!-- end copy from dolphin docbook  synced for 4.11-->
<sect1 id="navigation">
<title>Navigation</title>
<para>To get to a file with &konqueror; you first need to navigate 
through the folder tree to find the folder containing that 
file.</para>

<para>To move between folders you can simply step up and down the
tree:</para>

<itemizedlist>
<listitem><para>To descend into a subfolder <mousebutton>left
</mousebutton> click on its name or
icon -- or if you have already <quote>selected</quote> it (see below) -- then just press
&Enter;.</para></listitem> 
<listitem><para>To go up the folder tree you can click on the <guiicon>Up</guiicon> 
button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up</keysym></keycombo>, or use the Menubar
<menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice>
option.</para></listitem>
</itemizedlist>

<para>To <quote>select</quote> a file or folder in the displayed folder 
without opening it in any way use the <keysym>up</keysym> and <keysym>down
</keysym> arrow keys to move through the items. 
The selected item will be highlighted and some information about it 
will be displayed in the Status Bar.</para>

<para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem>
Details</guimenuitem> can help you locate folders in the tree below the 
current folder; in this mode each folder is shown with a small box at 
the left. If the box contains a <keycap>&gt;</keycap> sign, <mousebutton>left
</mousebutton> clicking on the box (not on the folder name or icon) will 
display a sub tree showing files and subfolders contained in that folder. 
The small box will then change to show a <keycap>v</keycap> sign. 
<mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once 
you have found the folder you are looking for, <mousebutton>left
</mousebutton> click on the folder name or icon to open it.</para>

<para>The <link linkend="sidebar">Sidebar</link> can also help you 
find your way around the file system.</para>

<para>You can go directly to any folder by switching with 
 <menuchoice><guimenu>File</guimenu><guimenuitem>Open Location</guimenuitem>
</menuchoice> or <keycombo action="simul">&Alt;<keycap>O</keycap>
</keycombo> to the Location Bar and typing its path.
&konqueror;'s <link linkend="path-complete">
Text Completion</link> feature may be useful when you do this. Don't forget
that in &Linux; / &UNIX; file and folder names are case sensitive.</para>

<para>When you have moved to a new folder you can go back to your
previous choice by using the Toolbar <guiicon>Back</guiicon> button, the
Menubar
<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
item, or <keycombo action="simul">&Alt;<keysym>Left</keysym></keycombo>. 
Once you have gone back you can go forward. Use the Toolbar
<guiicon>Forward</guiicon> button, the Menubar
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo
action="simul">&Alt;<keysym>Right</keysym></keycombo>.</para>

<para>Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo
action="simul">&Alt;<keysym>Up</keysym></keycombo>.</para>

<tip><para>Click the checkmark at the right of the toolbar <guiicon>Up</guiicon>, 
<guiicon>Back</guiicon> or <guiicon>Forward</guiicon> buttons or selecting these 
items in the <guimenu>Go</guimenu> menu brings up a submenu of recently visited locations.</para>
</tip>
<!-- 4.11 -->
<sect2 id="file-find">
<title>Finding Files and Folders</title>

<para>If you don't know or can't remember where a file or folder is within
your system, then use the shortcut <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> or the
Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find 
File...</guimenuitem></menuchoice> option.  This starts the file finder
application &kfind;. See the <ulink url="help:/kfind/index.html">&kfind; Handbook</ulink> 
for help in using &kfind;.
</para>

<note><para>If the name of a file or folder begins with a period (dot), then
it is a <quote>hidden</quote> file or folder, and will not normally be shown
by &konqueror;. To see hidden files or folders use the Menubar <menuchoice>
<guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem>
</menuchoice> option.</para>

<para>Another reason &konqueror; may not show the file or folder you are 
looking for is that you may have the <link linkend="konq-plugin"><guisubmenu>
View Filter</guisubmenu></link> plugin set to display only certain types of 
file.</para>
</note>

</sect2>

<sect2 id="removable-devices">
<title>Removable Devices</title>

<para>Any removable device (USB stick, floppy disk, &CD; drive or other hard disk partition that you have 
on your system) will usually appear in the <filename class="directory">/
</filename>,  <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or 
<filename class="directory">/auto</filename> folder, having a path something 
like <filename class="directory">/mnt/floppy</filename> or
<filename class="directory">/cdrom</filename>. The details will depend on
how your system was set up.</para>

<para>&UNIX; / &Linux; requires that you <command>mount</command> a removable device
when you have inserted it into the drive, and <command>mount
</command> other hard disk partitions when you want to access them. You also 
need to unmount a removable device before removing it to register that 
it is no longer available.</para>

<para>How you do this will depend on your system setup:</para>

<itemizedlist>

<listitem><para>Using the <guilabel>Device Notifier</guilabel></para>
<para>In a &kde; session the <ulink 
url="help:/plasma-desktop/index.html#device-notifier">Device Notifier</ulink> 
window will popup, when you insert a removable device and allows you to select 
an appropriate application for this media or only mount the device.</para>
</listitem>
<listitem><para>If you use the <guilabel>Folder View</guilabel> layout for your desktop
you may have icons for removable devices on your desktop, 
in which case &LMB; click on the icon to mount it. 
Doing this should also bring up a &konqueror; window showing the contents of 
the device. To unmount, <mousebutton>right</mousebutton> 
click on the icon and choose the <guimenuitem>Unmount</guimenuitem> item.  
Visit the section <link linkend="making">Create New...</link> in this Handbook 
to see how to create such an icon.</para></listitem>

<listitem><para>Or you can do it the traditional way by typing into a text
console window:</para>
<para><userinput><command>mount /mnt/floppy</command></userinput></para>
<para>to mount, for example, the floppy drive, and</para>
<para><userinput><command>umount /mnt/floppy</command></userinput></para>
<para>to unmount it (<command>umount</command> not <command>unmount</command>).
</para>
<note><para>Rather than having to open a text console to type the
<command>mount
</command> or <command>umount</command> commands, you may prefer to use
&konqueror;'s <menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell
Command</guimenuitem></menuchoice>
(<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>)
 feature.
</para></note>

</listitem>

</itemizedlist>
</sect2>

</sect1>
<!-- 4.11-->
<sect1 id="deleting">
<title>Deleting Files and Folders</title>

<para>&konqueror; gives you two ways to dispose of an unwanted file or
folder:</para>

<itemizedlist>
<listitem><para>You can move it to the <filename>Trash</filename> folder, which
is the safest method as you can get it back if you realize that you have made a
mistake.</para></listitem> 

<listitem><para>You can just plain Delete it, which
removes the entry from the folder and adds the disk area occupied by the
file(s) to the system's list of free disk areas, in the same way as the
<command>rm</command> command.</para>
<para>If you want to use this feature check the option <guilabel>Show 'Delete' 
menu entries which bypass the trashcan</guilabel> on the <guilabel>File 
Management</guilabel> settings page.</para></listitem>
</itemizedlist>

<para>The simplest way to remove a file or folder is to position
the mouse pointer over its name or icon and press the &RMB;, which
will bring up a menu containing the options <guimenuitem>Move to
Trash</guimenuitem> and <guimenuitem>Delete</guimenuitem>.</para>

<para>Or, if you have <quote>selected</quote> the item, the Menubar
<guimenu>Edit</guimenu> menu will give you the choice of
<quote><guimenuitem>Move to Trash</guimenuitem></quote> and
<quote><guimenuitem>Delete</guimenuitem></quote> options.</para>

<para><keycap>Del</keycap> will move the selected item or items to Trash.</para>

<para><keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
will really, truly and irrevocably delete the selected item or
items.</para>

<note><para>You won't be able to remove a file or folder if you don't have
the necessary permissions<!--; see the section on <link linkend="super-user">Super
  User Mode</link> for further details-->.</para></note>

</sect1>
<!-- 4.11-->
<sect1 id="moving">
<title>Moving and Copying</title>

<para>To copy a file or subfolder between folders you can:</para>

<itemizedlist>
<listitem><para>Position the mouse pointer over its name or icon and hold down
the &RMB;, which will bring up a menu containing the
<guimenuitem>Copy</guimenuitem> option. Choose that.</para>

<para>Or if the item is <quote>selected</quote> you can use the
<guiicon>Copy</guiicon> button on the Toolbar or the Menubar
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem></menuchoice>
item, or the <keycombo
action="simul">&Ctrl;<keycap>C</keycap></keycombo> 
shortcut key combination. You can also select <link linkend="selection">multiple</link> 
files or folders to copy/move as well.</para></listitem>

<listitem><para>Navigate to the folder you want to copy the item into then
Paste the item into the new folder by using the Toolbar
<guiicon>Paste</guiicon> button or the Menubar
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo> shortcut, or by
moving the mouse pointer to a clear area of the window and holding the &RMB;
down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option.
</para></listitem>
</itemizedlist>

<para>Moving a file or subfolder between folders can be done in the
same
way as copying, except that you choose the <guimenuitem>Cut</guimenuitem>
option
or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
instead of <guimenuitem>Copy</guimenuitem>. The item that you have
<guimenuitem>Cut</guimenuitem> will be removed from the original folder when
you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para>

<para>You can also copy or move selected item(s) to another folder by selecting
<guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from
the context menu you get when you <mousebutton>right</mousebutton> click on
a file or folder name in the File Manager window.</para>
<para>To enable this feature select <guilabel>Show 'Copy To' and 'Move To' 
commands</guilabel> on the <menuchoice><guimenu>File Management</guimenu>
<guimenuitem>Services</guimenuitem></menuchoice> page of the settings.</para>
<note><para>You may not be able to copy or move a file or folder if
you don't have the necessary permissions. <!--See the section on <link
linkend="super-user">Super User Mode</link> for further
  details.--></para></note>
<!-- 4.11-->
<sect2 id="dnd">
<title>Using Drag 'n Drop</title>

<para>&konqueror; also supports Drag and Drop copying and moving of files and
folders.</para>

<para>You can do this by having two instances of &konqueror;, one showing the 
folder you want to copy from, the other showing the target folder. 
Position the mouse pointer over the item you wish to copy or move, then, 
holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the
target folder. Release the button and you will be
presented with a menu choice of <guimenuitem>Copy Here</guimenuitem>, 
<guimenuitem>Move Here</guimenuitem> or <guimenuitem>Link Here</guimenuitem>. 
Take care to <quote>drop</quote> the item into an empty area of the target
folder view - dropping it on top of a subfolder will copy or move the item
into that folder.</para>

<para>You can also set up &konqueror; to show more than one folder within
its window and drag &amp; drop between them.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject>
<textobject>
<phrase>Split Views for Drag &amp; Drop</phrase>
</textobject>
</mediaobject>

<para>This screenshot illustrates the use of the Menubar
<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
Left/Right</guimenuitem></menuchoice> option, also available with the shortcut 
<keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo>,
to split the main &konqueror; window into two views, each showing the contents
of a different folder.</para>

<para>To be able to show different folders in each view they should not be 
linked; the little boxes at the bottom right of each view should be empty.
</para>

<para>The <quote>active</quote> view, that is the one whose path is shown in
the Location Toolbar and which responds to navigation and Menubar commands, is
shown by the little green light in the bottom left corner. To make a view
active, <mousebutton>left</mousebutton> click on an empty area of the view or
on its Status Bar.</para>

<para>To remove an active view from &konqueror;'s window use the <keycombo
action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo> shortcut, 
or the Menubar <menuchoice><guimenu>Window</guimenu><guimenuitem>Close
Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar
and choose the <guimenuitem>Close View</guimenuitem> option from the
resulting menu.</para>

<para>If you use &konqueror; tabs, you can drag and drop between tabs
by dragging the file to the tab label, without letting go yet.  The
destination tab will pop to the front, allowing you to continue
dragging and then to drop the file.</para>

</sect2>
<!-- 4.11-->
<sect2 id="dups">
<title>Duplicate File or Folder Names</title>
<para>If you try to paste a file or folder into a folder that already 
contains an item with the same name, &konqueror; will pop up a dialog box warning 
you that the item already exists. You can then choose to:
</para>
<itemizedlist>
<listitem><para>Cancel the paste operation by pressing the 
<guibutton>Cancel</guibutton> button.</para></listitem>
<listitem><para>Give the item that is being copied a different name. You can 
do this by typing a new name into the text entry box or get &konqueror; to 
<guibutton>Suggest New Name</guibutton>. When you have done this press the 
<guibutton>Continue</guibutton> button.</para></listitem>
<listitem><para>
If you have copied multiple items, <guibutton>Skip</guibutton> the current item. 
</para></listitem>
</itemizedlist>
<para>The <guibutton>Apply to All</guibutton> button can be used if you have copied 
multiple items.</para>
</sect2>
</sect1>
<!-- begin copy from dolphin docbook synced for 4.11-->
<sect1 id="selection">
<title>Selecting Items in the View</title>

<para>
There are several ways to select items in the view. Once a group of items
is selected, all actions, such as
<menuchoice><guimenuitem>Cut</guimenuitem></menuchoice>,
<menuchoice><guimenuitem>Copy</guimenuitem></menuchoice>,
<menuchoice><guimenuitem>Move to Trash</guimenuitem></menuchoice>,
and drag and drop operations, affect all selected items.
</para>

<sect2 id="selection-mouse">
<title>Selecting Items Using the Mouse</title>

<itemizedlist>

<listitem><para>
You can press the &LMB; somewhere in the view and draw a rectangle around
a group of items before releasing the button. This will select all items in the
rectangle and clear the previous selection. If the &Shift; key is pressed during
the selection process, the previous selection is kept.
</para></listitem>

<listitem><para>
If the &Ctrl; key is pressed while an item is clicked with the &LMB;, the
selection state of this item is toggled. If the &Ctrl; key is pressed while a
rectangle is drawn around a group of items as described above, the selection
state of all items in the rectangle will be toggled.
</para></listitem>

<listitem><para>
If the &Shift; key is pressed while an item is clicked with the &LMB;, all items
between the previous current item and the clicked item will be selected.
</para></listitem>

<listitem><para>
If <guilabel>Show selection marker</guilabel> is enabled in the
<guilabel>Behavior</guilabel> tab of the <menuchoice><guimenu>File Management</guimenu>
<guimenuitem>General</guimenuitem></menuchoice> section of the settings, a small
<guiicon>+</guiicon> or <guiicon>-</guiicon> button appears in the top
left corner of the item which is currently hovered over with the mouse. Clicking
this sign selects or deselects the item, respectively.
</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="selection-keyboard">
<title>Selecting Items Using the Keyboard</title>

<itemizedlist>

<listitem><para>
If an arrow key, <keycap>Page Up</keycap>, <keycap>Page Down</keycap>,
<keycap>Home</keycap>, or <keycap>End</keycap> is pressed, the new current item
is selected, and the previous selection is cleared.
</para></listitem>

<listitem><para>
If the &Ctrl; key is held while one of the above keys is pressed, the selection
remains unchanged.
</para></listitem>

<listitem><para>
If the &Shift; key is held while one of the above keys is pressed, all items
between the previous current item and the new current item will be selected.
</para></listitem>

<listitem><para>
If <keycombo action="simul">&Ctrl;<keysym>Space</keysym></keycombo> is pressed,
the selection state of the current item is toggled.
</para></listitem>

<listitem><para>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> selects all items
in the view.
</para></listitem>

<listitem><para>
<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo> toggles the
selection state of all items in the view.
</para></listitem>

<listitem><para>
Select a file or folder by typing the first few letters of its name and the 
first matching item is selected. 
To clear the selection and cancel the keyboard search press &Esc; or wait longer than
the timeout of 1 second.
</para></listitem>
</itemizedlist>
<!-- end copy from dolphin docbook-->

</sect2>

<!-- selection via menu different in dolphin-->
<sect2 id="selection-menu">
<title>Selecting Items Using the Menu</title>

<para>You sometimes want to delete, copy or move a number of files that are 
similar in some way. For example you may wish to move all of the .png graphics 
files from one folder to another. &konqueror; makes this easy by letting you 
select multiple files based on similarities in their file names.</para>

<para>Use the Menubar
<menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
<guimenuitem>Select Matching Items...</guimenuitem></menuchoice> option or the shortcut
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>. This
brings up a little dialog box in which you enter a filename containing
the wildcard characters <keycap>*</keycap>, which matches any number
of characters, and <keycap>?</keycap> which matches a single
character. Press <guibutton>OK</guibutton> and &konqueror; will
highlight all files with matching names. For example:</para>
      
<itemizedlist>
<listitem><para> <userinput><filename>flag*.png</filename></userinput> will
select all filenames starting with the letters <quote>flag</quote> and ending
with <quote><literal role="extension">.png</literal></quote>.</para></listitem>
<listitem><para><userinput><filename>memo?.txt</filename></userinput> will
select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but
not <filename>memo99.txt</filename>.</para></listitem>
</itemizedlist>

<para>When you have selected a range of files, you can narrow down the
selection
by using the Menubar <menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
<guimenuitem>Unselect Matching Items...</guimenuitem></menuchoice> option to specify
which of the selected files should be removed from the selection.</para>

<para>Use the Menubar <menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
<guimenuitem>Unselect All</guimenuitem></menuchoice> option or just
&LMB; click on a clear area of the view to cancel the
selection.</para>

<para>You can even invert the selection: that is, deselect all selected
files and select those that were previously unselected. Use the
Menubar <menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu><guimenuitem>Invert
Selection</guimenuitem></menuchoice> option or <keycombo
action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo> to do this.</para>
</sect2>

</sect1>

<!-- 4.11 -->
<sect1 id="making">
<title>Create New</title>

<para>When &konqueror; is in File Manager mode, picking
<guisubmenu>Create New</guisubmenu> from the <guimenu>Edit</guimenu>
menu or from the context menu you get by &RMB; clicking on a free
area in a folder view gives you a submenu letting you create any
of the following in the current folder:</para>

<variablelist>

<varlistentry>
<term><guimenuitem>Folder...</guimenuitem></term>
<listitem><para>An easy way of creating a new (sub)folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text File...</guimenuitem></term>
<listitem><para>Use this to create an ordinary, empty, text file. A
dialog box will be opened for you to enter the name of your new
file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>HTML File...</guimenuitem></term>
<listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When
you type the new file's name into the dialog box it is probably best to give
it a <literal role="extension">.html </literal> extension to avoid
confusion.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem><replaceable>Type of Document</replaceable> Document...</guimenuitem></term>
<listitem><para>Depending on the installed applications and file associations
several menuitems for different types of documents are displayed and enable you 
to create skeleton documents of the selected type.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Link to Location (URL)...</guimenuitem></term>
<listitem><para>This lets you create an icon to open &konqueror; at a
particular folder or web page. As with <guimenuitem>Link To Application...</guimenuitem>
you can make the application icon appear on your desktop by creating the link
in your <filename>~/Desktop</filename> folder or going to the <guisubmenu>Create
New...</guisubmenu> sub menu by right clicking on a free area of the
desktop.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Basic link to file or directory...</guimenuitem></term>
<listitem><para>Create a symbolic link for local files or folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Link to Application...</guimenuitem></term>
<listitem><para>This option is most useful if you want to create an icon that
will open a particular application. It opens a dialog box with several tabbed
pages. The first, <guilabel>General</guilabel>, is where you choose an icon and
the text that will appear with it. The second page,
<guilabel>Permissions</guilabel>, lets you select who can use or modify the
icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that
will run the application, for example, <userinput>kwrite</userinput> to start up
the &kwrite; text editor. <userinput>kwrite /home/pam/todo.txt</userinput> would
open the file <filename>/home/pam/todo.txt</filename> in &kwrite;. Advanced
options such as the file types which the application can open are also
available from this page.</para>

<para>To make the application icon appear on your desktop, create the link in
your <filename class="directory">~/Desktop</filename> folder (this may be 
called something slightly different depending on how &kde; was installed on 
your system) or get to the <guisubmenu>Create New...</guisubmenu> sub menu by
<mousebutton>right</mousebutton> clicking on a free area of the desktop 
instead of within &konqueror;'s window.</para>

<para>If you have a lot of specialized application links and don't want to
clutter up the desktop, then why not create them in your Applications
folder. You can get there in &konqueror; by choosing <menuchoice><guimenu>Go</guimenu>
<guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon
on your desktop to open your Applications folder, which is usually in
<filename class="directory">~/.local/share/applications</filename>.</para>
<para>To put an application link icon into the panel, first create it in the
Applications folder then drag the icon onto a clear area of the
panel.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><guisubmenu>Link to Device</guisubmenu></term>
<listitem><para>Use the options in this submenu to create an icon that will mount a device
and open an instance of &konqueror; showing it's contents. To unmount the
device when you have finished with it <mousebutton>right</mousebutton> click on
the icon and select <guimenuitem>Unmount</guimenuitem>. 
However, in most cases you will want to create the icon on your desktop.
</para></listitem>
</varlistentry>

</variablelist>

</sect1>
<!-- 4.11 -->
<sect1 id="newname">
<title>Changing Names and Permissions</title>

<para>The two easiest ways to change the name of a file or folder is to either 
<mousebutton>right</mousebutton> click on it and select 
<guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> key.</para>

<para>To change the name or permissions of a file or folder 
<mousebutton>right</mousebutton> click on its name or icon and select the 
<guimenuitem>Properties</guimenuitem> item, or if you have 
<quote>selected</quote> the file or folder, then you can use the Menubar 
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Properties</guimenuitem>
</menuchoice> (<keycombo action="simul">&Alt;<keycap>Return</keycap></keycombo>) option.</para>

<para>This will bring up the Properties dialog box with several tabbed 
pages:</para>

<itemizedlist>
<listitem><para><guilabel>General</guilabel>, which gives you some
information about the item and lets you change its name and, for a folder,
the associated icon.</para></listitem>
<listitem><para><guilabel>Permissions</guilabel>, which shows you the item's
ownership and access permissions and lets you change the permissions.
</para></listitem>
</itemizedlist>
<!-- 4.5 -->
<sect2 id="copyrename">
<title>Copy and Rename</title>
<para>If you want to make a copy of an existing file with a different name -- 
perhaps as a backup -- in the same folder as the original file, do a normal 
<guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem> 
it a dialog box will pop up  complaining that the file already exists. 
Just type the new name into the dialog's text box and press the 
<guibutton>Continue</guibutton> button (or if you are feeling lazy pressing the 
<guibutton>Suggest New Name</guibutton> button will generate a new name for you).</para>
</sect2>

</sect1>
<!-- 4.11 -->
<sect1 id="file-associations">
<title>Configuring File Associations</title>

<!-- TODO: The content should probably be here too, but this'll do for -->
<!-- now. -->
<para>&kde; provides many applications which can open many different
types of file. Most of the time, the defaults will work with no
problems, but &konqueror; provides a powerful system to allow you to
change the applications used to open each file type. For more details,
choose the
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Konqueror...</guimenuitem></menuchoice> menu item, select
<guilabel>File Associations</guilabel> in the configuration dialog,
and click on <guibutton>Help</guibutton>.</para>

</sect1>

<!-- 4.11 -->
<sect1 id="commandline">
<title>At the Command Line</title>

<para>Although &konqueror; is a very powerful and flexible
<acronym>GUI</acronym> file manager, there are occasions when the experienced
&Linux; / &UNIX; user wants to get down to the basics and work at the text 
command line level.</para>

<para>You can, of course, open an instance of &konsole;, perhaps with
&konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open
Terminal</guimenuitem></menuchoice> option or with <keycap>F4</keycap>.</para>
<para>If you only want to launch a program or view a &URL;, the <menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Execute Shell Command...</guimenuitem></menuchoice> 
(<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>) option may be 
easier.</para>

<para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command...
</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
<keycap>E</keycap></keycombo>) opens a small command line dialog window where 
you can enter a shell command such as <userinput>ps -ax | grep kdeinit
</userinput>. Note that it does not support full featured terminal control 
characters, so applications such as <userinput>top</userinput> and <userinput>
less</userinput> will not work properly, but it is available immediately 
without the delay involved in starting &konsole;.
</para>

<para>For more complex operations, &konqueror; has another nice feature: the 
Menubar <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Terminal
Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as 
a new view within &konqueror;. As long as the link icon is visible at the 
bottom right corner of each view, the terminal will follow any folder changes 
you make in the normal file manager view.</para>
<!--FIXME link icon not visible ?-->
<mediaobject>
<imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject>
<textobject>
<phrase>Including the terminal emulator</phrase>
</textobject>
</mediaobject>

</sect1>

</chapter>

<chapter id="browser"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>


<title>&konqueror; the Web Browser</title>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="konqorg.png"/></imageobject>
<textobject>
<phrase>Browsing www.konqueror.org</phrase>
</textobject>
</mediaobject>
<!--FIXME rm this sect?-->
<sect1 id="conn-inet">
<title>Connecting to the Internet</title>

<para>Once you are connected to the Internet you can use &konqueror; to browse
the Web just as easily as you can use it to handle your local files. Just type
a &URL; into the <guilabel>Location</guilabel> Toolbar window, press
&Enter;, and you are away!</para>

<itemizedlist>
<listitem><para>If you use a dial-up modem connection, then you will be using
&kppp; or a similar dialer program to make the connection.</para></listitem>

<listitem><para>If your machine is connected to a local area network
(<acronym>LAN</acronym>) that gives you a proxy connection to the Internet 
then you will have to set &konqueror; up for the proxy connection. This can be 
done with the <menuchoice><guimenu>Web Browsing</guimenu>
<guimenuitem>Proxy</guimenuitem></menuchoice> page of the <menuchoice><guimenu>
Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem>
</menuchoice> dialog.</para></listitem>

<listitem><para>If you are lucky enough to have a high speed cable connection,
then the service provider will probably give you an external cable modem which
needs an ethernet connection to your machine. Unfortunately the details of how
to establish the connection depend on the service provider and to some extent
on which Linux/&UNIX; distribution you are using.  Some <acronym>ISP</acronym>s
connect their customers to the Internet through a proxy server, in which case
you will have to set up &konqueror; to use it.  You may find it useful to
search the archives of your distribution's user group mailing list for
help.</para>
</listitem>
</itemizedlist>

<note><para>An error message such as <errorname>Unknown Host</errorname>
usually means that &konqueror; cannot find a connection to the Internet or that 
you have entered an incorrect &URL;.</para></note>

</sect1>

<sect1 id="surf">
<title>Surfing and Searching</title>

<para>Once you have a connection to the Internet, you can surf with
&konqueror; just as you can with any other browser.</para>

<para>Type a &URL; into the Location Toolbar window, press
&Enter; or <mousebutton>left</mousebutton> click on the 
<guibutton>Go</guibutton> button at the right hand end of the Location 
Toolbar, and &konqueror; will download and display that page. 
If you have visited the page before, &konqueror;'s 
<link linkend="path-complete">Automatic Text Completion</link> feature can help 
you type the &URL; a second time, or you could look through the 
<guilabel>History</guilabel> page in the 
<link linkend="sidebar">Sidebar</link>. If you want to use one of 
the web's search engines, &konqueror;'s <link linkend="enhanced-browsing">
Web Shortcuts</link> feature can make this easier.</para>

<para><mousebutton>Left</mousebutton> click on a link in a page to
open that link.</para>

<para>To open a link in a new instance of &konqueror;, leaving the
old page still visible, &RMB; click on the link and select the
<guimenuitem>Open in New Window</guimenuitem> option. Alternatively, 
you might want to <guimenuitem>Open in New Tab</guimenuitem>. 
<link linkend="tabbrowse">Tabbed Browsing</link> will let 
you hold a number of pages in one &konqueror; window and quickly switch 
between them with a single mouse click.</para>

<para>You could also select multiple view modes with  
<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
Left/Right</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
&Shift;<keycap>L</keycap></keycombo>) / <menuchoice><guimenu>Window</guimenu> 
<guimenuitem>Split View Top/Bottom</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
&Shift;<keycap>T</keycap></keycombo>) option which will let you see different
pages at the same time. This can be useful if you are looking through a
complicated set of <acronym>HTML</acronym> pages, but make sure the little link
box at the bottom right hand corner is empty when you are doing
this.</para>
<para>To go back to the previous page use the <keycombo
action="simul">&Alt;<keysym>Left</keysym></keycombo>
shortcut, the <guibutton>Back</guibutton> button on the Toolbar, or the menubar
<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
option.</para>
<para>Similarly, once you have gone back you can go forward by using
<keycombo action="simul">&Alt;<keysym>Right</keysym></keycombo>, the 
<guibutton>Forward</guibutton> button, or the menubar
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem></menuchoice> option.</para>

<!-- copy from okular Navigating -->
<para>
There are multiple ways of scrolling the viewing area. One is to use the 
<keycap>Up Arrow</keycap> and <keycap>Down Arrow</keycap> keys. You may also use
the scrollbar, your mousewheel or the <keycap>Page Up</keycap> and <keycap>Page Down</keycap>
keys.</para>
<para>If you want to read a long webpage use the automatic scrolling feature of &konqueror;.
Start automatic scrolling with <keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo> or 
<keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>. Then use these keys to increase and 
decrease the scrolling speed. You can start or stop automatic scrolling temporarily by pressing the &Shift; key;
pressing any other key deactivates this feature.
</para>
<para>Automatic scrolling works only in the view mode <guimenuitem>KHTML</guimenuitem>.
</para>
<para>If you want to stop a download for any reason then use the
&Esc; key, the Toolbar <guibutton>Stop</guibutton> button or the
Menubar <menuchoice><guimenu>View</guimenu>
<guimenuitem>Stop</guimenuitem></menuchoice> item.</para>

<para>When you are viewing a web page with the <guilabel>HTML Toolbar</guilabel> 
enabled you should see two new icons in the toolbar <guiicon><inlinemediaobject><imageobject>
<imagedata fileref="format-font-size-less.png" format="PNG"/>
</imageobject></inlinemediaobject></guiicon> and <guiicon><inlinemediaobject><imageobject>
<imagedata fileref="format-font-size-more.png" format="PNG"/>
</imageobject></inlinemediaobject></guiicon>. Use these to adjust the size of the text in the
page if you find it difficult to read. How well this works will
depend on how the web page has been constructed.</para>
</sect1>
<!-- Tab works in filemanager mode as well-->
<sect1 id="tabbrowse">
<title>Tabbed Browsing</title>
<para>By using this feature you can make &konqueror; load multiple web pages in
the same window, and switch between them using tabbed pages. This way, you can
preload a page <quote>in the background</quote> while you carry on reading another.</para>

<para>To use tabbed browsing, <mousebutton>right</mousebutton> click on a 
link and choose <guimenuitem>Open in New Tab</guimenuitem> from the drop down 
menu or &MMB; click. The page will be downloaded and displayed as normal, but with tabs 
across the top of the view, one tab for each page. &LMB; click on a 
tab to view that page, or you can use the shortcuts 
<keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo> and 
<keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo> to cycle through 
the tab pages. Alternatively, you can scroll through the tabs using
the mouse <mousebutton>wheel</mousebutton> while the mouse pointer is
over the tab bar (presuming that your mouse has one). Also,
double-clicking over the empty tab bar space will open a new
tab.</para>

<para>Using the <guilabel>Open new tabs in the background</guilabel> option in the 
<guilabel>General</guilabel> page of the <guimenu>Settings</guimenu> 
dialog, clicking on a link downloads the page and shows a new tab for it, but the new
page will not be displayed until you <mousebutton>left</mousebutton> click 
on the tab.</para>

<para>If you check the <guilabel>Open links in new tab instead of in new 
window</guilabel> box in the <guimenuitem>General</guimenuitem> page of the 
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
</guimenuitem></menuchoice> dialog, &MMB; clicking on a link will open it 
in a new tab page and if you hold the &Shift; key down while clicking the 
&MMB; the link will be opened in a background tab page.</para>

<para><mousebutton>Right</mousebutton> clicking on a tab will bring up a 
menu with the following options:</para>
<variablelist>

<varlistentry>
<term><guimenuitem>New Tab</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>)</term>
<listitem><para>This opens a new, blank, tabbed page view. 
You can then download a web page into it by typing the &URL; into the 
Location Bar or by making a selection from the Bookmark Toolbar or the 
<link linkend="sidebar">Sidebar</link> history page.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Duplicate Tab</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>)</term>
<listitem><para>To create a duplicate tabbed page.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Reload Tab</guimenuitem> (<keycap>F5</keycap>)</term>
<listitem><para>Reloads the content of the current tab.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guisubmenu>Other Tabs</guisubmenu></term>
<listitem><para>Displays a submenu showing all other tabs. Choosing a tab from
this list makes it the active tab.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guisubmenu>Other Tabs</guisubmenu><guimenuitem>Reload All Tabs</guimenuitem></menuchoice>
 (<keycombo action="simul">&Shift;<keycap>F5</keycap></keycombo>)</term>
<listitem><para>Reloads the content of every tab.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guisubmenu>Other Tabs</guisubmenu><guimenuitem>Close Other Tabs</guimenuitem></menuchoice></term>
<listitem><para>To close all but the selected tab page.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Detach Tab</guimenuitem> (<keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo>)</term>
<listitem><para>This option removes the selected tabbed 
page from the current &konqueror; window and opens it in a new instance of 
&konqueror;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Close Tab</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>)</term>
<listitem><para>To close the selected tab page.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<!--FIXME sync with or rm + link to kde-runtime/doc/kcontrol/ebrowsing/-->
<sect1 id="enhanced-browsing">
<title>Web Shortcuts</title> 

<para>If enabled, &konqueror;'s Web Shortcuts
feature lets you submit a query directly to a search engine or similar web site
without having to visit the site first.</para> <para>For example, entering
<userinput>gg:konqueror</userinput> into the Location Bar and pressing &Enter;
will ask <trademark>Google</trademark> to search for items related to
&konqueror;.</para>
<para>To see what Web Shortcuts are available, and perhaps
add your own, use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Konqueror...</guimenuitem></menuchoice> and open the <guilabel>Web Shortcuts</guilabel>
page.</para>

<para>Once there, to make a new Web Shortcut select
<guibutton>New...</guibutton> and you will now have a new dialog
requesting the options and specifications of your new Web
Shortcut. The first field is for the human readable name of the search
provider; that is, simply the name of the Search provider. For
example, <trademark>Google</trademark>.</para>

<para>In the next field you should enter the &URI; that is used to do a
search on the search engine. The whole text to be searched for can be
specified as <userinput>\{@}</userinput> or
<userinput>\{0}</userinput>. The recommended version is
<userinput>\{@}</userinput> since it removes all query variables
(<replaceable>name</replaceable>=<replaceable>value</replaceable>)
from the resulting string whereas <userinput>\{0}</userinput> will be
substituted with the unmodified query string. </para>

<para>You can use <userinput>\{1}</userinput>
... <userinput>\{n}</userinput> to specify certain words from the
query and
<userinput>\{<varname><replaceable>name</replaceable></varname>}</userinput>
to specify a value given by
<userinput><varname><replaceable>name</replaceable></varname>=<replaceable>value</replaceable></userinput>
in the user query. In addition it is possible to specify multiple
references (names, numbers and strings) at once, like
<userinput>(\{<varname><replaceable>name1</replaceable></varname>,<varname><replaceable>name2</replaceable></varname>,...,"<replaceable>string</replaceable>"})</userinput>. The first
matching value (from the left) will be used as substitution value for
the resulting &URI;. A quoted string can be used as the default value if
nothing matches from the left of the reference list.</para>

<para>To make a basic Web Shortcut here however, all that is required
is the &URI; that is used to do a search on the search
engine. Following our previous example with
<trademark>Google</trademark>, we would enter
<userinput>http://www.google.com/search?q=\{@}&amp;ie=UTF-8&amp;oe=UTF-8</userinput>. You
can often easily find where to place the <userinput>\{@}</userinput>
by doing a search on the search engine in question, and then analyzing
the &URL; address. For example, doing a <trademark>Google</trademark>
search for &konqueror; produces the &URL;: <ulink
url="http://www.google.com/search?q=konqueror&amp;ie=UTF-8&amp;oe=UTF-8">http://www.google.com/search?q=konqueror&amp;ie=UTF-8&amp;oe=UTF-8</ulink>. Now
you need to merely replace &konqueror; with
<userinput>\{@}</userinput> in this example to find the appropriate
&URI; to be entered.</para>

<para>In the third field you need to enter the &URI; shortcut. For
example, the <userinput>gg</userinput> in
<userinput>gg:konqueror</userinput>. In the next option &mdash; the
drop-down menu &mdash; you have the option to select the character set that
will be used to encode the search query. Once you have entered all the
options correctly to your satisfaction, press &Enter; and your new Web
Shortcut should now be available in &konqueror;.</para>

</sect1>

<sect1 id="accesskeys">

<title>Access Keys</title>

<para>&konqueror; has full support for the
<sgmltag class="attribute">accesskey</sgmltag> &HTML; attribute in
forms and links. Access keys allow you to use
the keyboard keys for functions which would perhaps normally be done
with the mouse, such as following links. The benefit of this is, quite
simply, that users can interact with a page with devices other than a
pointing device.</para>
<para>This feature has to be enabled by checking the <guilabel>Enable Access 
Key activation with &Ctrl; key</guilabel> option on the <guilabel>Web 
Browsing</guilabel> settings page.</para>
<para>To activate the access keys in &konqueror;, press and release
&Ctrl;. Once this is pressed, if a particular link on the website has
the <sgmltag class="attribute">accesskey</sgmltag> attribute in the given link, then the
character(s) should appear over the link, identifying what needs to be
pressed. Then, you can enter the character(s) associated with the link
as an alternative to following the link with the mouse. To disable the
access keys once activated you can press &Ctrl; again.</para>

<note><para>The proper use of this feature requires that the web
designer of the page has specifically assigned, using the
<sgmltag class="attribute">accesskey</sgmltag> attribute, an access key for the
link. Many web designers might not include the
<sgmltag class="attribute">accesskey</sgmltag> in their links and forms, and
consequently this feature will be unusable on the given
webpage.</para></note>

</sect1>
<!--FIXME sync with or rm + link to kde-runtime/doc/kcontrol/useragent/-->
<sect1 id="useragent">
<title>Browser Identification</title>
<para>When &konqueror; connects to a web site it sends some brief browser 
identification information, known as the <quote>User Agent</quote> string. 
Many web sites use this information to customize the pages that they send 
back, based on the strengths and weaknesses of different browsers.</para>
<para>Unfortunately, some badly designed sites refuse to work properly 
unless you are using a browser that the site recognizes as a 
<quote>valid</quote> one, even though if given a chance, &konqueror; will 
work satisfactorily with the vast majority of web pages.</para>
<para>To overcome this problem you can change the browser identification 
information that &konqueror; sends for specific sites or domains by 
selecting <menuchoice><guimenu>Web Browsing</guimenu><guimenuitem>
Browser Identification</guimenuitem></menuchoice> page of the settings dialog.</para>
<note><para>Problems with getting a web page to work properly may also be due 
to its use of &Java; or JavaScript. If you suspect that this may be the case 
check that they have been enabled in the <guilabel>Java &amp; JavaScript</guilabel> 
section of the settings dialog.</para></note>
<note><para>Install the <guilabel>UserAgent Changer</guilabel> extension from the 
&konqueror; Plugins and enable it in <menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure Extensions</guimenuitem></menuchoice>. This extension adds a 
<guimenuitem>Change Browser Identification</guimenuitem> item to the <guimenu>Tools</guimenu> 
menu. Using this item lets you quickly switch between different <quote>User Agent</quote> 
strings.</para></note>

</sect1>

<sect1 id="save-print-web">
<title>Saving and Printing Web Items</title>

<para>When you are viewing a web page you can save it (or at least the basic
&HTML; or similar source text) to your local disk with 
<menuchoice><guimenu>File</guimenu><guimenuitem>Save
As...</guimenuitem></menuchoice>. If the page
you are viewing uses frames, then you will also be given the
<menuchoice><guimenu>File</guimenu><guimenuitem>Save Frame
As...</guimenuitem></menuchoice> option. <mousebutton>Left</mousebutton> click
 in the frame you want to save first.</para>

<para>If the page uses a background image, you can get and save that with the
<menuchoice><guimenu>File</guimenu><guimenuitem>Save Background
Image As...</guimenuitem></menuchoice> option.</para>

<para>But if what you really want is that glorious picture of the latest
Ferrari, then <mousebutton>right</mousebutton> clicking on the image will 
give you a drop-down menu with a
<guimenuitem>Save Image As...</guimenuitem> option. Be sure to respect the 
owner's copyright, and ask for permission before using any pictures saved this 
way for anything other than your own viewing pleasure.</para>

<para>If you <mousebutton>right</mousebutton> click on a link (which may be a 
picture) and select <guimenuitem>Save Link As...</guimenuitem> from the pop 
up menu the basic &HTML; or similar source text will be 
downloaded and saved on your local disk.</para>

<para><mousebutton>Right</mousebutton> clicking on a link (which may be a 
picture) and choosing <guimenuitem>Copy Link Address</guimenuitem> will copy 
the &URL; of the link to the clipboard so you can then paste it into, say, an
e-mail to a friend telling her about this wonderful new site.</para>

<para><mousebutton>Right</mousebutton> clicking on a picture and choosing 
<guimenuitem>Copy Image</guimenuitem> copies the &URL; of the picture 
to the clipboard.</para>

<para>To save a complete web page, including images, select <guimenuitem>
Archive Web Page...</guimenuitem> from the <guimenu>Tools</guimenu> menu. 
Note that this feature is provided by a <link linkend="konq-plugin">plugin 
</link> and may not have been installed on your system. The web page will be 
saved as a single file with a <literal role="extension">.war</literal> 
extension and can be opened by <mousebutton>left</mousebutton> clicking 
on the filename in &konqueror; running in File Manager mode.</para>

<para>Printing a copy of the page you are viewing is easily done with the
Menubar <menuchoice><guimenu>File</guimenu>
<guimenuitem>Print...</guimenuitem></menuchoice> or <guimenuitem>Print
Frame</guimenuitem> option or with the Toolbar <guiicon>Print</guiicon>
button.</para>

</sect1>

<sect1 id="ftp">
<title>&FTP;</title>

<para>&FTP;, or File Transfer Protocol, is one of the earliest, and still
perhaps the best, way of transferring files between computers over the
Internet.</para>

<para>With &FTP; you can see files and folders on the distant computer just
as if they were on your own system, download them onto your computer using
&konqueror;'s normal <guimenuitem>Copy</guimenuitem> and
<guimenuitem>Paste</guimenuitem> or Drag n' Drop methods and, if allowed,
upload files from your machine to the other computer's filesystem. To try it, 
type the &URL;</para>

<screen>
<userinput>ftp://ftp.kde.org/pub/kde</userinput>
</screen>

<para>into the Location Toolbar and press &Enter;. As long as 
you are connected to the Internet, and as long as the &kde;'s &FTP; site is 
not too busy, you should end up seeing the <filename
class="directory">/pub/kde</filename> folder at &kde-ftp;</para>

<note><para>Although, strictly speaking, &FTP; &URL;s should
be entered starting with <userinput>ftp://</userinput> and <acronym>WWW
</acronym> &URL;s starting with <userinput>http://</userinput>
&konqueror; is usually smart enough to figure out what is meant, and insert 
these characters for you if you leave them out.</para></note>

<para>When you access an &FTP; site it will usually need some form of username
and password from you. To simplify things, most &FTP; sites that offer files
for free downloading will accept the word <systemitem class="username">
anonymous</systemitem> as a username and your email
address as a password, and to make your life even easier &konqueror; will
automatically supply these without troubling you. </para>

<note><para>If you try to access an &FTP; site that does not need a proper
username or password but which is too busy to accept any more connections,
&konqueror; often interprets the <quote>busy</quote> message as a request for
a name and password and will therefore pop up a dialog box asking you to
supply them.</para></note>

<para>Sites that are more concerned with security will need a proper username
and password, in which case &konqueror; will ask you for them or you can
include the username in the &URL; you type into the Location Toolbar, as 
for example</para>

<screen>
<userinput>ftp://<replaceable>username</replaceable>@ftp.cia.org</userinput>
</screen>

<para>&konqueror; will then prompt you for the password.</para>

<para>&konqueror; can also support automatic logins as specified in a 
<filename>.netrc</filename> file. Details of how to enable this feature are 
given at <ulink url="http://www.konqueror.org/faq.html#netrc">
http://www.konqueror.org/faq.html#netrc</ulink></para>

</sect1>


<sect1 id="portnumbers">
<title>&URL;s with Port Numbers</title>
<para>If you specify a port number in your &URL;, as in for example 
<userinput>http://intranet.corp.com:1080</userinput>, you might get the error 
message <quote>Access to restricted port in POST denied</quote>. This is done 
for security reasons. If you nevertheless need to access a server on this port, 
just add a key line
<screen><userinput>
OverridenPorts=CommaSeparatedListOfAllowedPorts
</userinput></screen>
to <filename>$KDEDIR/share/config/kio_httprc
</filename> or 
<filename>~/.kde/share/config/kio_httprc</filename>.</para>
<para>For example
<screen><userinput>OverridenPorts=23,15
</userinput></screen> 
(it should not include any embedded spaces).</para>
<para>&konqueror; will reject the following ports (the list is hardcoded in 
<filename>kdelibs/kio/kio/job.cpp</filename>):</para>
<para>
 1, 7, 9, 11, 13, 15, 17, 19,
 20, 21, 22, 23, 25, 37, 42, 43,
 53, 77, 79, 87, 95, 101, 102, 103, 104,
 109, 110, 111, 113, 115, 117, 119, 123, 
 135, 139, 143, 179, 389, 512, 513, 514, 
 515, 526, 530, 531, 532, 540, 556, 587, 
 601, 989, 990, 992, 993, 995, 1080, 
 2049, 4045, 6000, 6667
</para>
</sect1>


</chapter>

<chapter id="path-complete"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup> 

</chapterinfo>


<title>Automatic Text Completion</title> 

<para>You can get &konqueror; to help you enter a path or &URL; into the
Location Toolbar by enabling one of the <guimenuitem>Text Completion</guimenuitem>
features. To do this <mousebutton>right</mousebutton>
 click on a clear part of the Location Toolbar text entry box and select 
<guisubmenu>Text Completion</guisubmenu> from the pop up menu. This will let you 
choose between the following options:</para>

<variablelist>

<varlistentry>
<term><guimenuitem>None</guimenuitem></term>
<listitem><para>What you get is what you type.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Manual</guimenuitem></term>
<!-- in 4.5 I see no diff to None -->
<listitem><para>When you have typed part of a path or &URL;, pressing 
<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> or &Tab; will complete the entry if it is 
possible to do so unambiguously.</para></listitem> 
</varlistentry>

<varlistentry>
<term><guimenuitem>Automatic</guimenuitem></term>
<listitem><para>As you type into the Location Toolbar window &konqueror; will 
automatically extend what you type to complete one possible path or &URL;,  
highlighting the characters it has added. Continue typing if that's not what 
you wanted or press &Enter; to accept it.</para></listitem>
 </varlistentry>

<varlistentry>
<term><guimenuitem>Dropdown List</guimenuitem></term>
<listitem><para>A drop-down window will appear as you type, showing the
possible matches to what you have typed so far. When the path or &URL; that 
you want appears in the window click on it with the &LMB;. 
You can also use the 
<keysym>Down Arrow</keysym> or &Tab; and <keysym>Up Arrow</keysym> or
<keycombo action="simul">&Shift;&Tab;</keycombo>
keys to select it then press &Enter;.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Short Automatic</guimenuitem></term>
<listitem><para>This is like Automatic mode except that it only extends 
what you have typed as far as the next <keycap>/</keycap> symbol in the path 
or &URL;. Press <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> or &Tab; to accept the 
suggestion, &Enter; when the complete path or &URL; is 
shown.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Dropdown List &amp; Automatic</guimenuitem></term>
<listitem><para>This is a combination of both options described above.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Default</guimenuitem></term>
<listitem><para>This item appears at the bottom of the submenu and enables you
to switch to the default behaviour <guimenuitem>Dropdown List</guimenuitem>.</para></listitem>
</varlistentry>
<!-- Del to end 
substring completion F7 http://websvn.kde.org/?view=revision&revision=1096306-->
</variablelist>
<para>You should try out these different modes and pick the one that suits you
 best.</para>
<para>The history of recently visited &URL;s that &konqueror; uses for the 
Text Completion function can be viewed and edited in the <guilabel>History
</guilabel> page of the <link linkend="sidebar">Sidebar</link>.</para>

</chapter>

<chapter id="bookmarks"> <!-- 4.11-->
<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>Using Bookmarks</title>

<para>Although you can use &konqueror;'s bookmarks to record the locations of
your own files and folders, they are most useful when you are surfing the
Web, letting you build up a list of useful sites.</para>

<para>To open the <guimenu>Bookmarks</guimenu> menu
<mousebutton>left</mousebutton> click on the <guimenu>Bookmarks</guimenu> menu.
Once the list is visible, you can navigate through it with the arrow keys or
with your mouse, then press &Enter; or <mousebutton>left</mousebutton>
click to visit the selected location.</para>

<para>To add a new item to the list use <menuchoice><guimenu>Bookmarks
</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice> or 
<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> or
<mousebutton>right</mousebutton> click on a clear space in the web page or 
folder view and select <guimenuitem>Bookmark this Page</guimenuitem> / 
<guimenuitem>Bookmark this Location</guimenuitem>  from 
the pop up menu.</para>

<para>The <guimenu>Bookmarks</guimenu> list can contain subfolders containing 
other bookmarks, you can create these with <menuchoice><guimenu>Bookmarks 
</guimenu><guimenuitem>New Bookmark Folder...</guimenuitem></menuchoice> 
To add a bookmark into a subfolder rather than into the main Bookmark list, 
select the folder from within the <guimenu>Bookmarks</guimenu> list and use 
the <guimenuitem>Add Bookmark</guimenuitem> item in that folder.</para>

<para>You can also access your bookmarks from the <link linkend="sidebar">
<guilabel>Sidebar</guilabel></link> or from the <guilabel>Bookmark Toolbar</guilabel>.</para>

<para>If you enter <userinput>bookmarks:/</userinput> in the location bar the 
bookmarks home page with an overview of all bookmarks and folders is shown.</para> 

<sect1 id="orgbmark">
<title>The Bookmark Editor</title>

<para>The <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit
Bookmarks</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark
Editor</guilabel>.</para>
<para>This shows a tree view of your bookmarks and bookmark subfolders. 
As is usual for tree views in &kde;, subfolders are shown with a small
<keycap>&gt;</keycap> arrow at the left of the folder name;
<mousebutton>left</mousebutton> clicking on it will expand the view to
show the contents of that subfolder and the <keycap>&gt;</keycap> arrow will
change to <keycap>v</keycap>; <mousebutton>left</mousebutton> clicking on the
<keycap>v</keycap> arrow will collapse the subfolder view.</para>

<para>To select an item in the list you can <mousebutton>left</mousebutton> 
click on it, or you can navigate through the list by using the <keysym>
Up arrow</keysym> and <keysym>Down arrow</keysym> keys to move around, 
<keysym>Right arrow</keysym> to expand a subfolder and <keysym>
Left arrow</keysym> to collapse it.</para>

<para>You can move an item to a different place in the list by using the 
normal Drag and Drop or <guimenuitem>Cut</guimenuitem> and <guimenuitem>
Paste</guimenuitem> methods. The order in which the items appear in 
the <guilabel>Bookmark Editor</guilabel> is the order they will appear in the 
<guimenu>Bookmarks</guimenu> drop down list. The <menuchoice><guimenu>Folder
</guimenu><guimenuitem>Insert Separator</guimenuitem></menuchoice> option can 
be used to insert separating lines into the list wherever you wish.</para>

<para>A new subfolder can be created at the selected point in the list by 
using the <guimenuitem>New Folder...</guimenuitem> option in the 
<guimenu>Folder</guimenu> menu or from the drop down menu you get when you 
<mousebutton>right</mousebutton> click on an item in the main part of the 
window, or with <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</para>

<para>To change the name of a bookmark or folder select it then press 
<keycap>F2</keycap> or choose the <guimenuitem>Rename</guimenuitem> item from 
the <guimenu>Edit</guimenu> menu or the pop up menu that appears when you 
<mousebutton>right</mousebutton> click on the item. Similarly, you can edit 
the &URL; by pressing <keycap>F3</keycap> or choosing the <guimenuitem>
Change Location</guimenuitem> menu item.</para>

<para>The <guilabel>Bookmark Editor</guilabel> lets you import bookmarks from 
a range of other browsers into &konqueror;'s bookmark list, putting them into 
 a new folder or replacing all current bookmarks. To do this select 
<guisubmenu>Import</guisubmenu> from the <guimenu>File</guimenu> menu. The 
<menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu>
</menuchoice> option can be used to export &konqueror;'s bookmarks to a 
&Netscape; or Mozilla browser.</para>

<para>To select which bookmark subfolder is used to hold the Bookmark 
Toolbar items select the subfolder then choose <guimenuitem>Set as Toolbar 
Folder</guimenuitem> from the <guimenu>Folder</guimenu> menu.</para>

<para>If you are tidying up your bookmarks and have forgotten what a 
particular web page is, you can easily open it from within the <guilabel>
Bookmark Editor</guilabel> by <mousebutton>right</mousebutton> clicking 
on the item and selecting <guimenuitem>Open in Konqueror</guimenuitem> from 
the pop up menu. If you just want to check that the &URL; is still valid 
select <guimenuitem>Check Status</guimenuitem> instead.</para>

<note><para>All your changes are automatically saved if you close  
the <guilabel>Bookmark Editor</guilabel>.
</para></note>
</sect1> 


</chapter>

 <chapter id="sidebar"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>The Sidebar</title>

<para>The Sidebar appears as a separate view at the left of 
&konqueror;'s window. It can be invoked with <menuchoice><guimenu>Settings
</guimenu><guimenuitem>Show Sidebar</guimenuitem></menuchoice> or 
toggled on and off with the <keycap>F9</keycap> key.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="dirtree.png"/></imageobject>
<textobject>
<phrase>With the Sidebar</phrase>  
</textobject>
</mediaobject>

<para>It contains a number of tabbed pages; <mousebutton>left</mousebutton> 
click on a tab's icon to view that page. <mousebutton>Left</mousebutton> 
clicking on the icon for the visible page will collapse the Sidebar 
so that only the tab icons are visible.</para>
<variablelist>

<varlistentry>
<term><guilabel>Bookmarks</guilabel></term>
<listitem><para>This page shows a tree view of your Bookmarks. <mousebutton>
Left</mousebutton> click on an item to open it in the main view.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>History</guilabel></term>
<listitem><para>This page shows a tree view of your browsing History. 
<mousebutton>Left</mousebutton> clicking on an item will open it in the main 
view, or you can open it in a new &konqueror; window by <mousebutton>right
</mousebutton> clicking and selecting <guimenuitem>Open in New Window</guimenuitem> 
from the pop up menu.</para>
<para>You can remove an item from the history by <mousebutton>right
</mousebutton> clicking on it and selecting <guimenuitem>Remove Entry</guimenuitem>. 
Selecting <guimenuitem>Clear History</guimenuitem> will 
clear out the entire history.</para>
<para>The pop up menu you get when you <mousebutton>right</mousebutton> click 
on any entry in the History page also gives you the option of choosing 
whether the entire history is sorted by name or by date.</para>
<para>Selecting <guimenuitem>Preferences...</guimenuitem> from this pop up 
menu brings up the <guilabel>History Sidebar</guilabel> control module. This 
can be used to set the maximum size of your history and set a time after which 
items are automatically removed. You can also set different fonts for new and 
old &URL;s. 
The <guilabel>Detailed tooltips</guilabel> checkbox controls how much 
information is displayed when you hover the mouse pointer over an item in the 
history page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Home Folder</guilabel></term>
<listitem><para>This page shows a tree view of the subfolders of your home 
folder. Note that <quote>hidden</quote> folders (those with names 
beginning with a dot) are not shown.
<mousebutton>Left</mousebutton> click on an item to open it in the 
main view, or <mousebutton>right</mousebutton> click to display a pop up 
menu allowing you to open the subfolder in a new window or as a new tab 
page of the main view.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Network</guilabel></term>
<listitem><para>This page is intended to show a tree view of your important 
network connections, although local folders can also be included. Again, 
you can <mousebutton>left</mousebutton> click on an item to open it in the 
main view or <mousebutton>right</mousebutton> click to bring up a menu with 
a wider range of possibilities.</para>
<para>The folders shown in the <guilabel>Network</guilabel> page are held in 
the folder <filename class="directory">
~/.kde/share/apps/konqsidebartng/virtual_folders/remote/</filename>, and you can make 
new ones just as you would make any other subfolder. The items within 
these folders are held as <literal role="extension">.desktop</literal> files 
and can be created with &konqueror;'s <menuchoice><guisubmenu>Create New</guisubmenu>
<guimenuitem>Link to Location (URL)...</guimenuitem></menuchoice> option in the 
<guimenu>Edit</guimenu> menu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Root Folder</guilabel></term>
<listitem><para>The <guilabel>Root Folder</guilabel> tree has the path <filename
class="directory">/</filename>, and is the base folder of your system's
local files. If you expand the <quote>Root</quote> folder you will find 
another folder called <filename class="directory">root</filename>. This 
belongs to the system administrator or Super User and is her home folder. 
You will also find a folder called 
<filename class="directory">home</filename>, in which you should be able to 
find your own <quote>Home</quote> folder again.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Services</guilabel></term>
<listitem><para>This page provides quick access to the following services:
</para>
<para><guilabel>Applications</guilabel>, <guilabel>Audio CD Browser</guilabel>, 
<guilabel>Fonts</guilabel> and <guilabel>Video DVD Browser</guilabel>.</para>
</listitem>
</varlistentry>
<!-- Different in dolphin + filedialog-->
<varlistentry>
<term><guilabel>Places</guilabel></term>
<listitem><para>
The <guilabel>Places</guilabel> panel is located at the left of the window by
default. The <guilabel>Places</guilabel> panel shows any locations you have
bookmarked. It also shows any disk or media attached to the computer.
</para>
<para>
The easiest way to add a folder to the <guilabel>Places</guilabel> panel is to
drag it and drop it in the panel. Moreover, you can click inside the panel with
the &RMB; and choose <menuchoice><guimenuitem>Add Entry...</guimenuitem></menuchoice>
from the context menu.
</para>
</listitem>
</varlistentry>
</variablelist>

<para>The Sidebar configuration can be changed by <mousebutton>right
</mousebutton> clicking on the empty area below the bottom tab icon or by 
<mousebutton>left</mousebutton> clicking on the <guilabel>Configuration 
Button</guilabel> icon, which is enabled in the context menu. Doing this
brings up a menu with the following options:</para>
<variablelist>

<varlistentry>
<term><guisubmenu>Add New</guisubmenu></term>
<listitem><para>This option lets you add a new tab page to the Sidebar. 
The new page can contain different Sidebar modules or a new
<guimenuitem>Folder</guimenuitem> tree view. The last option in this
submenu allows you to rollback to system default.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Multiple Views</guimenuitem></term>
<listitem><para>Selecting this option splits the Sidebar so that 
two tab pages can be seen at once.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Show Tabs Left</guimenuitem>, <guimenuitem>Show Tabs Right</guimenuitem></term>
<listitem><para>This option lets you choose whether the tab icons are shown at 
the left or right of the Sidebar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Show Configuration Button</guimenuitem></term>
<listitem><para>Use this option to show or hide the <guilabel>Configuration 
Button</guilabel> icon.</para>
</listitem>
</varlistentry>

</variablelist>

<para><mousebutton>Right</mousebutton> clicking on a tab icon brings up a 
menu with the following options:</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Set Name</guimenuitem></term>
<listitem><para>This option lets you 
change the Name of that page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Set URL</guimenuitem></term>
<listitem><para>This option lets you 
change the &URL; (path) of the folder viewed in that page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Set Icon</guimenuitem></term>
<listitem><para>To change the tab icon.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Remove</guimenuitem></term>
<listitem><para>To remove the tab page from the Sidebar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Configure Sidebar</guimenuitem></term>
<listitem><para>The last item shows the Sidebar configuration submenu
as described above.</para>
</listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="save-settings"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>Saving Settings &amp; Profiles</title>
<sect1 id="save-settings-general">
<title>General Settings</title>
<para>When you close down &konqueror; your current <guimenu>View</guimenu> 
menu settings (such as the <guimenuitem>View Mode</guimenuitem>, 
<guimenuitem>Use index.html</guimenuitem> and <guimenuitem>Show Hidden 
Files</guimenuitem> items) are not automatically saved as the default
options; however, you can have &konqueror; remember these settings by
selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View
Profile As...</guimenuitem></menuchoice> and the current
setting will become the default option to be used the next time
&konqueror; is started.</para>

<para>But you can also specify different <guimenu>View</guimenu> menu settings
for an individual folder. To do this select <menuchoice><guimenu>View</guimenu>
<guimenuitem>Adjust View Properties...</guimenuitem></menuchoice>,
change the <guimenu>View</guimenu> settings in the dialog to whatever you want. Then apply 
the view properties to the <guilabel>Current folder</guilabel>. Doing this
creates a <filename>.directory</filename> file in that folder to hold the
folder <guimenu>View</guimenu> settings. Use this dialog again to remove the folder specific
settings (or just delete the <filename>.directory</filename> file).</para>
<note><para>One nice use of this feature is if you have a folder full of
pictures, you can set that particular folder to display thumbnails of the
pictures (by choosing the <menuchoice><guisubmenu>View Mode</guisubmenu>
<guimenuitem>Icons</guimenuitem></menuchoice> and <guimenuitem>Preview</guimenuitem> 
from the <guimenu>View</guimenu> menu) when you open it, while 
not displaying images as thumbnails in other folders.</para></note>
</sect1>

<sect1 id="save-settings-view-profiles">
<title>View Profiles</title>
<para>&konqueror; can save a whole set of options as a <quote>View
Profile</quote>. Some view profiles are part of the standard &konqueror;
installation, such as <property>Web Browsing</property>, <property>File
Management</property>, <property>KDE Development</property>, 
<property>Midnight Commander</property> and <property>Tabbed Browsing</property>;
but you can add your own, too.</para>

<para>To modify a view profile (say, the <property>Web Browsing</property>
profile), load the profile with
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Load View
Profile</guisubmenu><guimenuitem>Web Browsing</guimenuitem> </menuchoice>, and
change the &konqueror; settings to whatever you want. Now select
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View Profile As...
</guimenuitem></menuchoice>. In the dialog which appears, you can
change the name of the profile, which will create a new profile with that name,
or you can leave the name as it is to modify the current profile. If you select
<guilabel>Save URLs in profile</guilabel>, the current &URL; will be loaded
when you load that view profile. This functions in a similar way to the
<quote>Home Page</quote> in many web browsers. If you want &konqueror; to start
up with an empty window enter <userinput>about:blank</userinput> into the
location bar before saving the profile.</para>

<note><para>You can create a desktop icon to start &konqueror; with your new
profile. First create a desktop icon by clicking with the &RMB; onto the &konqueror; 
entry in the application launcher menu. Then select <guimenuitem>Add to Desktop</guimenuitem>
in the context menu. Open the settings dialog of the new icon on your desktop by 
clicking on the <guiicon>Tools</guiicon> icon. Change <guilabel>
Command</guilabel> in the <guilabel>Application</guilabel> tab page to
<userinput><command>kfmclient</command> <option>openProfile
<replaceable>MyNewProfile</replaceable></option></userinput>,
<replaceable>MyNewProfile</replaceable> being what you called the new
profile. Then change the name to something like <filename>MyNewProfile</filename>
.</para></note>

</sect1>
</chapter>

<chapter id="plugins"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>


<title>Plugins</title>

<sect1 id="netscape-plugin">
<title>&Netscape; Plugins</title>

<para>Currently, &konqueror; supports &Netscape; plugins.</para>

<para>Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure Konqueror...</guimenuitem>
</menuchoice> opens the configuration dialog. Select the 
<guilabel>Plugins</guilabel> page, where you find two tabs:
<guilabel>Global Settings</guilabel> to enable plugins and configure 
how they are used in &konqueror; and <guilabel>Plugins</guilabel>
which shows you the &Netscape; plugins that &kde; has found
and allows you to scan for plugins.</para>

<para>For more information see the <ulink url="help:/kcontrol/khtml-plugins/index.html">
Browser Plugins</ulink> help page.</para>

</sect1>

<!-- 
missing from extragear base:
minitools (Bookmarklets - Enables the use of bookmarklets)
This plugin adds implementation for so-called bookmarklets. Bookmarklets are little
Javascript programs which can be saved and used like normal web page bookmarks. Therefore,
they are simple "one-click" tools that can add substantial functionality to the browser.
http://blog.ssokolow.com/archives/2007/01/30/konqueror-with-bookmarklets/

autorefresh
This works on any readonly part (though currently it only plugs into
khtmlpart). It lets you tell konqueror to refresh a page automatically
after a specific period. This is useful for things like news pages,
and should be very nice for people using kiosk mode

rellinks
Name=Document Relations
Comment=Displays the document relations of a document

adblock from baseapps+extragear
Show all blockable html elements

akregator
This works on KHTMLPart and allows you to add feeds to Akregator directly from Konqueror.

not ported to kde4 yet
sidebar
microformat
mediarealfolder
<listitem>
<para><ulink url="help:/konq-plugins/mediaplayer/index.html">The Embedded Media
Player</ulink></para>

konq plugins in other modules
kdeutils 
  filelight
  ark?

kdebase apps
  kttsdplugin (browser mode ?)
  shellcmdplugin (file manager mode)
  
kdenetwork
  Download Manager kget (browser mode)

kdepim
  Konqueror Feed Icon akregator
  
extragear/network
  Konqueror Choqok Plugin

extragear/base
  Nepomuk-Webminer Plugin

playground/utils  
  Userscript (Grease Monkey) Support khtml_userscript
-->

<sect1 id="konq-plugin">
<title>&konqueror; Plugins</title>

<para>&kde; releases several useful plugins that interact with
&konqueror; in various ways. These are explained briefly below.</para>

<para>Use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure 
Extensions...</guimenuitem></menuchoice> to open a dialog with all installed plugins and select
the ones you need. All plugins are accessible in the <guimenu>Tools</guimenu> menu.</para>

<para>Only plugins appropriate for the current mode (file manager or browser in KHTML/WebKit view) 
are listed in the dialog.</para>

<variablelist>
<title>Browser Mode</title>
<!-- 
FIXME 4.11
KHTML:  Adblock, Auto Refresh, Bookmarklets, Document Relations, DOM Tree Viewer, KHTML Settings, Search Bar, Text-to-Speech, Translate, UserAgent Changer, Web Archiver, Website Validators
WebKit: Auto Refresh, KHTML Settings, Search Bar, Text-to-Speech, Translate, UserAgent Changer, Website Validators
-->
<varlistentry>
<term>Web Page Translation</term>
<listitem><para>This uses the machine translation service provided by <ulink
url="http://translate.google.com/">Google Translate</ulink> to translate the current
<acronym>HTML</acronym> page to whatever language you want (within reason). It
can be launched with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Translate
Web Page</guisubmenu></menuchoice>.</para>
<para>If you have a portion of the text on the page selected, that
will be translated instead of the entire &URL;.</para>

<important>
<para>Machine translation is not a perfect science!  Google will at
best give you a rough translation, and at worst will give you a very
funny read.  Don't base important decisions on things you have read
from a Google translated page, without confirming that the
translation is indeed accurate.</para>
</important>

<note> 
<para>You may only translate web pages that are accessible on the
world wide web.  To translate any other text, you should go directly
to the Google site itself, where you are able to paste in text for
translation.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term>DOM Tree Viewer (KHTML view only)</term>
<listitem>
<para>The <acronym>DOM</acronym> Tree Viewer allows a developer to view 
the styles, attributes and elements of a web document.</para>
<para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show
DOM Tree</guisubmenu></menuchoice> opens a new window which displays the
document object model (DOM) of the current <acronym>HTML</acronym>
page.</para>
<para>By default the display starts at the root node of the document, example: <quote>documentElement</quote>, all other nodes that you will see are children or descendants of the root node.</para>
<para>If you wish to manipulate the <acronym>DOM</acronym> tree in any way you will have to use an external script to do so.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Web Page Validator</term>
<listitem>
<para>This plugin uses the W3C HTML validator to validate the current page, very useful when
creating web pages.</para>

<variablelist>
<varlistentry>
<term><guimenuitem>Validate &HTML; (by URI)</guimenuitem> / <guimenuitem>Validate &HTML; (by Upload)</guimenuitem></term>
<listitem><para>The validate &HTML; option allows you to compare your &HTML; document to the defined syntax of &HTML; and reports any errors found.  Validating your &HTML; will ensure that your pages display properly on all browsers.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Validate CSS (by URI)</guimenuitem></term>
<listitem><para>Allows you to validate your &CSS; style sheet that is embedded in an &HTML; or &XHTML; 
document. Having valid &CSS; is critical to ensuring that your web site maintains a consistent look regardless of the browser that is being used.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Validate Links</guimenuitem></term>
<listitem><para>Allows you to confirm that the links on your site contain no redirects or broken links. This tool recursively checks all links on a site.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Validate Page</guimenuitem></term>
<listitem><para>Validates the current page but does not show the result in another window or tab as the previous actions. 
Using this item enables the action <guimenuitem>View Validator Report</guimenuitem> to display a summary of the validation.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Configure Validator</guimenuitem></term>
<listitem><para>The configure validator item allows you to view the preset validators you can use
to validate your &HTML; and &CSS;.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
<!-- icon W3 right in statusbar
&LBM; click context menu with items above but no Configure Validator
 -->
</varlistentry>

<varlistentry>
<term>HTML Settings</term>
<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>HTML
Settings</guisubmenu></menuchoice> to enable or disable a number of HTML
settings without going through the <guimenu>Settings</guimenu> dialog.
</para>
<variablelist>
<varlistentry>
<term><guimenuitem>JavaScript</guimenuitem></term>
<listitem><para>Allows you to turn the use of JavaScript in &konqueror; on or off.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Java</guimenuitem></term>
<listitem><para>Allows you to turn the use of &Java; in &konqueror; on or off.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Cookies</guimenuitem></term>
<listitem><para>Allows you to turn the use of Cookies in &konqueror; on or off.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Plugins</guimenuitem></term>
<listitem><para>Allows you to turn the use of the &konqueror; plugins you have installed on or off.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Autoload Images</guimenuitem></term>
<listitem><para>Allows you to turn on or off the loading of images in web pages.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Enable Proxy</guimenuitem></term>
<listitem><para>Allows you to enable or disable the use of a proxy in the &konqueror; browser.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Enable Cache</guimenuitem></term>
<listitem><para>Allows you to enable or disable the use of a cache in the &konqueror; browser.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Cache Policy</guimenuitem></term>
<listitem>
<para>The Cache Policy submenu provides you with a way to configure how
&konqueror; uses a cache. The possible uses include:</para>
<itemizedlist>
<listitem><para>Keep Cache in Sync</para></listitem>
<listitem><para>Use Cache if Possible</para></listitem>
<listitem><para>Offline Browsing Mode</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term>User Agent Changer</term>
<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Change
Browser Identification</guisubmenu></menuchoice> to get a menu that allows
you to change the User Agent string without going through the 
<guimenu>Settings</guimenu> dialog procedure.
</para>
<para>The plugin allows you to
change the Browser and Operating System identification on a
domain-by-domain basis. This is useful when browsing websites that
limit access to those using a particular web browser.</para>
<variablelist>
<varlistentry>
<term><guimenuitem>Default Identification</guimenuitem></term>
<listitem><para>The default User Agent header for &konqueror; is Mozilla/5.0(compatible;Konqueror/4.7)(KHTML/4.7, like Gecko).  If you come across a site that refuses this browser access, change your User Agent to one of the options below.</para></listitem>
</varlistentry>

<varlistentry>
<term>Browser submenu</term>
<listitem><para>
The following menu items show a list of popular browsers such as <guimenuitem>Firefox</guimenuitem>,
<guimenuitem>Internet Explorer</guimenuitem>, <guimenuitem>Netscape Navigator</guimenuitem>,
<guimenuitem>Opera</guimenuitem>, <guimenuitem>Other</guimenuitem>, and <guimenuitem>Safari</guimenuitem>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Apply To Entire Site</guimenuitem></term>
<listitem><para>This option allows you to specify that the defined User Agent applies across every page on the site you are visiting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Configure</guimenuitem></term>
<listitem><para>Selecting <guimenuitem>Configure</guimenuitem> opens the settings dialog and allows you to fine tune the amount of information you wish to reveal about the browser and operating system being used.</para></listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term>Archive Web Page (KHTML view only)</term>
<listitem><para>Invoked with <menuchoice><guimenu>Tools</guimenu><guisubmenu>
Archive Web Page</guisubmenu></menuchoice>, this tool creates an archive 
(<literal role="extension">.war</literal> ) file containing the web page being 
viewed including the images. <mousebutton>Left</mousebutton> click on the 
archive file name to view the saved page.
</para></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title>File Manager Mode</title>

<varlistentry>
<term>Directory Filter</term>
<listitem><para>This is controlled by
<menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></shortcut>
<guimenu>Tools</guimenu><guisubmenu>Show Filter Bar</guisubmenu></menuchoice> and allows you to choose which types of item
are displayed in a folder.</para></listitem>
</varlistentry>

<varlistentry>
<term>Image Gallery</term>
<listitem><para>In File Manager mode, you can select
<menuchoice><guimenu>Tools</guimenu><guisubmenu>Create Image
Gallery</guisubmenu></menuchoice> or use <keycombo>&Ctrl;<keycap>I</keycap></keycombo> 
to create an HTML page with thumbnails of all the images in the current folder. 
By default the HTML page is called <filename>images.html</filename> and the thumbnails 
are put into a new <filename>images</filename> folder.</para>
<para>When you start the Image Gallery plugin a dialog opens allowing you to adjust the 
way the gallery is created.</para>

<variablelist id="page_look_dialog">
<title>Page Look</title>
<varlistentry>
<term>The Look dialog is for adjusting the appearance of the gallery page.</term>
<listitem>
  
<screenshot>
<screeninfo>Look Dialog Screenshot</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="look.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term><guimenuitem>Page title</guimenuitem></term>
<listitem><para>The Page title option has a text input box for changing the title of the image gallery page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Images per row</guimenuitem></term>
<listitem><para>The Images per row option has a slider and a spin box for adjusting the number of thumbnails that are in a single row in the gallery.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Show image file name</guimenuitem></term>
<listitem><para>The Show image file name check box allows you to choose whether
to display filenames below the gallery thumbnails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Show image file size</guimenuitem></term>
<listitem><para>The Show image filesize check box allows you to choose whether
to display filesizes below the gallery thumbnails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Show image dimensions</guimenuitem></term>
<listitem><para>The Show image dimensions check box allows you to choose
whether to display image dimensions in pixels below the gallery thumbnails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Font name</guimenuitem></term>
<listitem><para>The Font name combo box provides you with a choice of which font to use in creating the gallery.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Font size</guimenuitem></term>
<listitem><para>The Font size spin box is for changing the size of the font you selected.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Foreground color</guimenuitem></term>
<listitem><para>The Foreground color option has a selector for choosing the foreground color of the gallery, this includes the text areas.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Background color</guimenuitem></term>
<listitem><para>The Background color option has a selector for choosing the background color of the gallery.</para></listitem>
</varlistentry>

</variablelist>

<variablelist id="folders_dialog">
<title>Folders</title>
<varlistentry>
<term>The Folders dialog is used for choosing where to save the gallery. 
This dialog is also used to configure which folders are used.</term>
<listitem>
  
<screenshot>
<screeninfo>Folders Dialog Screenshot</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="folders.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term><guimenuitem>Save to HTML file</guimenuitem></term>
<listitem><para>The Save to file selector allows you to decide where you want
to save your image gallery html page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Recurse subfolders</guimenuitem></term>
<listitem><para>The Recurse subfolders check box enables recursing of subdirectories. If the check box is enabled, a slider and spin box are enabled to select the recursion depth.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Copy original files</guimenuitem></term>
<listitem><para>The Copy original files check box creates an image folder storing copies of the original images used in the gallery.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Use comment file</guimenuitem></term>
<listitem><para>The use comment file check box enables a file selector to choose a comments file to use with your gallery.
The comment file contains the subtitles for the images.</para>
<para>The format of this file is:</para>
<programlisting># this is a comment, lines starting with '#' are ignored
FILENAME1:
Description

FILENAME2:
Description
</programlisting>
</listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>

</variablelist>

<variablelist id="thumbnails_dialog">
<title>Thumbnails</title>
<varlistentry>
<term>The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery.</term>
<listitem>
  
<screenshot>
<screeninfo>Thumbnails Dialog Screenshot</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="thumbnails.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
</textobject>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term><guimenuitem>Image format for the thumbnails</guimenuitem></term>
<listitem><para>The image format combo box allows you to choose which format is
used for the thumbnail images.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Thumbnail size</guimenuitem></term>
<listitem><para>The thumbnail size option provides a slider and spin box for adjusting the size of the thumbnails used in the gallery.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Set different color depth</guimenuitem></term>
<listitem><para>The set different color depth check box enables a combo box for changing the color depth of the thumbnails if you wish to use a different color depth to that used in the original image.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

</variablelist>


</listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term>Search Bar</term>
<listitem><para>Provides a text box for easy access to search engines such as Google.
Clicking on the icon on the left side of the search box opens a menu to select
and enable different search engines and configure their <ulink 
url="help:/kcontrol/ebrowsing/index.html">Web Shortcuts</ulink>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Shell Command Plugin</term>
<listitem><para>This plugin enables you to execute a shell command in the current folder
and view the output in a separate window.
</para></listitem>
</varlistentry>

<!--FIXME
imagerotation context menu Actions -> Convert to -> JPEG,PNG,GIF,TIFF 
(rotation disabled) always installed

Additional Download Manager from KGet
-->
</variablelist>

</sect1>

</chapter>

<chapter id="view-extensions"> <!-- 4.11-->

<title>View Mode Extensions</title>

<!--filemanager mode:
default Icons/Details/Columns (Dolphin), File Size View (konq-plugins)
additional Terminal Emulator (Konsole), File Replace View (kdewebdev), Cervisia (kdesdk), Radial Map (Filelight-kdeutils) and more
browser mode:
default KHTML, WebKit, Embedded Advanced Text Editor
additional KImageMapEditor+KLinkStatusPart (kdewebdev) and more
  -->
<para>&konqueror; provides additional views in <menuchoice><guimenu>View</guimenu>
<guisubmenu>View Mode</guisubmenu></menuchoice> in file manager and browser mode, if 
the corresponding applications and plugins are installed.</para>
<para>The file manager mode has the additional views <guimenuitem>Radial Map</guimenuitem> 
from the application <application>Filelight</application> and the &konqueror; plugin 
<guimenuitem>File Size View</guimenuitem>.</para>

<sect1 id="fsview">
<sect1info>
<authorgroup>
<author>
<personname><firstname>Josef</firstname>
<surname>Weidendorfer</surname></personname>
<address><email>Josef.Weidendorfer@gmx.de</email></address>
</author>

</authorgroup>

</sect1info>

<title>&fsview; - the File System View</title>
<sect2>
<title>Introduction</title>

<para>The &fsview; Plugin for &konqueror; is another view mode for
objects of mimetype <literal>inode/directory</literal> for local
files. It can be viewed as an alternative to the various iconviews and
listviews for browsing the content of your local file system.</para>

<para>The unique property of &fsview; is its ability to show whole
nested folder hierarchies using a so-called tree map for graphical
visualization. Tree maps allow for displaying metrics of objects in
nested structures: each object is represented by a rectangle whose
area is proportional to its metric. The sum of the children's metrics must be
equal to or smaller than the parent object's metric.</para>

<para>For &fsview;, sizes of files and folders are chosen as the
metric, where the size of a folder is defined to be the sum of the
sizes of its subitems. This way, big files even deep down in the
folder hierarchy can be spotted easily be looking for large
rectangles. So &fsview; can be looked at as a graphical and interactive
version of the &UNIX; <command>du</command> command.</para>

<para>The integration of &fsview; as part of Konqueror allows it to
use the standard features such as context file menus, and mime type
sensitive actions. But it was chosen not to implement automatic
update by watching file system changes: if you delete a file shown
in &fsview; outside of &konqueror;, you have to update manually by
&eg; pressing <keycap>F5</keycap> to see the change. The reason for this
decision is the potentially huge number of files which would have to be watched
for changes, and thus, could put an unreasonable pressure on system
resources for a small feature.</para>

</sect2>

<sect2>
<title>Visualization Features</title>

<para>This section explains the graphical visualization of &fsview;
in detail.</para>

<sect3>
<title>Item Drawing Options</title>

<para>In &fsview;, an item of the tree map visualization is a rectangle
representing a file or folder of your file system. For easier navigation,
rectangles have meaningful coloring and labeling options.</para>

<para>The color of a rectangle, switchable via menu item
<menuchoice><guimenu>View</guimenu><guisubmenu>Color
Mode</guisubmenu></menuchoice> can be either representative of
<guimenuitem>Depth</guimenuitem>, for easy detection of nesting, or
a color mapping of different file attributes such as name, owner, group,
or mime type.</para>

<para>A rectangle can be labeled with the various attributes
of the corresponding file or folder. For each attribute, you can
choose whether it should be shown at all, only if space is available,
or if space should be taken from children (thus introducing
errors to pure tree map drawing constraints). Additionally, you can choose
the relative location of the label in the rectangle.</para>

</sect3>

<sect3>
<title>TreeMap Drawing Algorithms</title>

<para>For drawing algorithms in tree maps, the rule that the area
is proportional to the metric of an item should hold true.
With the tree map in &fsview;, this goal isn't always met: we draw borders
to show the nesting of items, and this border takes space for an item
which is possibly lost for the areas of child items. Note that
less space is lost for the border if the rectangle is quadratic.</para>

<para>Similarly, it is better for a good overview to let each rectangle
at least have its name as a label. It is an option to
always force space for labels, or only to draw labels when empty space
is available. In the latter case, the tool tips appearing when the
mouse is held over an item can help a lot. They show
information for the item the mouse is currently over, together with
its parent folders up to the root item of the tree map.</para>

<para>How the space of an item is split into subareas for children is
left to the implementation. It is always better to try to split areas
in such a way that rectangles are as quadratic as possible, both for
labeling and less space lost by borders. The best methods in this
regard are <guilabel>Rows</guilabel>, <guilabel>Columns</guilabel>, or
<guilabel>Recursive Bisection</guilabel>.</para>

<para>You can choose the minimal area of items to be drawn via the
menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Stop at
Area</guimenuitem></menuchoice>. Instead, a hash pattern will be drawn
over the parents area to signal that this space is in fact occupied by
a child or children.</para>

</sect3>

</sect2>

<sect2>
<title>User Interface</title>

<para>&fsview; supports multiple selection of items, similar to the
iconview and listview. This allows for actions to be done
simultaneously to a set of files. A simple mouse click always selects
a single item below the mouse pointer. Use a mouse click in
combination with pressing the &Shift; key for range selection or the
&Ctrl; key for selection toggle. Note that by selecting an item, subitems can no
longer be selected. Selecting an item will also clear the selection of all its
parent items before.</para>

<para>Keyboard navigation is available in tree maps: use
<keycap>Left Arrow</keycap> and <keycap>Right Arrow</keycap> keys to
move the current item between siblings, and the <keycap>Up
Arrow</keycap> and <keycap>Down Arrow</keycap> keys to go up and down
the nesting hierarchy. <keycap>Space</keycap> selects the item; in
conjunction with &Shift; does range selection; and with the &Ctrl; key
held down simultaneously, toggles selection of the current item. Press
<keycap>Return</keycap> to run the open action on the current item.</para>

</sect2>

<sect2>
<title>Credits and License</title>
<para>Originally, &fsview; was meant as a small test application and
usage tutorial for the TreeMap widget developed within
<application>KCachegrind</application>.</para>
<para>Copyright by Josef Weidendorfer, licensed using GPL V2.</para>
</sect2>

</sect1>
</chapter>

<chapter id="config"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>


<title>Configuring &konqueror;</title>

<para>In common with the rest of &kde;, &konqueror; is highly configurable, so
you can really get the look and feel that best fits your needs and
wishes.</para>
<!--FIXME replace with link to fundamentals-->
<sect1 id="configure-bars">
<title>Toolbars</title>

<para>When &kde; is newly installed, &konqueror;'s window contains a Menubar, 
Main and Location Toolbars and possibly a Bookmark Toolbar.</para>

<para>Maybe you don't need all these toolbars. To hide one of them, go into
the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Toolbars Shown</guisubmenu>
</menuchoice> menu and uncheck its box. To show a hidden toolbar, just check 
the box.</para> 

<para>The Menubar itself can be toggled on and off with the shortcut key 
combination <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>.
</para>

<para>If you <mousebutton>right</mousebutton> click on a Toolbar, you 
will get a menu to configure this bar. You can lock or unlock the toolbar position
and choose the text position, icon size and the orientation of unlocked bars.</para>

<para>If the toolbars are unlocked, on the left hand end of each bar you can see  
some handles. By &LMB; clicking on them, you can drag a bar into a new position
and even detach it from the window and place it anywhere on your screen.</para>

<para>The icons shown in the various bars can be changed by using the 
<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure 
Toolbars...</guimenuitem></menuchoice> option, which brings up the 
<guilabel>Configure Toolbars</guilabel> dialog box. The
number and type of these toolbars will depend on whether &konqueror; is in Web
Browser or File Manager mode and whether you have &konqueror; plugins
installed.</para>

</sect1>
<!--FIXME replace with link to fundamentals-->
<sect1 id="configshort">
<title>Shortcuts</title>
<para>To change the shortcut key arrangements used by &konqueror; select 
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...
</guimenuitem></menuchoice>. This will launch a dialog box as shown below.
</para>
<mediaobject>
<imageobject>
<imagedata fileref="shortcut1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shortcut config screenshot 1</phrase>
</textobject>
</mediaobject>
<para>Use the search box to find the action you want to add or 
change the shortcut keys for and select it by <mousebutton>left</mousebutton> 
clicking on the name. </para>

<para>After you have selected an action in the list you will notice that
this item is highlighted and you see two additional check boxes below
this item in the list view. There you can configure a
combination of keys or maybe no key binding at all for the selected
action. </para>

<mediaobject>
<imageobject>
<imagedata fileref="shortcut2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shortcut config screenshot 2</phrase>
</textobject>
</mediaobject>

<itemizedlist>
<listitem><para><guilabel>Default</guilabel>: the selected action
will be associated with &kde;'s default value. This is a good choice
for most actions, as &kde; comes with reasonable key bindings we have
thought about. </para></listitem>
<listitem><para><guilabel>Custom</guilabel>: if this option is
enabled, you can create a key combination for the selected
action. Click on the button labeled either <guibutton>None</guibutton>
or labeled with the previously selected custom shortcut. Now the button label
changes to <guibutton>Input</guibutton>. Then press any modifier key
(&ie; &Shift;, &Ctrl;, or &Alt;) and then normal key or a function key (&eg; <keycap>F11</keycap>)
you want to assign to this key combination.</para></listitem>
<listitem><para>You can reset the shortcut to <guilabel>None</guilabel> by using 
this button: <inlinemediaobject><imageobject> <imagedata
fileref="reset.png" format="PNG"/></imageobject></inlinemediaobject>.
</para>
<para>Clicking on the <guilabel>Alternate</guilabel> column of a row in the list
allows to edit the second shortcut for the action.</para></listitem>
</itemizedlist>

</sect1>

<sect1 id="othersettings">
<title>Other Settings</title>
<para>Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure Konqueror...</guimenuitem></menuchoice> brings up a dialog box 
which you can use to control most aspects of &konqueror;'s behavior.</para> 
<para>It contains these sections which are selected by <mousebutton>left
</mousebutton> clicking on one of the icons at the left of the dialog 
box:</para>
<itemizedlist>
<listitem><para><ulink url="help:/kcontrol/khtml-general/index.html">General</ulink>: 
Configure general &konqueror; behavior</para></listitem>
<listitem><para><ulink url="help:/kcontrol/performance/index.html">Performance</ulink>: 
Configure settings that can improve &konqueror;'s performance</para></listitem>
<listitem><para><ulink url="help:/kcontrol/bookmarks/index.html">Bookmarks</ulink>: 
Configure the bookmarks home page</para></listitem>
<listitem><para><ulink url="help:/kcontrol/filemanager/index.html">File Management</ulink>: 
You can configure how Konqueror behaves as a file manager here</para></listitem>
<listitem><para><ulink url="help:/dolphin/configuring-dolphin.html#preferences-dialog-viewmodes">View Modes</ulink>: 
Configure file manager view modes</para></listitem>
<listitem><para><ulink url="help:/dolphin/configuring-dolphin.html#preferences-dialog-navigation">Navigation</ulink>: 
Configure file manager navigation</para></listitem>
<listitem><para><ulink url="help:/dolphin/configuring-dolphin.html#preferences-dialog-services">Services</ulink>: 
Configure file manager services</para></listitem>
<listitem><para><ulink url="help:/dolphin/configuring-dolphin.html#preferences-dialog-general">General</ulink>: 
Configure general file manager settings</para></listitem>
<listitem><para><ulink url="help:/kcontrol/filetypes/index.html">File Associations</ulink>: 
Configure file associations</para></listitem>
<listitem><para><ulink url="help:/kcontrol/trash/index.html">Trash</ulink>: 
Configure trash settings</para></listitem>
<listitem><para><ulink url="help:/kcontrol/khtml-behavior/index.html">Web Browsing</ulink>: 
Configure the browser behavior</para></listitem>
<listitem><para><ulink url="help:/kcontrol/proxy/index.html">Proxy</ulink>: 
Configure the proxy servers used</para></listitem>
<listitem><para><ulink url="help:/kcontrol/kcmcss/index.html">Appearance</ulink>: 
Configure how to display web pages</para></listitem>
<listitem><para><ulink url="help:/kcontrol/khtml-adblock/index.html">AdBlocK Filters</ulink>: 
Configure &konqueror; AdBlocK filters</para></listitem>
<listitem><para><ulink url="help:/kcontrol/ebrowsing/index.html">Web Shortcuts</ulink>: 
Configure enhanced browsing</para></listitem>
<listitem><para><ulink url="help:/kcontrol/cache/index.html">Cache</ulink>: 
Configure web cache settings</para></listitem>
<listitem><para><ulink url="help:/kcontrol/history/index.html">History</ulink>: 
Configure the history sidebar</para></listitem>
<listitem><para><ulink url="help:/kcontrol/cookies/index.html">Cookies</ulink>: 
Configure the way cookies work</para></listitem>
<listitem><para><ulink url="help:/kcontrol/useragent/index.html">Browser Identification</ulink>: 
Configure the way Konqueror reports itself</para></listitem>
<listitem><para><ulink url="help:/kcontrol/khtml-java-js/index.html">Java &amp; JavaScript</ulink>: 
Configure the behavior of Java and JavaScript</para></listitem>
<listitem><para><ulink url="help:/kcontrol/khtml-plugins/index.html">Plugins</ulink>: 
Configure the browser plugins</para></listitem>
</itemizedlist>
<para>Pressing the <guibutton>Help</guibutton> button will give you 
detailed instructions about how to use each of these sections, or you can 
use the <link linkend="bubble">What's This?</link> feature.</para>
</sect1>

</chapter>

<chapter id="commands"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>Command Reference</title>

<note><para>The shortcut key combinations shown in this chapter are the 
default ones. They can of course be <link linkend="configshort">changed</link>.
</para></note>

<sect1 id="specshort">
<title>Special Shortcuts</title>
<para>There are some useful shortcuts that are not shown in any of the menus:</para>
<variablelist>

<varlistentry>
<term><keycap>F6</keycap></term>
<listitem>
<para>Sets the focus to the text entry box in the Location Toolbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></term>
<listitem>
<para>Activate the next tab page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo></term>
<listitem>
<para>Activate the previous tab page.</para>
</listitem>
</varlistentry>

</variablelist>


</sect1>

<sect1 id="menubar">
<title>The Menubar</title> <para>Note that some menu entries only appear when
they are applicable to the file you currently have open in &konqueror;. For
example, the
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem>
</menuchoice>
item will not appear when you are viewing the contents of a directory.</para>

<para>&konqueror; has different menu items in file manager and browser mode. Only 
the items for these two modes are described in this chapter.
</para>

<para>If <emphasis>&konqueror;</emphasis> is using embedded components (&kde; Parts) 
such as <application>Gwenview</application> for image viewing, &okular; for
<acronym>PDF</acronym> and &PostScript; documents &etc; the menu items from these
applications are merged into &konqueror;'s menu. Help for these additional menu items
you find in the handbook of the embedded application.</para>

<sect2 id="menu-location">
<title>The File Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New Window</guimenuitem>
</menuchoice></term>
<listitem><para>Open another &konqueror;
window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu> <guimenuitem>New Tab</guimenuitem>
</menuchoice></term> 
<listitem><para>Open another &konqueror; tab, containing a
blank page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>O</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open Location...</guimenuitem>
</menuchoice></term>
<listitem><para>Sets the focus to the text entry box in the Location Toolbar.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open File...</guimenuitem>
</menuchoice></term>
<listitem><para>Open a file using the &kde; file dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Sessions</guimenuitem>
</menuchoice></term>
<listitem><para>Open a submenu to save the current session (open tabs and windows)
for easy retrieval, manage sessions and switch to previously saved sessions.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Send Link Address...</guimenuitem>
</menuchoice></term>
<listitem><para>Send an email containing a link to the current
location.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Send File...</guimenuitem>
</menuchoice></term>
<listitem><para>Send an email containing the selected file as an
attachment.</para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save Background Image As...</guimenuitem></menuchoice> (Browser mode)</term>
<listitem>
<para>Only applies if you are viewing a web page with a background image. Opens
the <guilabel>Save As</guilabel> dialog box to let you save the background
image file to your own computer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save As...</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Only applies if you are viewing a document or web page, uses
the <guilabel>Save As...</guilabel> dialog box to let you save a copy to your own
computer.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save Frame As...</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Similar to <guimenuitem>Save As...</guimenuitem> but for
use with a web site that uses frames.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem><para>Print.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Print Frame</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Print selected frame of a Web
page.</para></listitem>
</varlistentry>
<!--FIXME
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Open With</guimenuitem>
</menuchoice></term>
<listitem><para>???</para></listitem> 
</varlistentry>
browser 2 items + submenu with apps
filemanager dophin/gwenview + submenu with apps
is this hardcoded? detected at runtime?

DF: The list of applications is entirely dynamic, it is the list of
   apps associated with the mimetype (of the current URL).
 Compare with "Edit File Associations"  (kcmshell filetypes), you'll see that
  it's the same list of apps, so it entirely depends on which apps are installed
  on the system.

-->
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para>Close down this instance of
&konqueror;.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-edit">
<title>The Edit Menu</title>

<!-- not in kde4
note><para>Most items in the Menubar <guimenu>Edit</guimenu> menu can also be
found by &RMB; clicking on a free area of a view.</para></note-->

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Undo: <replaceable>Action</replaceable></guimenuitem>
</menuchoice></term>
<listitem><para>Sometimes lets you reverse a mistaken
action.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice></term>
<listitem><para>Puts selected item(s) into the clipboard.  If
you then paste the items they will be moved
from the original location to the new one.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem><para>Copy selected item(s) to the
clipboard.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Paste the clipboard content into the Location Bar.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste Clipboard Contents...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Paste the currently copied/cut item(s) to the current folder. If the
clipboard does not contain files or folders, the clipboard contents (such as text 
or image data) will be pasted into a new file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
</shortcut><guimenu>Edit</guimenu>
<guimenuitem>Select All</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Selects all text in an &HTML; 
page or in a text page being previewed, you can then 
<guimenuitem>Copy</guimenuitem> it and <guimenuitem>Paste</guimenuitem> it into 
a text editor.</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guisubmenu>Create New</guisubmenu></menuchoice> (File Manager mode)</term>
<listitem><para>Creates a new object (such as a folder or a text file) in 
the current folder. See the <link linkend="making">Create
New...</link> section for more details.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F2</keycap>
</shortcut><guimenu>Edit</guimenu>
<guimenuitem>Rename</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Lets you rename a file or folder without 
having to open the <guimenuitem>Properties...</guimenuitem> dialog box.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>Del</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Move to Trash</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Move selected item(s) to the Trash
folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Delete</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Delete the selected item(s).</para></listitem>
</varlistentry>

<!-- not in kde4
varlistentry>
<term><menuchoice>
<shortcut><keycap>F7</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy Files</guimenuitem>
</menuchoice></term>
<listitem><para>Copy the selected item(s) to another
folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Move Files</guimenuitem>
</menuchoice></term>
<listitem><para>Move the selected item(s) to another
folder.</para></listitem>
</varlistentry-->

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Edit File Type...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open the <guilabel>Edit File Type</guilabel>
dialog box</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Return</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Properties...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Shows the properties dialog for the currently selected item(s).</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guisubmenu>Selection</guisubmenu>
<guimenuitem>Select Items Matching...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Together with the <guimenuitem>Unselect Items Matching...</guimenuitem>,
<guimenuitem>Unselect All</guimenuitem> and <guimenuitem>Invert Selection</guimenuitem> 
commands, this provides an easy and powerful way of selecting
multiple files.</para>
<para>It brings up a simple dialog box where you can enter a file
name using the wild card characters * and ?, for example entering
<literal role="extension">*.html</literal> will select all files ending with
<literal role="extension">.html</literal> while <filename>?a*</filename> will
select all files which have the letter a as the second character in their
filename.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guisubmenu>Selection</guisubmenu>
<guimenuitem>Unselect Items Matching...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Unselect files or folders via a dialog similar to the one used
by <guimenuitem>Select...</guimenuitem>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
</shortcut><guimenu>Edit</guimenu>
<guisubmenu>Selection</guisubmenu>
<guimenuitem>Select All</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Selects all items in a folder; you can then
<guimenuitem>Copy</guimenuitem> or <guimenuitem>Cut</guimenuitem> them and
<guimenuitem>Paste</guimenuitem> them into a different folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guisubmenu>Selection</guisubmenu>
<guimenuitem>Unselect All</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Unselect all selected files or
folders.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>
</shortcut><guimenu>Edit</guimenu>
<guisubmenu>Selection</guisubmenu>
<guimenuitem>Invert Selection</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Invert current selection.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> 
  <!-- Alternate keycombo action="simul">&Shift;<keycap>/</keycap></keycombo--><!--FIXME not webkit-->
</shortcut><guimenu>Edit</guimenu>
<guimenuitem>Find...</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Displays the search bar at the bottom of the current window.
Start typing to find a text string in a text page you are previewing or in an &HTML;
page.</para></listitem>
</varlistentry>
<!--FIXME no menu item in WebKit view mode 
WebKit+KHTML mode find bar with 
Next F3, Previous Shift F3 + Options 
WebKit Match Case/Highlight All Matches/Search As You Type
KHTML Case sensitive/Whole words only/From cursor/Selected Text/Regular expression/Find links only
-->
<varlistentry>
<term><menuchoice>
<shortcut><keycap>F3</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Find Next</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Find the next occurrence of the text string 
in the text or &HTML; page.</para></listitem> 
</varlistentry>
<!--FIXME no menu item in WebKit view mode -->
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Find Previous</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Find the previous occurrence of the text string 
in the text or &HTML; page.</para></listitem> 
</varlistentry>
<!--
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Find Text as You Type</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>???</para></listitem> 
</varlistentry>

DF: No the initial shortcut is "/"  (forward slash). This matches VI, for instance.
F3 is "find again", after 

<varlistentry>
<term><menuchoice>
<shortcut><keycap>'</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Find Links as You Type</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>???</para></listitem> 
</varlistentry>
> BL: both disabled in menu

DF: bug in khtml. enableFindAheadActions(false) called by focusOutEvent.
   How about we just get rid of this shortcut, and let people use Ctrl+F instead?

DF: We still have to do something about "find text in links", ideally integrating that functionality
 into the find bar; as a short term fix we could just give it a better (Ctrl+something) shortcut
 and get rid of the "focusin/focusout enables/disables the action" logic.

> BL: but shortcut works then typing -> to the first match, then stops
> BL: how to find next match? why does it stop?

DF: Not sure what you mean, '/' + search string + F3 F3 F3 works here.

-->
<!-- not in kde4 from editor view
varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Go to Line...</guimenuitem>
</menuchoice></term>
<listitem><para>Go to a particular line number in a text
page you are previewing.</para></listitem>
</varlistentry-->

</variablelist>

</sect2>

<sect2 id="menu-view">

<title>The View Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>View Mode</guisubmenu>
</menuchoice></term>
<listitem><para>In browser mode this submenu holds items to select embedded
views like <guimenuitem>KHTML</guimenuitem>, <guimenuitem>Embedded Advanced 
Text Editor</guimenuitem> and more embedded views.</para>
<para>In file manager mode this submenu holds items to select <guimenuitem>Icon</guimenuitem>,
<guimenuitem>Details</guimenuitem>, <guimenuitem>Compact</guimenuitem>,
<guimenuitem>Terminal Emulator</guimenuitem> and more view modes.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Use index.html</guimenuitem>
</menuchoice> (File Manager mode)</term>
<listitem><para>If a selected folder contains a file 
<filename>index.html</filename>, it will be opened as a web
page rather than showing the folder as a list of
files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Lock to Current Location</guimenuitem>
</menuchoice></term>
<listitem><para>A locked view cannot change folders. Use in combination 
with <guimenuitem>Link View</guimenuitem> to explore many files from 
one folder.</para></listitem>
</varlistentry>
  
<!-- not in kde4
varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Unlock all views</guimenuitem>
</menuchoice></term>
<listitem><para>Unlock all views.
</para></listitem>
</varlistentry-->

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Link View</guimenuitem>
</menuchoice></term>
<listitem><para>Link current view to others in a multiple view
window. A linked view follows folder changes made in other linked views.
This is especially useful with different types of views, such as a folder tree 
with an icon view or detailed view, and possibly a terminal emulator window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F5</keycap></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice></term>
<listitem><para>Reload.</para></listitem>
</varlistentry>
	  
<varlistentry>
<term><menuchoice>
<shortcut>&Esc;</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Stop</guimenuitem>
</menuchoice></term>
<listitem><para>Stop load (particularly useful when web
browsing).</para></listitem>
</varlistentry>
<!--FIXME Browser mode WebKit
  Zoom In, Zoom Out, Actual Size, Zoom Text Only-->
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Enlarge Font</guimenuitem></menuchoice> / 
<menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Shrink Font</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Use these to adjust the size of the text in the
page if you find it difficult to read. How well this works will
depend on how the web page has been constructed.</para></listitem> 
</varlistentry>

<!--  not in kde4
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Icon Size</guimenuitem>
</menuchoice></term>
<listitem><para>Select size of icons used when
viewing a folder in Icon Mode.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>Sort</guisubmenu>
</menuchoice></term>
<listitem><para>Choose order in which items are presented in the
window when in Icon or MultiColumn View mode.</para></listitem>
</varlistentry>
  
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Case Insensitive Sort</guimenuitem>
</menuchoice></term>
<listitem><para>Choose whether the sort order in Tree, Detailed List
or Text View modes is case sensitive.</para></listitem>
</varlistentry>
-->
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap>
</keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>View Document Source</guimenuitem></menuchoice> (Browser mode - KHTML view)</term>
<listitem><para>View document source text.</para>
<para>Only available if you are viewing a document or &HTML;
page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>View Frame Source</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>View frame source text</para>
<para>Only applies if you are viewing a web site that uses frames. Similar to 
<guimenuitem>View Document Source</guimenuitem>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap>
</keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>View Document Information</guimenuitem></menuchoice> (Browser mode - KHTML view)</term>
<listitem><para>View document information, such as title, &URL;, and &HTTP;
headers used in retrieving the document.</para>
<para>Only available if you are viewing an &HTML;
page.</para>
</listitem>
</varlistentry>
<!-- not in kde4
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Security...</guimenuitem>
</menuchoice></term>
<listitem><para>Tells you whether the current browser connection is
secured with <acronym>SSL</acronym> and lets you bring up the
<guilabel>Cryptography Configuration...</guilabel> dialog
box. <mousebutton>Left</mousebutton> clicking on the Menubar padlock icon does
the same thing.</para></listitem> </varlistentry>
-->
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Set Encoding</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Allows you to choose the character encoding used to display
&HTML; pages. <guimenuitem>Default</guimenuitem> is usually the best
choice.</para></listitem>
</varlistentry>
<!-- what is this?
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Use Stylesheet</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>???Automatic Detection Basic Page Style KDE Stylesheet</para></listitem>
</varlistentry>
http://websvn.kde.org/?view=revision&revision=269436
-->
<!--FIXME synced with Dolphin 4.11-->
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>Sort By</guisubmenu></menuchoice> (File Manager mode)</term>
<listitem><para><action>Changes whether items are sorted</action> by <guimenuitem>Name</guimenuitem>
or other criteria described in <link linkend="dolphin-view-information">Information in the View</link>.</para>
<para><guimenuitem>Descending</guimenuitem> reverses the sort order.
<guimenuitem>Folders First</guimenuitem> sorts folders before files.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>Additional Information</guisubmenu></menuchoice> (File Manager mode)</term>
<listitem><para><action>Displays additional information</action> 
described in <link linkend="dolphin-view-information">Information in the View</link>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Preview</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para><action>Displays a symbolic preview of the file contents </action> in the different
view modes.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Show in Groups</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para><action>Displays</action> the content of the
current folder grouped by the option selected in <guimenuitem>Sort By</guimenuitem> 
(only available in the Icons view mode).</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Show Hidden Files</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para><action>Shows all the hidden files and sub-folders within the current
folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Adjust View Properties...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para><action>Opens the <link linkend="view-properties-dialog">View Properties
Dialog</link>.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="menu-go">
<title>The Go Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keysym>Up</keysym></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Up</guimenuitem>
</menuchoice></term>
<listitem><para>Go up a level in the folder
hierarchy.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keysym>Left</keysym></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Back</guimenuitem>
</menuchoice></term>
<listitem><para>Go back to the previous
view.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keysym>Right</keysym></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para>You can only go forward if you've previously gone
back.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Home Page</guimenuitem></menuchoice> (Browser mode)</term>
<listitem><para>Go to your home page as defined on the <guilabel>General</guilabel> 
page of the settings dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Home Folder</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para><action>Changes</action> to the users home folder, &eg;,
/home/Peter/.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Applications</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open the folder holding your
applications.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Network Folder</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Network folders show up in a special location of &konqueror; and 
&dolphin; called a virtual folder. You can find more information on how to use this folder
in the <ulink url="help:/knetattach/index.html">KNetAttach Handbook</ulink>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Settings</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open a virtual folder with all &systemsettings; modules in 
<guimenuitem>Icons</guimenuitem>, <guimenuitem>Details</guimenuitem> or 
<guimenuitem>Columns</guimenuitem> view. Select an item to display the 
settings module in a separate dialog window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Trash</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open your <filename class="directory">Trash</filename>
folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Autostart</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open your <filename class="directory">Autostart</filename> 
folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>H</keycap></keycombo>
</shortcut><guimenu>Go</guimenu>
<guimenuitem>Show History</guimenuitem>
</menuchoice></term>
<listitem><para>shows a tree view of your browsing history in a separate window. 
See <link linkend="sidebar">Sidebar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guisubmenu>Most Often Visited</guisubmenu>
</menuchoice></term>
<listitem>
<para>Displays a submenu showing the &URL;s you visit most often. Selecting one
of these will make &konqueror; open that &URL;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guisubmenu>Recently Visited</guisubmenu>
</menuchoice></term>
<listitem>
<para>Displays a submenu showing the &URL;s you recently visited. Selecting one
of these will make &konqueror; open that &URL;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guisubmenu>Closed Items</guisubmenu>
</menuchoice></term>
<listitem>
<para>Displays a submenu showing the closed &URL;s you visit. Selecting one
of these will make &konqueror; open that &URL;. Use <guimenuitem>Empty Closed Items 
History</guimenuitem> to clear the submenu.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-bookmarks">
<title>The Bookmarks Menu</title>

<note><para>See the section <link linkend="bookmarks">Using Bookmarks</link>
in this manual for a fuller description of these menu items.
</para></note>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
</shortcut>
<guimenu>Bookmarks</guimenu>
<guimenuitem>Add Bookmark</guimenuitem>
</menuchoice></term>
<listitem><para>Add current selection to your
bookmarks.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Bookmarks</guimenu>
<guimenuitem>Bookmark Tabs as Folder...</guimenuitem>
</menuchoice></term>
<listitem>
<para>Create a bookmark folder containing links to all of the &URL;s currently
open in &konqueror; tabs. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Bookmarks</guimenu>
<guimenuitem>New Bookmark Folder...</guimenuitem>
</menuchoice></term>
<listitem><para>Create a new folder in your Bookmarks
folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Bookmarks</guimenu>
<guimenuitem>Edit Bookmarks...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the <link linkend="bookmarks">Bookmark Editor</link>.
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="menu-tools">
<title>The Tools Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F4</keycap></shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Open Terminal</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open a &konsole; terminal
 window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Find File...</guimenuitem></menuchoice> (File Manager mode)</term>
<listitem><para>Open the &kfind; application.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guisubmenu>Select Remote Charset</guisubmenu></menuchoice> (File Manager mode)</term>
<listitem><para><action>Offers to choose the charset used by a remote
connection manually.</action></para></listitem>
</varlistentry>

</variablelist>

<para>If you have &konqueror; plugins installed there will be additional
entries in the <guimenu>Tools</guimenu> menu. See the <link
linkend="konq-plugin">&konqueror; Plugins</link> chapter for further
details.</para>
</sect2>

<sect2 id="menu-settings">
<title>The Settings Menu</title>

<note><para>See also the section <link linkend="save-settings">Saving Settings
and Profiles</link>.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Toolbars Shown</guisubmenu>
</menuchoice></term>
<listitem><para>Opens a submenu where you can choose to show or hide
the various Toolbars.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Show Menubar</guimenuitem>
</menuchoice></term>
<listitem><para>Show/Hide the menubar.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Terminal Emulator</guimenuitem>
</menuchoice></term>
<listitem><para>Open a small text terminal view at the bottom of the
main window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Show Sidebar</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the display of the &konqueror; sidebar. See
<xref linkend="sidebar"/>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;
<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Full Screen Mode</guimenuitem>
</menuchoice></term>
<listitem>
<para>Changes &konqueror; to full screen mode, in which the &konqueror; window
takes up the whole screen, and does not have the usual window decorations. To
exit full screen mode, click on the <guiicon>Exit Full Screen Mode</guiicon>
icon on the toolbar, or press <keycombo action="simul">&Ctrl;&Shift;
<keycap>F</keycap></keycombo>.</para>
</listitem>
</varlistentry>
<!-- not in kde4
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>View Properties Saved in Folder</guimenuitem>
</menuchoice></term>
<listitem><para>Save View properties to current
 folder. If this is selected, a <filename>.directory</filename> file will be
written in the current directory storing the settings you last used to view the
directory. These settings are then loaded when you open the directory in &konqueror;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Remove Folder Properties</guimenuitem>
</menuchoice></term>
<listitem><para>Remove settings stored in folder by <guimenuitem>View
Properties Saved in Folder</guimenuitem>.</para></listitem>
</varlistentry>
-->
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Load View Profile</guisubmenu>
</menuchoice></term>
<listitem><para>Load the settings associated with a particular view profile.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Save View Profile As...</guimenuitem>
</menuchoice></term>
<listitem><para>Save the current settings to the current view profile.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure View Profiles...</guimenuitem>
</menuchoice></term>
<listitem><para>Lets you change an existing view profile or create a
new one.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Extensions...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog with all installed plugins (&eg; from the KDE module extragear)
and allows you to select the ones you need. All plugins are accessible in the
<guimenu>Tools</guimenu> menu.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Configure Spell Checking...</guimenuitem> </menuchoice></term>
<listitem>
<para>Displays the spell checking configuration dialog box, in which you can
change settings associated with spell checking in &konqueror;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term> <listitem><para>Lets you
see and change &konqueror;'s shortcut key bindings, &ie; the
associations between actions such as <guimenuitem>Copy</guimenuitem> and keys
or combinations of keys such as <keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo>. If you do 
this take care not to duplicate an existing shortcut.</para>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term> <listitem><para>
Lets you configure the Main, Extra and Location Toolbars. See the
section <link linkend="configure-bars">Changing Bars</link>. 
</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice> <guimenu>Settings</guimenu>
<guimenuitem>Configure &konqueror;...</guimenuitem> </menuchoice></term>
<listitem><para>Lets you configure &konqueror;'s behavior in file manager and 
browser mode.
</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-window">
<title>The Window Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Split View Left/Right</guimenuitem>
</menuchoice></term>
<listitem><para>Split View Left/Right.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo
action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Split View Top/Bottom</guimenuitem>
</menuchoice></term>
<listitem><para>Split View Top/Bottom.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo
action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Close Active View</guimenuitem>
</menuchoice></term>
<listitem><para>Remove Active View.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>New Window</guimenuitem>
</menuchoice></term>
<listitem><para>Open another &konqueror; window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Duplicate Window</guimenuitem>
</menuchoice></term>
<listitem><para>Open another &konqueror; window, duplicating the
current one.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>New Tab</guimenuitem>
</menuchoice></term>
<listitem><para>Open a new, empty, tab page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Duplicate Current Tab</guimenuitem>
</menuchoice></term>
<listitem><para>Open a duplicate tab page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Detach Current Tab</guimenuitem>
</menuchoice></term>
<listitem><para>Show the current tab page in a new instance of 
&konqueror;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Close Current Tab</guimenuitem>
</menuchoice></term>
<listitem><para>Close the current tab page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>Left</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Move Tab Left</guimenuitem>
</menuchoice></term>
<listitem><para>Move the current tab one place left in the list of tabs.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>Right</keycap></keycombo></shortcut>
<guimenu>Window</guimenu>
<guimenuitem>Move Tab Right</guimenuitem>
</menuchoice></term>
<listitem><para>Move the current tab one place right in the list of tabs.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-help">
<title>The Help Menu</title>
<para>Apart from standard &kde; <guimenu>Help</guimenu> menu items
described in the section <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals you will have the menu entry <guimenuitem>&konqueror; Introduction</guimenuitem>
to revisit the introductory pages that you got when
&konqueror; was first started.</para>

</sect2>
</sect1>

</chapter>

<chapter id="faq"> <!-- 4.11-->
<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>

<title>Questions and Answers</title>

<qandaset>

<!-- Link is dead, unfortunately. I suppose this is a more general thing anyway
<qandaentry>
<question><para>How can I browse web sites using non latin
 scripts?</para></question>
<answer><para>Detailed instructions can be found at <ulink
url="http://www.konqueror.org/i18n.html">http://www.konqueror.org/i18n.html</ulink></para></answer>
</qandaentry>
-->

<qandaentry>
<question><para>Can I run &konqueror; from another window
manager?</para></question>

<answer><para>Just install &Qt;, kdelibs and kdebase, and from your favorite
window manager, launch &konqueror;. It should work just fine, but if it
doesn't (&kde; developers don't test that case often), report it to <ulink
url="http://bugs.kde.org">http://bugs.kde.org</ulink> and try running
<application>kdeinit</application> before running &konqueror;; it usually
helps.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Where does &konqueror; keep all its configuration
data?</para></question>
<answer><para>Generally in the <filename>~/.kde</filename> folder (this may 
be <filename>~/.kde4</filename> on your system, depending on how &kde;  
was installed). Don't alter these files unless you really know what you are 
doing.</para>

<itemizedlist>

<listitem><para>The <filename
class="directory">~/.kde/share/apps/konqueror/profiles</filename> folder
holds individual files containing settings for each of your <link
linkend="save-settings">profiles.  </link></para></listitem>

<listitem><para>Your bookmarks are held in <filename
class="directory">~/.kde/share/apps/konqueror/bookmarks.xml</filename></para></listitem>
<listitem><para>Cookies are held in <filename
class="directory">~/.kde/share/apps/kcookiejar/cookies</filename></para></listitem>
<listitem><para>Your history, as used for the auto-completion feature,  is in
<filename>~/.kde/share/config/konq_history</filename></para></listitem>

<listitem><para>In the folder <filename
class="directory">~/.kde/share/config/</filename> the files
<filename>konqiconviewrc</filename>, <filename>konqlistviewrc</filename> and
<filename>konquerorrc</filename> hold a whole lot of general configuration
settings.</para></listitem>

<listitem><para>The folder
<filename class="directory">~/.kde/cache-<replaceable>hostname</replaceable>/http/</filename> 
contains the browser cache.</para></listitem>

<listitem><para>The Sidebar uses the files and subfolders in
<filename class="directory">~/.kde/share/apps/konqsidebartng</filename></para></listitem>
</itemizedlist>

<para>Any folder specific view settings are put into <literal
role="extension">.directory</literal> files in the individual
folders.</para></answer>
</qandaentry>

<qandaentry>
<question><para>How do I clear out the history file?</para></question>
<answer><para>There are two <quote>histories</quote>:</para>
<itemizedlist>
<listitem><para>One is used for text completion in the Location Toolbar text entry
box. To clear this <mousebutton>right</mousebutton> click on the text entry
box and select <guimenuitem>Clear History
</guimenuitem>.</para>
</listitem>
<listitem><para>The other is the log of visited locations. Select the History
page in the Sidebar, 
<mousebutton>right</mousebutton> click on an entry and choose
<guimenuitem>Remove Entry</guimenuitem> (<keycap>Del</keycap>) to remove just that entry or
<guimenuitem>Clear History</guimenuitem> to delete all
entries.</para></listitem>
</itemizedlist>
<note><para>You can also use the application <application>Sweeper</application> from 
the kdeutils module which allows you to clean up cookies, favicons, web history and cache, 
form completion entries and cache policies of visited websites.</para></note>
</answer>
</qandaentry>

<qandaentry>
<question><para>How do I enable, disable or clear the browser
cache?</para></question> <answer>
<para>If you select <menuchoice><guimenu>Web Browsing</guimenu><guimenuitem>Cache</guimenuitem>
</menuchoice> in the dialog launched by selecting  
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
</guimenuitem></menuchoice>, you will be presented with a dialog box that lets 
you disable the cache, clear it or set its size, and change the caching 
policy.</para>
</answer>
</qandaentry>

<qandaentry>
<question><para>How can I change the timeout values used by &konqueror; 
when web browsing?</para></question> <answer>
<para>In the &systemsettings; category <guilabel>Network and Connectivity</guilabel>
on the <menuchoice><guimenu>Network Settings</guimenu>
<guimenuitem>Connection Preferences</guimenuitem></menuchoice> page.</para>
</answer>
</qandaentry>

<qandaentry>
<question><para>How do I set my <quote>home</quote> page - the page loaded
on startup?</para></question>
<answer><para>&konqueror; has a <guilabel>Home Folder</guilabel> used in file manager mode
and a <guilabel>Home Page</guilabel> used in browser mode.</para>

<para>To change these settings launch 
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Konqueror</guimenuitem><guilabel>General</guilabel></menuchoice>.</para>

<para>To set the &konqueror; startup page in filemanager mode select 
<guilabel>Show Introduction Page</guilabel>, <guilabel>Show My Home 
Page</guilabel>, <guilabel>Show Blank Page</guilabel> or <guilabel>Show 
My Bookmarks</guilabel> from the drop down box labeled <guilabel>When 
Konqueror starts</guilabel>.</para>

<para>In browser mode &konqueror; starts with the <guilabel>Home 
page</guilabel> entry.</para>

</answer>
</qandaentry>

<qandaentry>
<question><para>I can't find the answer to my question here.</para></question> 
<answer>
<para>Take a look at <ulink url="http://www.konqueror.org/faq.html">
http://www.konqueror.org/faq.html</ulink> or 
<ulink url="http://www.konqueror.org/konq-java.html">
http://www.konqueror.org/konq-java.html</ulink>.</para>
<para>You may find further information in the <ulink url="http://forum.kde.org/">
KDE Community Forums</ulink> or on <ulink url="http://userbase.kde.org/Konqueror">
Konqueror's KDE Userbase page</ulink>.</para>
</answer>
</qandaentry>

</qandaset>

</chapter>

<chapter id="credits"> <!-- 4.11-->

<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

</chapterinfo>


<title>Credits and License</title>

<para>&konqueror;. Program copyright 1999-2003, the &konqueror;
 developers:</para>

<variablelist>

<varlistentry>
<term>&David.Faure; &David.Faure.mail;</term>
<listitem><para>developer (parts, JavaScript, I/O lib) and maintainer</para></listitem>
</varlistentry>

<varlistentry>
<term>&Simon.Hausmann; &Simon.Hausmann.mail;</term>
<listitem><para>developer (framework, parts)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Michael.Reiher; &Michael.Reiher.mail;</term>
<listitem><para>developer (framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Mattias.Welk; &Mattias.Welk.mail;</term>
<listitem><para>developer</para></listitem>
</varlistentry>

<varlistentry>
<term>&Alexander.Neundorf; &Alexander.Neundorf.mail;</term>
<listitem><para>developer (list views)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Michael.Brade; &Michael.Brade.mail;</term>
<listitem><para>developer (list views, I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Lars.Knoll; &Lars.Knoll.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Antti.Koivisto; &Antti.Koivisto.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Dirk.Mueller; &Dirk.Mueller.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Peter.Kelly; &Peter.Kelly.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering engine,
JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Waldo.Bastian; &Waldo.Bastian.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O
lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Matt.Koss; &Matt.Koss.mail;</term>
<listitem><para>developer (I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Alex.Zepeda; &Alex.Zepeda.mail;</term>
<listitem><para>developer (I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Stephan.Kulow; &Stephan.Kulow.mail;</term>
<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O lib, regression test framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Richard.J.Moore; &Richard.J.Moore.mail;</term>
<listitem><para>developer (&Java; applet support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Dima Rogozin <email>dima@mercury.co.il</email></term>
<listitem><para>developer (&Java; applet support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Wynn Wilkes <email>wynnw@calderasystems.com</email></term>
<listitem><para>developer (&Java;2 manager support and other major improvements
to applet support)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Harri.Porten; &Harri.Porten.mail;</term>
<listitem><para>developer (JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>Stefan Schimanski <email>schimmi@kde.org</email></term>
<listitem><para>developer (&Netscape; plugin support)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</term>
<listitem><para>developer (framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>&George.Staikos; &George.Staikos.mail;</term>
<listitem><para>developer (SSL support, Netscape plugins)</para></listitem>
</varlistentry>

<varlistentry>
<term>Dawit Alemayehu <email>adawit@kde.org</email></term>
<listitem><para>developer (I/O lib, Authentication support)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Torsten.Rahn; &Torsten.Rahn.mail;</term>
<listitem><para>Graphics / icons</para></listitem>
</varlistentry>

<varlistentry>
<term>Torben Weis <email>weis@kde.org</email></term>
<listitem><para>kfm author</para></listitem>
</varlistentry>

<varlistentry>
<term>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term>
<listitem><para>developer (navigation panel framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>&Stephan.Binner; &Stephan.Binner.mail;</term>
<listitem><para>developer (misc stuff)</para></listitem>
</varlistentry>

<varlistentry>
<term>Leo Savernik <email>l.savernik@aon.at</email></term>
<listitem><para>JavaScript access controls, per-domain policies extensions, HTML rendering engine</para></listitem>
</varlistentry>

<varlistentry>
<term>Germain Garand <email>germain@ebooksfrance.org</email></term>
<listitem><para>Developer (HTML rendering engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Zack Rusin <email>zack@kde.org</email></term>
<listitem><para>Developer (HTML rendering engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Tobias Anton <email>anton@stud.fbi.fh-darmstadt.de</email></term>
<listitem><para>Developer (HTML rendering engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Lubos Lunak <email>l.lunak@kde.org</email></term>
<listitem><para>Developer (HTML rendering engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Maks Orlovich <email>maksim@kde.org</email></term>
<listitem><para>Developer (HTML rendering engine, JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>Allan Sandfeld Jensen <email>kde@carewolf.com</email></term>
<listitem><para>Developer (HTML rendering engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Apple Safari Developers </term>
<listitem><para>Developer (HTML rendering engine, JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>Koos Vriezen <email>koos.vriezen@xs4all.nl</email></term>
<listitem><para>Developer (Java applets and other embedded objects)</para></listitem>
</varlistentry>

<varlistentry>
<term>Ivor Hewitt <email>ivor@ivor.org</email></term>
<listitem><para>Developer (AdBlock filter)</para></listitem>
</varlistentry>

<varlistentry>
<term>Eduardo Robles Elvira <email>edulix@gmail.com</email></term>
<listitem><para>Developer (framework)</para></listitem>
</varlistentry>

</variablelist>

<para>Documentation copyright 2000-2003</para>

<itemizedlist>
<listitem><para>&Erwan.Loisant; &Erwan.Loisant.mail;</para></listitem>
<listitem><para>&Pamela.Roberts; &Pamela.Roberts.mail;</para></listitem>
</itemizedlist>

<para>Documentation updated for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para>

<para>Documentation proofreading for &kde; 4.11 by David Palser <email>davidpalser179@btinternet.com</email>.</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>

<para>&konqueror; is part of the kdebase package which is an essential part of
&kde;.</para>

<para>For instructions on acquiring &kde; please see <ulink
url="http://www.kde.org">http://www.kde.org</ulink>.</para>

<para>For further information about &konqueror; you might like to visit 
<ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink>.</para>


<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
</appendix>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->