# The &konqueror; Handbook

Pamela
Roberts

    pamroberts@blueyonder.co.uk

The KDE Team
Developers
Lauri
Watts

    lauri@kde.org

Reviewer
2000
2002
Erwan Loisant, Pamela Roberts
&FDLNotice;
2002-04-08
3.00.00

&konqueror; is &kde;'s advanced File Manager, Web Browser and Universal Viewing Application.

This document describes &konqueror; version 3.0.0

KDE
Konqueror
Kdebase
File Manager
Browser
Viewer

## &konqueror; Basics

Like all &kde; applications, &konqueror; is highly configurable. This document describes how &konqueror; behaves with the normal, default, settings.

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.

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.

### Starting &konqueror;

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.

- If you have a house shaped icon on the panel or desktop, then &LMB; click on it to open &konqueror; as a file manager.

- Or &LMB; click on world shaped icon on the panel or desktop to open &konqueror; in browser mode.

- From the K menu, select Internet Konqueror Web Browser to start it as a browser.

- Alt F2 will open a Run Command dialog box, type ``konqueror`` (lower case) and press Enter or the Run button to start in file manager mode, or just enter a URL such as `http://www.konqueror.org` to start &konqueror; as a browser.

&konqueror; is also started automatically when you left click on a desktop icon that represents a directory, such as the Trash icon, or a URL.

### The Parts of &konqueror;

A brief look at the main parts of &konqueror;'s window:

Here's a screenshot of &konqueror;

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

The Menubar is the strip containing the names of the drop-down menus, left click on a name to alternately show and hide that menu, or you can use Alt the underlined letter in the name as a hot key, for example Alt E to show the Edit menu. The various menus are described in the Menubar section of this document.

The Toolbar contains icons for commonly used operations. Hover the mouse pointer over an icon to see a brief description of what that icon does, left click to activate the icon.

Click the right mouse button on a clear area of the Toolbar to change the appearance and position of the Toolbar.

The Locationbar shows the path to the directory, URL or file being viewed. You can type a path or URL here and press Enter or left click on the Go icon at the right hand end of the Locationbar to go to it. The black icon at the left hand end of the Locationbar clears the text entry box.

The Bookmark Toolbar is the area under the Locationbar in the previous screenshot. You can add frequently used bookmarks here, see the Organising Your Bookmarks section of this document.

The Window is the main area of &konqueror; and can show you the contents of a directory, a web page, document or image. Using the Window menu you can split &konqueror;'s main window into one or more separate views, useful for drag and drop operations.

The Status Bar runs across the bottom of the 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 an Status Bar for each view, and it will include a small light at the left hand end to show which is the active view. Right clicking on the Status Bar brings up the Status Bar Right Mouse Button Menu.

Don't worry if your &konqueror; doesn't look exactly like this screenshot, it is highly configurable. In particular:

- You can use the Settings menu to choose whether to show or hide the Menubar, Toolbar, Locationbar and Bookmark Toolbar.

- You can also flatten the Toolbar, Locationbar and Bookmark Toolbar by &LMB; clicking on the vertical lines at the left hand end of the bars or move them around by holding the &LMB; down while you drag these bars around.

For more details of how to change &konqueror;'s appearance, see the Configuring &konqueror; section

### Tooltips and What's This ?

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

If Tooltips have been enabled in &kde; (K menu Control Center Look & Feel Widget Settings, Enable Tooltips) then when you hover the mouse pointer over a Toolbar button it should bring up a terse description of what that button does.

What's This? is invoked by the Menubar Help What's This ? item, by Shift F1, or by just &LMB; clicking on the question mark near the top right hand corner of &konqueror;'s window. It changes the cursor to show a question mark alongside the arrow.

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 What's This ?, in which case it will display a reasonably comprehensive description of what the control is supposed to do. Most of the dialog boxes that &konqueror; brings up support the What's This? feature.

### Left and Middle Mouse Button Actions

If you click the &LMB; on an item in &konqueror;'s window that item will be activated. Thus

- Left click on an icon in the Toolbar to do whatever that icon is supposed to do.

- Left click on an item in the Menubar to make that menu drop down.

- Left click on a menu item to do that thing.

- Left click on an icon in the Bookmark Toolbar to open that URL.

- Left click on a link in a web page to make &konqueror; follow that link.

- Left click on a directory icon or name and &konqueror; will descend into (show the contents of) that directory.

- Left 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 HTML pages, or previewing text, image or KOffice files, showing them within &konqueror;'s window (Preview means that you can see the file but not change it).

  &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 and add new types, see the section File Associations.

Clicking the &MMB; on a file or directory name or icon does essentially the same as left clicking except that it does it in a new &konqueror; window.

### Right Mouse Button Menus

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

If you have enabled the Right click goes back in history option in the &konqueror; Browser configuration settings a simple right click is equivalent to clicking on the Back button. In this case you can access the context menu by moving the mouse with the right button held down.

On the Titlebar

  Right 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.

On the Toolbar

  Right 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.

On the Locationbar

  Right click in the URL entry box area to perform Cut, Copy, Paste or Clear operations in this area, or to change the automatic path completion features.

On the Bookmark Toolbar

  If you have the Bookmark Toolbar showing, then right click on any free part of it to bring up the Bookmark Toolbar Menu which lets you change its position and whether items are shown as text, icons, or both.

Within a View

  If you right click on any free area of a view then you will get a menu that contains, among other options, the Up, Back, Forward and Reload navigation commands as well as the Create new option from the Edit menu.

On a File or Directory

  This is a most useful feature. Right clicking on the name or icon of any file or directory not only selects that item but also brings up a menu allowing you to Cut, Move, Copy or Remove the item in various ways, add it to your Bookmarks, open it with the program of your choice or preview it, rename it, or edit the file type or properties.

On the Status Bar

  Right click on the Status Bar at the bottom of a window or view to add or remove a view within &konqueror;'s window.

## &konqueror; the File Manager

In &UNIX; and &Linux; all directories are arranged in a simple inverted tree structure descending and branching down from from a single top level directory. This means that you can get from any directory to any other by going up until you reach a common point then down through the appropriate sub-directories until you reach your target.

The position of any file or directory in the tree can be described by its path, which is a simple list of the directories you would have to descend through to get to the target directory. For example `/home/pam` is the subdirectory `pam` of the subdirectory `home` of the top level directory, which is represented by the leading /.

Note that every accessible drive on your system, including other hard disc partitions and your floppy and cdrom, will appear in the tree descending from /. Their exact paths will depend on how your system was set up, but will usually be something like `/mnt/floppy` and `/mnt/cdrom`. See also the section on Floppy and &CD-ROM; Drives.

### Navigation

&konqueror; is an excellent file manager, and as such will display the names of the files and sub-directories held in a directory. The path of the directory you are looking at is shown in the Titlebar and also in the Locationbar.

Sub-directories are usually displayed with an icon that looks a little like a folder, although some special directories, such as `Trash` and `Desktop`, may have different, distinctive, icons. Files have their own icons, which may indicate what type of file it is - or at least what &konqueror; thinks it is.

You can select a file or sub-directory by using the keyboard arrow keys to move through the displayed items. The appearance of the selected item will change and some information about it will be displayed in the Status Bar.

To move between directories you can simply step up and down the tree:

- To descend into a sub-directory &LMB; click on its name or icon, or if you have selected it then just press Enter.

- To go up the directory tree, click on the Up button in the Toolbar, or use Alt Up Arrow, or use the Menubar Go Up option.

You can also go directly to any directory by typing its path into the Locationbar window or into the dialog box invoked by the Menubar Location Open Location item or by Ctrl O. Don't forget that in &Linux; / &UNIX; file and directory names are case sensitive.

Once you have moved to a new directory then you can go back to your previous choice by using the Toolbar Back button, the Menubar Go Back item, or Alt Left Arrow.

Once you have gone back you can go forward. Use the Toolbar Forward button, the Menubar Go Forward item or Alt Right Arrow.

Holding the &LMB; pressed while the mouse pointer is over the Toolbar Up, Back or Forward buttons brings up a menu of recently visited locations.

#### Automatic Path Completion

You can get &konqueror; to help you when you are typing a path into the Locationbar by enabling one of the Text Completion features. To select how &konqueror; does this right click on a clear part of the Locationbar text entry box and select Text Completion. This will let you choose between the following possibilities:

None

  What you get is what you type.

Manual

  Seems to be the same as None.

Automatic

  As you type into the Locationbar window &konqueror; will automatically extend what you type to complete one possible name, highlighting the characters it has added. Continue typing if that's not what you wanted or press Enter to accept it.

Drop-down List

  A drop-down window will appear as you type, showing the possible matches to what you have typed so far. When the path that you want appears in the window then double click on it with the &LMB;. Or you can use the Down Arrow and Up Arrow keys to select it then press Enter.

Short Automatic

  This is like the Automatic mode except that it restricts itself to more sensible suggestions.

You should try out these different modes and pick the one that suits you best.

#### The Navigation Panel

If you want a better view of the directory structure, or easy access to your Bookmarks, History and Network, then the Window Show Navigation Panel option adds a new view at the left of the window as shown above. (For this screenshot the Menubar View View Mode... and View Show details... options have been used to get a text listing of the directory contents in the right hand view rather than one using icons.)

With the Navigation Panel

The Navigation Panel has a number of tabbed pages, containing tree views of your:

- Bookmarks.

- History.

- Home directory.

- Remote (web or ftp) sites.

- The root directory.

When &konqueror; is showing more than one view, there will be a small box at the bottom right of each view. Left clicking on the box toggles an almost invisibly small icon on and off. Views showing this icon are linked. By linking the Navigation Panel and main views left clicking on any item in the Navigation Panel view will automatically show its contents in the other view.

To navigate through the items in a Navigation Panel page using your mouse, left click on a + symbol to show any subdirectories, left on the - symbol to collapse a sub-tree, and once you can see the wanted item, left click on its name or icon to open it in the other window.

Or you can navigate from the keyboard using the Up and Down Arrow keys to move up and down, the Right Arrow key to descend into a directory and the Left Arrow key to collapse a sub-directory. Once you have reached the wanted item then Enter will open it in the other view.

The Bookmarks tree contains your bookmarks, just as displayed by the Bookmarks menu.

The History tree contains URLs for the most recently visited web sites.

The Home Directory tree shown in the Navigation Panel is actually your personal home directory, which will have a path such as `/home/pam2` if your username is pam2.

The Remote page tree shows details of files or web pages you can reach over your network (if you are connected to one).

The Root Directory tree has the path `/`, and is the base directory of your system's local files. If you expand the Root directory you will find another directory called `root`. This belongs to the system administrator or Super User and is her home directory. You will also find a directory called `home`, in which you should be able to find your own Home directory again.

There is also a Services page in the Navigation Panel, containing entries for audio CD, LAN (Local Area Network) and Print System browsers.

#### Finding Files and Directories

If you don't know or can't remember where a file or directory is within your system, then use the Toolbar Find file button or the Menubar Tools Find File... option. This will embed the file finder application &kfind; into &konqueror;'s window. See the Finding Your Lost Files section of the &kde; User's manual for more details about &kfind;.

If the name of a file or directory begins with a period (dot), then it is a hidden file or directory, and will not normally be shown by &konqueror;.

To see the hidden files or sub-directories use the Menubar View Show Hidden Files option.

#### Floppy and &CD-ROM; Drives

Any floppy disk or &CD; drive that you have on your system will usually appear in the `/mnt` directory, having a path something like `/mnt/floppy` or `/mnt/cdrom`, the details will depend on how your system was set up.

&Linux; requires that you `mount` a floppy disk or &CD-ROM; when you have inserted it into the drive, so that &Linux; can see what's on it. You also need to unmount it before removing the disk so &Linux; can register that it is no longer available.

How you do this will depend on how your system:

- You may have an Automount facility, in which case you don't have to bother about explicitly mounting and unmounting, although you may find that the &CD-ROM; occasionally starts up by itself for no apparent reason.

- You may have Floppy and &CD-ROM; icons on your desktop, in which case &LMB; click on the icon to mount a disk. Doing this should also bring up a &konqueror; window showing the contents of the floppy or &CD-ROM;. To unmount right click on the icon and choose the Unmount item. Visit the section Create New... to see how to create such an icon.

- Or you can do it the traditional way by typing into a text console window:

      mount
       /mnt/floppy

  to mount, for example, the floppy drive, and

      umount
       /mnt/floppy

  to unmount it. Type `umount` not `unmount`.

  Rather than having to open a text console to type the `mount` or `umount` commands, you may prefer to use &konqueror;'s Tools Execute Shell Command (Ctrl E) feature.

### Deleting Files and Directories

&konqueror; gives you three ways to dispose of an unwanted file or directory:

- You can move it to the `Trash` directory, which is the safest method as you can get it back when you realise that you have made a mistake.

- You can just plain Delete it, which removes the entry from the directory and adds the disk area occupied by the file(s) to the system's list of free disk areas.

- Or you can Shred it, which is like Delete, but also overwrites the disk area occupied by the file(s) with random data. Useful for disposing of incriminating departmental memos or similar files when you don't want any trace of them to remain on your system.

Theoretically, even shredded files can be recovered by someone with enough skill and determination.

The simplest way of removing a file or directory is to position the mouse pointer over its name or icon and press the &RMB; mouse button, which will bring up a menu containing the options Move to Trash, Delete and Shred.

Or, if you have selected the item, the Menubar Edit menu will give you the choice of Move to Trash, Delete and Shred options.

Del will move a selected item or items to Trash.

Shift Del will really, truly and irrevocably delete the selected item or items.

Ctrl Shift Del will shred the selected item or items.

You won't be able to remove a file or directory if you don't have the necessary permissions, see the section on Super User Mode for further details.

### Moving and Copying

To copy a file or sub-directory between directories you can:

- Position the mouse pointer over its name or icon and hold down the &RMB;, which will bring up a menu containing the Copy option. Choose that.

  Or if the item is selected you can use the Copy button on the Toolbar or the Menubar Edit Copy item, or the Ctrl C hotkey.

- Navigate to the directory you want to copy the item into then Paste the item into the new directory by using the Toolbar Paste button or the Menubar Edit Paste option or the Ctrl V hotkey, 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 Paste option.

Moving a file or sub-directory between directories can be done in the same way as copying, except that you choose the Cut option or Ctrl X instead of Copy. The item that you have Cut will be removed from the original directory when you do the Paste into the new directory.

You can also copy or move selected item(s) to another directory by using Edit Copy Files or Edit Move Files, or by selecting Copy To or Move To from the drop down menu you get when you right click on an file or directory name in the File Manager window.

You may not be able to copy or move a file or directory if you don't have the necessary permissions. See the section on Super User Mode for further details.

#### Using Drag 'n Drop

&konqueror; also supports Drag and Drop copying and moving of files and directories.

You can do this by having two instances of &konqueror;, one showing the directory you want to copy from, the other showing the target directory. Position the mouse pointer over the item you wish to copy or move then, holding the &LMB; pressed, drag it to a clear space in the target

directory. Release the button and you will be presented with a menu choice of Copy or Move. Take care to drop the item into an empty area of the target directory view - dropping it on top of another file name or icon can cause problems.

You can also set up &konqueror; to show more than one directory within its window and drag & drop between them.

Split Views for Drag & Drop

For this screenshot we have used the Menubar Window Split View Left/Right option, also available with the hotkey Ctrl Shift L,

to split the main &konqueror; window into two views, each showing the contents of a different directory.

When the window is split into two (or more) views it is usually best to make sure that they are not linked - the little boxes at the bottom right of each view should be empty.

The active view, that is the one whose path is shown in the Locationbar 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 &LMB; click on an empty area of the view or on its Status Bar.

To remove an active view from &konqueror;'s window use the Ctrl Shift R

hotkey, or the Menubar Window Remove Active View option, or &RMB; click on the Status Bar and choose the Remove Active View option from the resulting menu.

### Selecting Multiple Files

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 directory to another. &konqueror; makes this easy by letting you select multiple files based on similarities in their file names.

Use the Menubar Edit Select... item or the hotkey Ctrl+. This brings up a little dialog box in which you enter a filename containing the wildcard characters *, which matches any number of characters, and ? which matches a single character. Press OK and &konqueror; will highlight all files with matching names. For example;

- ``flag*.png`` will select all filenames starting with the letters flag and ending with `.png`.

- ``memo?.txt`` will select `memo1.txt` and `memo9.txt` but not `memo99.txt`.

When you have selected a range of files, you can narrow down the selection by uing the Menubar Edit Unselect... option or Ctrl- to specify which of the selected files should be removed from the selection.

Use Ctrl U or the Menubar Edit Unselect All option or just &LMB; click on a clear area of the view to cancel the selection(s).

You can even invert the selection, that is deselect all selected files and select those that were previously unselected. Use the Menubar Edit Invert Selection option or Ctrl* to do this.

Once you have selected the right files then the normal delete, copy or move commands will act on all of the selected files at once.

Depending on your keyboard type and locale, you will probably find that the Ctrl+, Ctrl- and Ctrl* hotkeys only work with the Numeric keypad +, - and * keys.

### Create New...

When &konqueror; is in File Manager mode picking Create New... from the Edit menu or from the drop-down menu you get by right clicking on a free area in a directory view gives you a sub-menu letting you create any of the following in the current directory:

Link To Application...

  This option is most useful if you want to create an icon that will open a particular application. It opens a dialog box with four tabbed pages. The first, General, is where you choose an Icon and the text that will appear with it. The second page, Permissions, lets you select who can use or modify the icon. In the Execute page you must enter the command that will run the application, for example `kedit` to start up the &kedit; text editor. `kedit /home/pam/todo.txt` would open the file `/home/pam/todo.txt` in &kedit;. You can generally leave the Application page blank.

  To make the application icon appear on your desktop, create the link in your `~/Desktop` directory (this may be called something slightly different depending on how &kde; was installed on your system) or get to the Create New... sub menu by right clicking on a free area of the desktop.

  If you have a lot of specialised application links and don't want to clutter up the desktop, then why not create them in your Applications directory. You can get there in &konqueror; by choosing Go Applications. Then create a single icon on your desktop to open your Applications directory, which is usually at `~/.kde/share/applink`.

  To put an application link icon into the panel, first create it in the Applications directory then drag the icon onto a clear area of the panel.

Link To Location (URL)...

  This lets you create an icon to open &konqueror; at a particular directory or web page. As with Link To Application... you can make the application icon appear on your desktop by creating the link in your `~/Desktop` directory or going to the Create New... sub menu by right clicking on a free area of the desktop. When you first create it the text shown with the icon will be the full path or &URL;, you can change it by right clicking on the icon, selecting Properties... and entering the preferred text in the General tab page.

Floppy Device...

  Use this option to create an icon that will mount a floppy disk and open an instance of &konqueror; showing the disk's contents. To unmount the disk when you have finished with it right click on the icon and select Unmount. In practice it doesn't have to be a floppy disk but can be any hard disk or partition on your system that is not normally mounted. In most cases you will want to create the icon in your Desktop.

Hard Disc...

  This option is similar to Floppy Device... but for a hard disc drive or partition.

CD-ROM Device...

  This option is similar to Floppy Device... but for a &CD-ROM; drive.

Directory...

  An easy way of creating a new (sub)directory.

Text File...

  Use this to create an ordinary, empty, text file. A little dialog box will be opened for you to enter the name of your new file.

HTML File...

  Creates a skeleton HTML source file. When you type the new file's name into the little dialog box is is probably best to give it a `.html` extension to avoid confusion.

Presentation Document...

  Creates a skeleton Koffice &kpresenter; document. Give its name a `.kpr` extension.

Text Document...

  Creates a skeleton KOffice &kword; document using the standard &kword; style template. Give its name a `.kwd` extension.

Spread Sheet Document...

  Use this to create a new KOffice &kspread; spreadsheet file, and name it with a `.ksp` extension.

Illustration Document...

  Creates a new KOffice &killustrator; document. Name it with the extension `.kil`.

### Changing Name and Permissions

The easiest way to change the name of a file or directory is to right click on it and select Rename.

Or, to change the name or permissions of a file or directory right click on its name or icon and select the Properties... item. Or, if you have selected the file or directory, then you can use the Menubar Edit Properties option.

This will bring up the Properties dialog box which has two tabs:

- General, which gives you some information about the item and lets you change its name and, for a directory, the associated icon.

- Permissions, which shows you the item's ownership and access permissions and lets you change the permissions.

#### Super User Mode

If you are running as a normal user and try to access files outside of your own home directory you will often be prevented from doing so and get an error message such as Access Denied.

To access these files you need to be logged in as the system administrator, often known as the Super User or root.

Rather than logging out then in again, you can launch &konqueror; from the K Menu in Super User mode by selecting System File Manager - Super User . You will be asked for the root login password but as long as you can provide that &konqueror; will be started up with full access privileges to all files on your system.

Take care. As Super User (root), you have complete control of your system, and a wrong command can easily do irrevocable damage.

Also, connecting to the internet as root is an extremely bad idea, as it seriously increases your vulnerability to hacking.

### At the Command Line

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

She could, of course, open an instance of &konsole;, perhaps with &konqueror;'s Menubar Tools Open Terminal option or with Ctrl T.

But &konqueror; has yet another nice feature here, the Menubar Window Show Terminal Emulator option opens up a terminal window as a new view within &konqueror;, and as long as the link icon is visible at the bottom right corner of each view, the terminal will follow any directory changes you make in the normal file manager view.

Including the terminal emulator

## &konqueror; the Web Browser

Browsing www.konqueror.org

### Connecting to the Internet

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 Locationbar window, press Enter, and you are away!

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

- If your machine is connected to a local area network (LAN) that gives you a proxy connection to the Internet then you will have to set &konqueror; up for the proxy connection as described in the Proxy Configuration section.

- 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 distribution you are using. Some ISPs connect their customers to the Internet through a proxy server, in which case see the Proxy Configuration section of this document. You may find it useful to search the archives of your distribution's user group mailing list for help.

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

### Surfing and Searching

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

- Type a &URL; into the Locationbar window, press Enter, and &konqueror; will download and display that page. You can use the auto &URL; completion feature to help you type, this is similar to the auto Path completion feature but bases its choices on your browsing history instead of your system file directories.

- Left click on a link in the page to go there.

- To open a link in a new instance of &konqueror;, leaving the old page still visible, then &RMB; click on the link and select the New Window option.

  You can also select the multiple view mode with Ctrl Shift L

  or the Menubar Window Split View Left/Right 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 HTML pages, but make sure the little link box at the bottom right hand corner is empty when you are doing this.

- To go back to the previous page use the Alt Left Arrow hotkey, the Back button on the Toolbar, or the Menubar Go Back option, just as you do when navigating through your own files.

- Similarly, once you have gone back you can go forward by using Alt Right Arrow, the Forward button, or the Menubar Go Forward option.

If you want to stop the download for any reason then use the Esc key, the Toolbar Stop button or the Menubar View Stop item.

When you are viewing a web page you should see two new icons in the Toolbar, looking like magnifying glasses with small + and - symbols. Use these to adjust the size of the text in the page if you find it difficult to read, although whether this works or not will depend on how the HTML page has been constructed.

Some people seem to spend more time searching for a web page than actually reading it. Do you know that you can just type the subject you are looking for into the Locationbar window, and &konqueror; will automatically submit it to a Web search engine? Try it by entering the name of your home town.

Or you can tell it to use a particular search engine. For example entering `altavista:konqueror` or just `av:konqueror` will use Altavista to do the search. For more details about &konqueror;'s advanced search features see the Enhanced Browsing section.

### Saving and Printing Web Items

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 Location Save As.... If the page you are viewing uses frames, then you will also be given the Location Save Frame As... option, left click in the frame you want to save first.

If the page uses a background image, you can get and save that with the Menubar Location Save Background Image As... option.

But if what you really want is that glorious picture of the latest Ferrari, then &RMB; clicking on the image will give you a drop-down menu with a Save Image As... option. If you choose Copy Image Location instead then the URL will be copied into the clipboard so you can then paste it anywhere you wish. Be sure to respect the owners copyright, and ask for permission before using any pictures saved this way for anything other than your own viewing pleasure.

Right click on a link (which may be an image) and choose Copy Link Location. This copies the URL to the clipboard so you can then paste it into, say, an e-mail to a friend telling her about this wonderful new site.

Printing a copy of the page you are viewing is easily done with the Menubar Location Print... or Print Frame option or with the Toolbar Print button.

### &FTP;

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

With &FTP; you can see files and directories on the distant computer just as if they were on your own system, download them onto your computer using &konqueror;'s normal Copy and Paste 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

    ftp://ftp.kde.org/pub/kde

into the Locationbar 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 `/pub/kde` directory at ftp.kde.org

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

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 anonymous 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.

If you try to access a &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 busy message as a request for a name and password and will therefore pop up a dialog box asking you to supply them.

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 Locationbar, as for example

    ftp://username@ftp.cia.org

&konqueror; will then prompt you for the password.

## Using Bookmarks

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

To open the Bookmarks drop-down list you may either left click on the Menubar Bookmarks item, or use the Alt B hotkey. Once the list is visible, you can navigate through it with the arrow keys or with your mouse, then press Enter or left click to visit the selected location.

To add a new item to the list use Bookmarks Add Bookmark or Ctrl B or right click and select Add To Bookmarks when you are viewing the desired directory or web page.

The Bookmarks list can contain folders containing other bookmarks.

- If you are also using &Netscape;, then a &Netscape; Bookmarks folder can be added to &konqueror;'s bookmark list so you can use your current &Netscape; bookmarks in &konqueror;.

- Items in your Bookmark Toolbar will usually appear in a Bookmark folder called Toolbar although this can be changed with the Bookmark Editor.

- To add a bookmark into a sub-folder rather than into the main Bookmark list, select the folder from the Bookmarks menu and

  use the Add Bookmark item in that folder.

If you have a dual-boot &Linux;/&Windows; system, then Internet Explorer's File Import and Export Export Favorites option will create a `.htm` file containing links to your IE favourites. From within &konqueror; you can then, as long as you have access to the Windows partition, find that file and add it to your bookmarks. In this way you can access all of your old IE favourites.

### Organising Your Bookmarks

The Bookmarks Edit Bookmarks option opens the Bookmark Editor in a new window. Here is where you can:

- Move items around, with Drag 'n Drop or by using Cut and Paste, or Delete unwanted bookmarks and folders. The order in the Bookmark Editor is the order they will appear in the Bookmarks drop down list. You can make the list look even neater by including the occasional separator with the Insert Insert Separator option.

- Create new folders and sub folders using the Create New Folder option in the Insert menu or from the drop down menu you get when you right click on the main part of the window, or with Ctrl N

- Change a bookmark's name by selecting an item and using F2 or the Edit Rename option or by right clicking on the item and selecting Rename. Or change the URL with Edit Change URL or F3

- Change the folder used to hold the Bookmark Toolbar items by selecting that folder then left click on the

  Set As Toolbar Folder in the Edit menu.

- Import or export &Netscape; and Mozilla bookmarks.

If you can't get the Bookmark Toolbar to appear when you check the Show Bookmark Toolbar box in &konqueror;'s Settings menu then select a suitable folder in the Bookmark Editor and left click on the Set As Toolbar Folder in the Edit menu.

## Saving Settings & Profiles

Your current View menu settings (such as the View Mode, Use index.html and Show Hidden Files items) are automatically saved by &konqueror; as the default options.

But you can also specify different View menu settings for any individual directory. To do this check the View Properties Saved in Directory box in the Settings menu, change the View settings to whatever you want then uncheck the View Properties saved in Directory box. Doing this creates a `.directory` file in that directory to hold the directory View settings. Use the Settings Remove Directory Properties option to remove the directory specific settings (or just delete the `.directory` file).

One nice use of this feature is if you have a directory full of pictures. You can set that particular directory to display thumbnails of the pictures (by choosing Icon View and Preview Images from the View menu) when you open it, while not displaying images as thumbnails in other directories.

Your current settings for the Menubar, Toolbar, Locationbar and Bookmark Toolbar are also saved as defaults.

&konqueror;'s overall appearance when you start it up is determined by one of two profiles, depending on whether you start it as a File Manager or as a Browser. These control the window size, whether the window is split into two or more views, whether the Sidebar or Terminal Emulator are shown, and the starting directory or URL.

To change this start up behaviour, simply set &konqueror; to whatever you want, then in the Window menu select Save View Profile File Management or Save View Profile Web Browsing depending on which mode you are in. If you want &konqueror; to start up with an empty window enter `about:blank` into the location bar before saving the profile.

You can also create extra start up profiles and save them with the Window Configure View Profiles... option. You can then select them from the Window Load View Profile drop down menu.

You can create a desktop icon to start &konqueror; with your new profile. First create a desktop icon by dragging the &konqueror; icon from the K menu onto the desktop and selecting Copy Here. Then right click on the new icon, select Properties... and change Program Name in the Execute tab page to ``kfmclient` `openProfile MyNewProfile``, MyNewProfile being what you called the new profile. Then in the General tab page change the name to something like `MyNewProfile.desktop` and pick a more suitable icon.

## Viewing Man and Info Pages

If you want to read &UNIX; Man pages &konqueror; makes it easy, for example type `man:touch` or `#touch` into the locationbar to see the page for the touch command.

And it makes browsing through Info pages an almost pleasant experience. `info:/dir` 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.

## &Netscape; Plugins

Currently, &konqueror; supports &Netscape; 4.x plugins.

If you select Preferences Web Browsing Netscape Plugins from the K menu you will get a dialog box with two tabbed pages; Scan and Plugins.

The Scan page lets you make &kde; scan for new &Netscape; plugins, either manually by pressing the Scan for new plugins button or automatically each time &kde; starts up.

The scan is done by looking through the directories listed in the Scan Directories list for `.so` files containing plugin code. It examines every such file to find out which MIME types the plugin supports. It then creates MIME type definitions for &kde; in the user's `~/.kde/share/mimelnk` directory to make other applications aware of the new mime types.

The Plugins page shows you the &Netscape; plugins that &kde; has found, and for each plugin it lists the MIME types and the filename suffixes it uses to recognise them.

## &konqueror; Plugins

The package kdeaddons contains several useful plugins that interact with &konqueror; in various ways. These are explained below.

Babelfish

  This uses AltaVista's BabelFish site to translate the current HTML page to whatever language you want (within reason). It can be launched with Tools Translate Web Page.

Directory View Filter

  This is controlled by Tools View Filter and allows you to choose which types of item are displayed in a directory.

DOM Tree Viewer

  Selecting Tools Show DOM Tree opens a new window which displays the document object model (DOM) of the current HTML page.

HTML Validator

  This is started with Tools Validate Web Page Validate HTML. It uses the W3C HTML validator to validate the current page, very useful when creating web pages.

CSS Validator

  Started with Tools Validate Web Page Validate CSS, it uses the W3C CSS validator to validate the current page's Cascading Style Sheets.

HTML Settings

  Select Tools HTML Settings to enable or disable a number of HTML settings without going through the Settings dialog.

Image Gallery

  In File Manager mode, you can select Tools Create Image Gallery to create an HTML page with thumbnails of all the images in the current directory. By default the HTML page is called `images.html` and the thumbnails are put into a new `thumbs` directory.

User Agent Changer

  Select Tools Change Browser Indentification to get a menu that allows you to change the User Agent string without going through the Settings dialog procedure.

Navigation Panel Media Player

  This is a simple media player, embedded as a tab page in the Navigation Panel. You can drag songs or videos onto this page to play them.

## Configuring &konqueror;

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.

### Changing Bars

When &kde; is newly installed, &konqueror;'s window contains a Menubar, a Toolbar, a Locationbar and possibly a Bookmark Toolbar.

Maybe you don't need all these bars. To hide one of them, go into the Settings menu and uncheck its box. To show a hidden bar, just check the box.

On the left hand end of each bar you can see some vertical lines. By &LMB; clicking on them, you flatten the bar, meaning that it is hidden but can be quickly restored by clicking on the now horizontal lines. You can also drag a bar into a new position with these lines.

If you right click on a Toolbar, you will get a menu to configure this bar. You can choose the orientation, text position and icon size

If you hide the Menubar, you won't be able to access the Settings menu. To restore it, right click on the view and check Show Menubar.

The icons shown in the various bars can be changed by using the Settings Configure Toolbars... option, which brings up the Configure Toolbars dialog box. The Main and Extra Toolbars are divided into sections, such as Main Toolbar <&konqueror;>, Main Toolbar <khtmlpart> and Extra Toolbar <khtmlsettingsplugin>. The number and type of these sections will depend on whether &konqueror; is in Web Browser or File Manager mode and whether you have &konqueror; plugins installed.

### File Manager Configuration

Choose Settings Configure Konqueror...File Manager or from the K menu select Preferences File Browsing File Manager. This will bring up a dialog box with four tabbed pages; Behavior Appearance, Trash, and Previews.

#### Behavior

The Open directories in separate windows option lets you choose whether Konqueror will open up a new window when you open a directory, or show that directory's contents in the current view.

If you check the Show network operations in a single window box progress information for all network file transfers will be shown in a single window, otherwise separate windows will be opened for each transfer.

If the Show file tips box is checked a small popup window containing additional information will appear when you move the mouse over a file name in Icon View mode. The Number of file tip entries value determines how much additional information is shown.

The Home URL lets you choose where &konqueror; jumps to when you press the Toolbar Home button (this is usually your home directory `~`). It does not affect the first directory shown when &konqueror; is started from a desktop or panel icon.

The Minimize memory usage area is interesting as it lets you trade off memory usage against the consequences of &konqueror; crashing.

Select Never if you have plenty of RAM. A separate instance of &konqueror; will exist in memory for each &konqueror; window that you have opened so that a problem with one is unlikely to affect the others.

If you select For local browsing only a single instance of &konqueror; will exist in memory for all of the local browsing windows you have open, although separate instances will exist for each web browsing window. This means that a problem with any of the local browsing windows can cause all of them to close.

The For web browsing only option is the opposite to For local browsing only so that local browsing windows are isolated from one another but a problem with a web browsing window may cause all web browsing windows to close.

The Always option can be picked if you are short of RAM but means that a problem with any &konqueror; window can cause all open &konqueror; windows to close down.

#### Appearance

This page lets you set the font size and color used by &konqueror; in File Manager mode and how text associated with icons is displayed.

#### Trash

Here you can choose whether or not &konqueror; asks for confirmation before deleting items.

#### Previews

This page lets you control whether file previews are allowed for different protocols. Uncheck the boxes for those protocols which are too slow for comfortable previewing.

### File Associations

What &konqueror; does when you click on a file name or icon is determined by the file type and the list of actions that &konqueror; keeps for the various file types and can be changed to suit your taste or to add a new file type.

For example Right click on a text (`.txt`) file and select the Edit File Type item. This will bring up a dialog box as shown below.

Edit File Type dialog, General tab

Under the General tab, the Application Preference Order section defines what appears in the Open With menu for this type of file. You can change these applications and their order. You can also change the icon that &konqueror; uses for this file type by &LMB; clicking on the icon, and you can add the extensions (Filename Patterns) for any other types of file that you want to be handled in the same way.

&konqueror; is clever enough to recognise most plain text files and treat them as such even though they don't have the `.txt` extension.

The Embedding (which actually refers to the Preview) tab page controls what happens when you &LMB; click on a filename.

File types are divided into several groups; application, audio, image, inode, message, text and video.

&konqueror; can be configured to associate any file type with an installed application.

For example, the Targa image type doesn't exist in &konqueror;. If you have such a file on your disk, it will have a question mark as an icon. If you &LMB; click on it, &konqueror; will ask you which application you want to use. You could just type in the name of a suitable application each time you select a Targa file, but the best approach is to tell &konqueror; what to do with a Targa image.

Let's add the Targa mime type to &konqueror;.

Open the Settings Configure Konqueror... File Associations dialog box and click on the Add... button at the lower left, this will bring up a little dialog box. Select Image in the Group drop down box, type `Targa` in the Type name Text Box, and press OK.

Adding the Targa type, step 2

Now have a look at the upper right hand corner of the File Associations Dialog Box. Click on the icon and choose a nice one, here the best seems to be the image icon. In the Filename Patterns Text Box, add the patterns `*.tga` and `*.TGA` by clicking on the upper right Add... button. This means that every file with the `.tga` or `.TGA` (case is important) extension will now be considered as a Targa image.

&konqueror; now knows what a Targa file is, but it doesn't know what to do with it. We need to tell &konqueror; which application to launch to view a Targa file. At the lower right hand corner in the Application Preference Order area, click on the Add... button bring up the following Dialog Box.

Adding the Targa type, step 3

You can choose an application from the Known Applications List Box, but as we want to use Gimp which is not listed, type `gimp` into the Add Application box.

Gimp is really nice but it is big and not designed for quick viewing. Click once more on the Add... button at the lower right hand corner of the File Associations Dialog Box to bring up the little Application Dialog Box, and in the Add Application Text Box, type `xv` or the name of any other suitable application you can have on your system.

Now you have two application in the list. The first one will be the default application, you can arrange them as you prefer with the Move Up and Move Down buttons.

All Targa files will now be recognized by &konqueror;.

### Konqueror Browser Configuration

Choose Settings Configure Konqueror... Konqueror Browser or from the K menu select Preferences Web Browsing Konqueror Browser. This will bring up a dialog box with five tabbed pages; HTML, Appearance, Java, JavaScript and Plugins.

#### HTML

If you check the Enable completion of forms box in the Form Completion section of this page &konqueror; will remember the data you enter in web forms and suggest it in similar fields for all forms. The Maximum completions value is the number of values &konqueror; will remember for a form field. Note that letting &konqueror; remember this type of data could be considered a security risk.

Checking the Change cursor over links box causes the cursor to change from a pointer to a hand when it is over a link in a web page. This is advisable as otherwise you may miss links which are shown as images rather than text.

If you select Right click goes back in history then a right click on a view will be interpreted as Go Back. In this case you can get the traditional context menu by moving the mouse with the right held down.

If the Automatically load images box is checked &konqueror; will automatically load any images that are embedded in the web page. Otherwise it will display placeholders for the images and you can then manually load them by clicking on the image buttons in the placeholders.

Some web pages request an automatic reload or redirection after a period of time. You can disable this action by unchecking the Allow automatic delayed reloading / redirecting box.

The Underline links section lets you choose whether links are never underlined, always underlined, or underlined only when the mouse tip is over them.

The Animations section controls how animated images are displayed.

#### Appearance

This page lets you set the font type, size, character set and default encoding to be used when browsing.

#### Java

&Java; is not JavaScript but a full featured language. HTML pages using &Java; can cause &Java; programs, usually called applets, to be downloaded and run on your machine.

The Java tab page lets you set &konqueror;'s global and domain-specific policies for &Java;.

The Enable Java globally check box controls whether &konqueror; will generally accept or ignore Java applets, but this can be modified by adding Domain-specific Accept or Reject policies. The full domain name must be entered here, for example to enable (or disable) Java for the site http://news.bbc.co.uk you have to enter `news.bbc.co.uk` in the Host/Domain field, just putting `bbc.co.uk` or `*.bbc.co.uk` will not work.

To run &Java; applets, you need a Java Virtual Machine (JVM) installed on your machine and &konqueror; needs to know where it is. You can usually just enter `java` into the Path to java executable text box, but if that doesn't work or if you have several virtual machines installed and you want &konqueror; to use a particular one then enter the full path to your &Java; installation, such as `/usr/java/bin`.

As with any browser, enabling active content (Java or JavaScript) can weaken your system's security. It is recommended that the Use Security Manager option in the Java tab page is selected if you are enabling &Java;. This requires that the &Java; installation on your machine is Java2 compliant.

Visit http://www.konqueror.org for

up to date information about how well various &Java; JVM's work with &konqueror;.

#### JavaScript

Javascript is a small scripting language often used to add animation or other features to HTML pages. &konqueror; includes an ECMAScript compatible interpreter to handle scripting languages such as &Netscape;'s JavaScript and &Microsoft;'s JScript.

The Enable JavaScript globally check box controls whether &konqueror; will generally accept or ignore Javascript, but this can be modified by adding Domain-specific Accept or Reject policies as for &Java;.

In the JavaScript web popups policy area of the dialog box you can define how &konqueror; handles JavaScript window.open() commands. Some web sites make annoying use of this command to pop up advertizing banners, but be aware that certain sites require the window.open() function for proper operation.

#### Plugins

This tab page lets you globally enable or disable the excution of plugins, such as Flash, that can be contained in web pages. Note that, as with any browser, enabling active content can be a security problem.

For more information about plugins see the section Netscape Plugins.

### Enhanced Browsing

Use the Menubar Settings Configure Konqueror... Enhanced Browsing or the K menu Preferences Web Browsing Enhanced Browsing selection to bring up the KDE Control Module Enhanced Browsing dialog box.

If the Enable Internet Keywords box is checked you can simply type normal words and phrases such as linux into the Locationbar and you will either be redirected to the appropriate site or presented with a list of possible links. To do this &konqueror; submits the word(s) to `www.internetkeywords.org` which will redirect you if it finds a matching Internet Keyword.

The Search Fallback drop down box lets you pick a search engine that will be used if an exact Internet Keyword match isn't found. If you select None then `www.internetkeywords.org` will be used.

If you check the Enable Search Shortcuts box &konqueror; will let you use the Shortcuts defined in the selection box to choose a particular search engine. For example you can type `av:linux` into the Locationbar to search for linux using Altavista.

### Cookie Configuration

Use the Menubar Settings Configure Konqueror... Cookies... or the K menu Preferences Web Browsing Cookies selection to bring up a dialog box with two tabbed pages; Policy and Management.

#### Policy

This page allows you to decide whether &konqueror; will handle cookies at all, and whether it should ask you for confirmation before accepting them.

You can also set domain specific cookie policies and even share them with other people by using the Import and Export options.

#### Management

This tab page is interesting because it lets you see what cookies have been placed on your machine and allows you to delete any or all of them.

### Proxy Configuration

The Proxy configuration dialog box is invoked with the Menubar Settings Configure Konqueror... Proxy option, or with the K menu Preferences Web Browsing Proxy choice.

A proxy connection to the Internet is one that is made through another machine, usually a LAN (Local Area Network) server, and can give you improved security by separating the computers connected to the local network from the wide open world of the Internet itself. A proxy server can also cache downloaded files to give you faster access to recent downloads.

Proxy servers are traditionally associated with a local intranet within an organisation, but are now also used by some Cable Network ISPs who connect their customers living near to each other onto a local area network to improve the overall average performance of the cable network.

If you are on a LAN, the proxy is perhaps the only way you can connect to the web, in which case you need to ask your system administrator or ISP for connection details.

To configure &konqueror; to work with your proxy server, open the Proxies Configuration dialog box, check Use Proxy and fill the fields according what your system administrator or ISP has told you.

Of course, the proxy shouldn't be used to access a machine on your local network. So, in the No Proxy for: field, type the names of local machines on your network separated by commas. This is usually the domain name of your ISP or your company. For example, if you're on the Ireste school network, you would type `ireste.fr, intranet`, intranet being the machine where the intranet web server is located. This is important if you are on a LAN because the proxy won't find the internal machines.

The Use Cache option in the dialog box is not really a proxy option. It allows you to choose to store (cache) downloaded pages on your local disk so they need not be downloaded again the next time you access them. We advise you to use this option (whether you use a proxy or not) unless you are short of disk space in your home directory.

### Cryptography

Choosing the Menubar Settings Configure Konqueror... Crypto or the K menu Preferences Personalization Crypto option brings up a dialog box that lets you configure SSL, certificates and other cryptography settings. Use the Default settings unless you really know what you are doing.

### User Agent

Some web sites tailor their HTML pages according to the browser you are using to view them. This is done to cope with differences between browsers and is done by the web server asking for the browser's User Agent and then comparing it against a list of known browsers. Unfortunately very few web sites recognise &konqueror;.

To overcome this problem, you can control what &konqueror; reports as it's User Agent. Selecting Settings Configure Konqueror... User Agent or the K menu Preferences Web Browsing User Agent will bring up a dialog box allowing you to set the User Agent string for selected sites (for example www.kde.org) or domains (kde.org).

To add a new site or domain specific browser-identification string press the New button, fill in the details in the pop up dialog then press the Update List button. A list of suitable alternative identities is given in the drop down selection box. Note that wildcard characters such as * are not allowed in the site or domain name. Do not forget to press the Apply before closing the User Agent configuration dialog.

## Command Reference

The shortcut key combinations shown in this chapter are the default ones. They can of course be changed.

### The Menubar

#### The Location Menu

&Ctrl;N Location New Window

  Open another &konqueror; window.

&Ctrl;D Location Duplicate Window

  Open another &konqueror; window, duplicating the current one.

&Ctrl;O Location Open Location...

  Open a directory or file by entering its path (for example `/home/pam` or `/home/pam/fred.txt`) in a simple dialog box.

&Ctrl;L Location Send Link

  Send an email containing a link to the current location.

Location Send File

  Send an email containing the selected file as an attachment.

Location Save Background Image As...

  Only applies if you are viewing a web page with a background image. Opens the Save As dialog box to let you save the background image file to your own computer.

&Ctrl;S Location Save As...

  Only applies if you are viewing a document or web page, uses the Save As... dialog box to let you save a copy to your own computer.

Location Save Frame As...

  Similar to Save As... but for use with a web site that uses frames.

&Ctrl;P Location Print...

  Print.

Location Print Frame

  Print selected frame of a Web page.

Location Open With Netscape

  Open the web page you are viewing in &konqueror; with Netscape as well.

&Ctrl;Q Location Quit

  Close down this instance of &konqueror;.

#### The Edit Menu

Most items in the Toolbar Edit menu can also be found by &RMB; clicking on a free area of a view.

&Ctrl;Z Edit Undo

  Sometimes lets you reverse a mistaken action.

&Ctrl;X Edit Cut

  Puts selected item(s) into the clipboard. If you then do a a Paste the item(s) will be moved from the original location to the new one.

&Ctrl;C Edit Copy

  Copy selected item(s) to the clipboard.

&Ctrl;V Edit Paste

  Paste item(s) from clipboard to the currently viewed directory.

F2 Edit Rename

  Lets you rename a file or directory without having to open the Properties... dialog box.

Delete Edit Move to Trash

  Move selected item(s) to the Trash directory.

&Shift;Delete Edit Delete

  Delete the selected item(s).

&Ctrl;&Shift;Delete Edit Shred

  Shred the selected item(s).

F7 Edit Copy Files

  Copy the selected item(s) to another directory.

F8 Edit Move Files

  Move the selected item(s) to another directory.

Edit Create New

  Create a link to an application, URL, Floppy or &CD-ROM; device, or create a new Directory or text or HTML file. See the Create New...section for more details.

Edit Edit File Type...

  Open the Edit File Type dialog box

Edit Properties..

  Open the Edit Properties dialog box

&Ctrl;+ Edit Select...

  Together with the Unselect..., Unselect All and Invert Selection commands, this provides an easy and powerful way of selecting multiple files.

  It brings up a simple dialog box where you can enter a file name using the wild card characters * and ?, for example entering `*.html` will select all files ending with `.html` while `?a*` will select all files which have the letter a as the second character in their filename.

&Ctrl;- Edit Unselect...

  Unselect file or folder.

&Ctrl;U Edit Unselect All

  Unselect all selected files or folders.

Edit Invert Selection

  Invert current selection.

Ctrl U Edit Select All

  Selects all text in a HTML page or in a text page being previewed, you can then Copy it and Paste it into a text editor.

Ctrl F Edit Find

  Find a text string in a text page you are previewing or in an HTML page.

Ctrl F Edit Find in Frame

  Find a text string in an HTML frame.

Edit Go to Line...

  Go to a particular line number in a text page you are previewing.

#### The View Menu

View View Mode...

  Selects Icon, MultiColumn, Tree, Detailed List or Text view mode.

View Use index.html

  If a selected directory contains a file `index.html`, it will be opened as a web page rather than showing the directory as a list of files.

View Lock to current location

  Lock to current location.

View Unlock all views

  Unlock all views.

View Link View

  Link current view to others in a multiple view window.

F5 View Reload

  Reload.

Esc View Stop

  Stop load (particularly useful when web browsing).

View Icon Size

  Select size of icons used when wiewing a directory in Icon Mode.

View Sort...

  Choose order in which items are presented in the window when in Icon or MultiColumn View mode.

View Case Insensitive Sort

  Choose whether the sort order in Tree, Detailed List or Text View modes is case sensitive.

View View Document Source

  View document source text.

  Only available if you are viewing a document or HTML page.

View View Frame Source

  View frame source text

  Only applies if you are viewing a web site that uses frames. Similar to View Document Source.

View Security...

  Tells you whether the current browser connection is secured with SSL and lets you bring up the Cryptography Configuration... dialog box. Left clicking on the Menubar padlock icon does the same thing.

View Set Encoding

  Set encoding

  Allows you to choose the character encoding used to display HTML pages. Auto is usually the best choice.

View Preview

  Lets you choose to show thumbnails of images, text files or HTML pages instead of the normal icons in Icon or MultiColumn View modes.

View Show Hidden Files

  Show hidden (dot) files.

View Show details...

  Lets you choose which file and directory details are shown in Tree, Detailed List and Text views.

View Background Color...

  Select background color for the File Manager mode.

View Background Image...

  Select background image for the File Manager mode.

#### The Go Menu

&Alt;Up Arrow Go Up

  Go up a level in the directory hierarchy.

&Alt;Left Arrow Go Back

  Go back to the previous view.

&Alt;Right Arrow Go Forward

  You can only go forward if you've just gone back.

&Ctrl;Home Go Home URL

  Go to your home directory.

Go Applications

  Open the directory holding your applications.

Go Trash

  Open your `Trash` directory in a separate window.

Go Templates

  Open the `Templates` directory in a separate window.

Go Autostart

  Open your `Autostart` directory in a separate window.

#### The Bookmarks Menu

See the section Using Bookmarks in this manual for a fuller description of these menu items.

&Ctrl;B Bookmarks Add Bookmark

  Add current selection to your bookmarks.

Bookmarks Edit Bookmarks...

  Open your bookmarks directory in a separate window.

Bookmarks New Folder

  Create a new folder in your Bookmarks dirctory.

#### The Tools Menu

&Alt;F2 Tools Run Command...

  Run a program by entering its name in a simple dialog box.

&Ctrl;T Tools Open Terminal...

  Open a &konsole; terminal window.

Tools Find File...

  Open the &kfind; application.

If you have &konqueror; plugins installed there will be additional entries in the Tools menu. See the &konqueror; Plugins chapter for further details.

#### The Settings Menu

See also the section Saving Settings and Profiles.

&Ctrl;M Settings Show Menubar

  Show/Hide the menubar.

Settings Show Toolbar

  Show/Hide the toolbar.

Settings Show Extra Toolbar

  Lets you have a second Toolbar.

Settings Show Location Toolbar

  Show/Hide the locationbar.

Settings Show Bookmark Toolbar

  Show/Hide the Bookmark Toolbar.

Settings View Properties Saved in Directory

  Save View properties to current directory.

Settings Remove Directory Properties

  Remove directory properties.

Settings Configure Shortcuts...

  Lets you see and change &konqueror;'s shortcut key bindings, i.e. the associations between actions such as Copy and keys or combinations of keys such a Ctrl V. If you do this take care not to duplicate an existing shortcut.

Settings Configure Toolbars...

  Lets you configure the Main, Extra and Location Toolbars. See the section Changing Bars.

Settings Configure &konqueror;...

  Lets you configure the File manager, File Associations, Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or Toolbars by bringing up the appropriate dialog box.

#### The Window Menu

See also the section Saving Settings and Profiles.

&Ctrl;&Shift;L Window Split View Left/Right

  Split View Left/Right.

&Ctrl;&Shift;T Window Split View Top/Bottom

  Split View Top/Bottom.

&Ctrl;&Shift;R Window Remove Active View

  Remove Active View.

Window Show Terminal Emulator

  Open a small text terminal view at the bottom of the main window.

F9 Window Show Navigation Panel

  Show/hide the Navigation panel.

Window Save View Profile "File Management"

  Save the current view profile as the default one for File Management mode.

Window Save View Profile "Web Browsing"

  Save the current view profile as the default one for Web Browsing mode.

Window Configure View Profiles...

  Lets you change an existing view profile or create a new one.

Window Load View Profile

  Load a View Profile.

&Ctrl;&Shift;F Window Fullscreen Mode

  Fullscreen Mode.

#### The Help Menu

Help &konqueror; Handbook

  View this document.

&Shift;F1 Help What's This?

  Draws a question mark (?) beside the mouse pointer, clicking on a window item such as the Stop button will then display a brief explanation. See Tooltips and What's This ? .

Help &konqueror; Introduction

  Revisit the introductory pages that you got when &konqueror; was first started.

Help Report Bug...

  Report bug.

Help About konqueror...

  Display some brief information about &konqueror;'s version number, authors and license agreement.

Help About KDE...

  Show some information about the version of &kde; that you are running.

## Questions and Answers

How can I browse web sites using non latin scripts?

Detailed instructions can be found at http://www.konqueror.org/i18n.html

Can I run &konqueror; from another window manager?

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

Where does &konqueror; keep all its configuration data?

Generally in the `~/.kde` directory (this may be `~/.kde3` on your system, depending on how &kde; 3 was installed). Don't alter these files unless you really know what you are doing.

- The `~/.kde/share/apps/konqueror/profiles` directory holds individual files containing settings for each of your profiles.

- Your bookmarks are held in `~/.kde/share/apps/konqueror/bookmarks.xml`

- Cookies are held in `~/.kde/share/apps/kcookiejar/cookies`

- Your history, as used for the auto-completion feature, is in `~/.kde/share/config/konq_history`

- In the directory `~/.kde/share/config/` the files `konqiconviewrc`, `konqlistviewrc` and `konquerorrc` hold a whole lot of general configuration settings.

- The directory `~/.kde/share/cache/http/` contains the browser cache.

- The Navigation Panel uses the files and subdirectories in `~/.kde/share/apps/konqsidebartng`

Any directory specific view settings are put into `.directory` files in the individual directories.

How do I clear out the history file?

There are two histories:

- One is used for text completion in the Locationbar text entry box. To clear this right click on the text entry box and select Empty Contents .

- The other is the log of visited locations. Select the History page in the Navigation Panel, right click on an entry and choose Remove Entry to remove just that entry or Clear History to delete all entries.

How do I enable, disable or clear the browser cache?

If you select Preferences Web Browsing Cache from the K menu you will be presented with a dialog box that lets you disable the cache, clear it or set its size, and change the cacheing policy.

## Credits and License

&konqueror;. Program copyright 1999-2002, the &konqueror; developers:

David Faure faure@kde.org

  developer (parts, I/O lib) and maintainer

Simon Hausmann hausmann@kde.org

  developer (framework, parts)

Michael Reiher michael.reiher@gmx.de

  developer (framework)

Mattias Welk welk@fokus.gmd.de

  developer

Alexander Neundorf neundorf@kde.org

  developer (list views)

Michael Brade brade@kde.org

  developer (list views, I/O lib)

Lars Knoll knoll@kde.org

  developer (HTML rendering engine)

Antti Koivisto koivisto@kde.org

  developer (HTML rendering engine)

Dirk Mueller mueller@kde.org

  developer (HTML rendering engine)

Peter Kelly pmk@post.com

  developer (HTML rendering engine, JavaScript)

Waldo Bastian bastian@kde.org

  developer (HTML rendering engine, I/O lib)

Matt Koss koss@miesto.sk

  developer (I/O lib)

Alex Zepeda jazepeda@pacbell.net

  developer (I/O lib)

Stephan Kulow coolo@kde.org

  developer (I/O lib)

Richard Moore rich@kde.org

  developer (&Java; applet support)

Dima Rogozin dima@mercury.co.il

  developer (&Java; applet support)

Wynn Willkes wynnw@calderasystems.com

  developer (&Java;2 manager support and other major improvements to applet support)

Harri Porten porten@kde.org

  developer (JavaScript)

Stefan Schimanski schimmi@kde.org

  developer (&Netscape; plugin support)

Carsten Pfeiffer pfeiffer@kde.org

  developer (framework)

George Staikos staikos@kde.org

  developer (SSL support)

Dawit Alemayehu adawit@kde.org

  developer (I/O lib, Authentication support)

Carsten Pfeiffer pfeiffer@kde.org

  developer (Framework)

Torsten Rahn torsten@kde.org

  Graphics / icons

Torben Weis weis@kde.org

  kfm author

Joseph Wenninger jowenn@kde.org

  developer (navigation panel framework)

Documentation copyright 2000-2002

- Erwan Loisant erwan@loisant.org

- Pamela Roberts pamroberts@blueyonder.co.uk

&underFDL; &underGPL;

## Installation

&konqueror; is part of the kdebase package which an essential part of &kde;.

For instructions on acquiring &kde; please see http://www.kde.org.

For further information about &konqueror; you might like to visit http://www.konqueror.org.

&documentation.index;