# The &konqueror Handbook

Erwan
Loisant

    erwan@loisant.org

Pamela
Roberts

    pam.roberts@btinternet.com

The KDE Team
Developers
Lauri
Watts

    vampyr@atconnex.net

Reviewer
2000
2001
Erwan Loisant, Pamela Roberts
&FDLNotice;
03/02/2001
2.01.00

&konqueror; is &kde;'s advanced File Manager, Web Browser and /Document Viewer.

This document describes &konqueror; version 2.1

KDE
Konqueror
Kdebase
File Manager
Browser
Viewer

## &konqueror; Basics

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.

### 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 System Konqueror to start &konqueror; as a file manager or 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 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.

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.

### 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 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, or a document. 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 and there is no standard way of setting it up. 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; mouse button down while you drag these bars around.

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

### Bubble Help 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 the Bubble Help and What's This? features.

Bubble Help means that if 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 the Shift F1 hotkey, or by just &LMB; clicking on the question mark near the top right hand corner of a 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) which 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 it 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 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, embedding 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 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 menu:

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 auto 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 this menu, which contains 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, 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 &Linux; all directories are arranged in a simple inverted tree structure descending and branching down from from a single top level root 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 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 basically a 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; file and directory names are case sensitive, although WWW URLs are not.

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.

#### Auto Path Completion

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

None

  What you get is what you type.

Manual

  If you type Ctrl E while you are entering a path into the Locationbar window &konqueror; will complete it as far as it can without ambiguity. For example if the directory contains the two files `testfile19.txt` and `testfile20.txt` entering `t` followed by Ctrl E will extend the filename shown in the Locationbar window to `testfile`, you can then type `2` Ctrl E and the complete name `testfile20.txt` will appear.

Popup

  A popup 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 use the Down Arrow and Up Arrow keys to select it then press Enter.

Automatic

  As you type into the Locationbar window &konqueror; will automatically extend what you type by highlighting one possible completion or partial completion. Continue typing if that's not what you wanted or press Ctrl E to accept the highlighted portion. When the file or directory name you want is fully shown then press Enter.

Semi-Automatic

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

#### The Sidebar

With the Sidebar

If you want a better view of the directory structure, or easy access to your Bookmarks, History and Network, then the Window Show Sidebar option splits the window into two views as shown above.

The left, Sidebar, view contains five trees, labelled Bookmarks, History, Home Directory , Network and Root Directory. The right hand view shows the selected directory or web page. 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.

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 so that a change of directory in one view makes the other view change to the new directory. In this way selecting any item in the Sidebar view will automatically show its contents in the other view.

To navigate through the items in the Sidebar using your mouse;

- Left click on a + symbol to show any subdirectories.

- To collapse a sub-tree &LMB; click on the - symbol.

- Once you can see the wanted item, &LMB; click on its name or icon to open it in the other window.

Or, once you have selected an item in the Sidebar, you can navigate from the keyboard;

- Use the Up and Down Arrow keys to move up and down.

- The Right Arrow key will descend into a directory.

- 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 in the Sidebar 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 shown in the Sidebar is actually your personal home directory, which will have a path such as `/home/pam2` if your username is pam2.

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.

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

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

If you have set up &konqueror; to show the Sidebar as described in a previous section, then:

1. Make sure the two views are not linked (the small boxes at the bottom right of each view should be empty, &LMB; click on one of them if they not empty).

2. Navigate through the Sidebar View so that you can see the directory you want to copy or move into.

3. Set the main view to show the item you wish to copy or move. Position the mouse pointer over its name or icon then, holding the &LMB; pressed, drag it over to the Sidebar view and position the mouse pointer over the target directory. Release the button and you will be presented with a menu choice of Copy or Move.

You can also set up &konqueror; to show more than one directory 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.

With this arrangement it is easy to drag and drop between the directories, but 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.

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.

You can also drag and drop between different instances of &konqueror;.

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

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 Mode). 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

When you start &konqueror as a browser for the first time it should display an introduction to &konqueror's main features. If you forgot to add this introduction to your Bookmarks you can always view it by entering `about:konqueror` in the Locationbar.

### Connecting to the Internet

Browsing www.konqueror.org

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 dialler 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 View 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 pages such as this document, 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 Ctrl 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 Ctrl 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 the Menubar Location Save As... item or Ctrl S. If the page you are viewing uses frames, then you will also be given the Location Save Frame As... option.

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, with Ctrl P 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.

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 &LMB; click to visit the selected location.

To add a new item to the list use the Menubar Bookmarks Add Bookmark item 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, or even other folders.

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

- Items in you Bookmark Toolbar will usually appear in a 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 that 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 File Insert separator option or Ctrl I.

- Create new folders and sub folders using the Create New Folder option in the File 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.

- Change a bookmark's URL by left clicking twice on the URL.

- 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 Settings menu.

- Convert to or from &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 Settings 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 and 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 Image Preview 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 &RMB; 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.

## 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 &RMB; click on the Toolbar or the Bookmark 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, &RMB; 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 which lets you change the icons in

- The Main Toolbar <Konqueror>.

- The locationToolBar <Konqueror>. There's not really much point in changing this.

- The Main Toolbar <khtmlpart>. This normally contains the Increase and Decrease Font Sizes and Security icons that are only displayed when &konqueror is in Browser mode.

Note that you can rearrange the position of buttons in a Toolbar by clicking on the up and down arrow buttons.

### File Manager

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; Appearance, Trash, Behaviour and Other.

#### Behaviour

Here you can choose whether Konqueror will open up a new window when you open a directory, or show that directory's contents in the current view.

The Home URL used to let you choose the Home URL, which is where &konqueror; jumps to when you press the Home button (this is usually your home directory `~`), but this selection is overridden by the current profile setting.

#### Appearance

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

#### Trash

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

#### Other

This page lets you choose the terminal application (such as &konsole; or xterm) used when you open a terminal window with Open Terminal or Ctrl T.

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

Right click on a text file and select the Edit File Type item. This will bring up a dialog box.

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

1. Open the Settings Configure Konqueror... File Associations dialog box.

2. Click on the Add... button at the lower left, this will bring up a little dialog box..

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

4. 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. It means that every file with the `.tga` or `.TGA` (case is important) extension will now be considered as a Targa image.

5. &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

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

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

8. 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. You should choose an application for quick viewing as the default application.

All Targa files will now be recognized.

### Konqueror Browser

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

This tab page lets you decide whether &konqueror;'s cursor should change from a pointer to a hand when it is over a link in the page (advisable as otherwise you may miss links which are shown as images rather than text), and whether text links should be shown underlined.

It also lets you decide whether images are to be loaded or, for faster browsing, only when you wish.

#### 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 Miscellaneous JavaScript Settings area of the dialog box, the Disable "window.open()" option may be useful if you regularly visit web sites that make annoying use of this command to pop up advertisement banners, but be aware that certain sites require the window.open() function for proper operation. The Show debugger window option displays information and warnings from the JavaScript interpreter in a separate window.

#### Plugins

This tab page lets you globally enable or disable the excution of plugins. 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.

### Cookies

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 Proxies dialog box is invoked with the Menubar Settings Configure Konqueror... Proxies option, or with the K menu Preferences Web Browsing Proxies 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.

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

2. 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 choose which SSL options are to be used when browsing secure (https) sites. 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 servers or domains.

Some example (and possibly useful) User Agent strings can be seen in the Login as drop down box.

### &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.

#### Scan

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

#### Plugins

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

## Command Reference

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

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.

Ctrl P 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 &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.

Del Edit Move to Trash

  Move selected item(s) to the Trash directory.

Shift Del Edit Delete

  Delete the selected item(s).

Ctrl Shift Del Edit Shred

  Shred the selected item(s).

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.

Ctrl* 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 SideBar Configuration

  Opens the directory holding details of your SideBar in a separate window.

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.

Bookmarks Netscape Bookmarks

  To see and use your &Netscape; bookmarks.

Bookmarks Bookmark Toolbar

  To see, edit and use your Bookmark Toolbar entries.

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

#### The Settings Menu

See also the section Saving Settings and Profiles.

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 Key Bindings...

  Lets you see and change &konqueror;'s key bindings, i.e. the associations between actions such as Copy and keys or combinations of keys such as Ctrl V.

Settings Configure Toolbars...

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

Settings Configure...

  Lets you configure the File manager, File Associations, Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, Key Bindings 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.

Window New View On Right

  Add a new view at the right of &konqueror;'s window.

Window New View At Bottom

  Add a new view at the bottom of &konqueror;'s window.

Ctrl Shift R Window Remove Active View

  Remove Active View.

Window Show Sidebar

  Show the Sidebar.

Window Show Terminal Emulator

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

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 View Profile.

Ctrl Shift F Window Fullscreen Mode

  Fullscreen Mode.

#### The Help Menu

F1 Help Contents

  Contents

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 Bubble Help and What's This ? .

Help Report Bug...

  Report bug.

Help About konqueror...

  About &konqueror;

Help About KDE...

  Shows you &konqueror;'s version number, authors and the License agreement.

## 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` (or `~/.kde2`) directories. 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/apps/kio_http/cache/` contains the browser cache.

- The Sidebar View uses the files and subdirectories in `~/.kde/share/apps/konqueror/dirtree`

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

How do I clear out the history file (it's getting rather large)?

The only way at the moment is to delete the `~/.kde/share/config/konq_history` file, &konqueror will create a new, empty, one next time you use it. But note that you can't use &konqueror; to delete this file; you have to open a text terminal and do ``rm` `~/.kde/share/config/konq_history``

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

For some reason this is done using the Proxies dialog box, choose Settings Configure Konqueror...Proxies

&konqueror; can't run the &Netscape; Flash player plugin.

This is a problem with the Flash plugin itself. It won't start up until it can grab the audio device, in &kde; artsd holds onto this.

## Credits and License

&konqueror;. Program copyright 1999-2001, 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)

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)

Harri Porten porten@kde.org

  developer (JavaScript)

Stefan Schimanski 1Stein@gmx.de

  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

Documentation copyright 2000, 2001

- Erwan Loisant erwan@loisant.org

- Pamela Roberts pam.roberts@btinternet.com

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