# The &rekonq; Handbook

&Andrea.Diamantini; &Andrea.Diamantini.mail;
&Rohan.Garg; &Rohan.Garg.mail;
&Jonathan.Kolberg; &Jonathan.Kolberg.mail;
2008
&Andrea.Diamantini;
2009
2010
&Rohan.Garg;
2010
&Jonathan.Kolberg;
&FDLNotice;
2010-05-07
0.5.0

&rekonq; is a lightweight web browser for &kde; based on QtWebKit.

KDE
browser
rekonq
webkit

## Overview

&rekonq; is a lightweight web browser for &kde; based on QtWebKit. Amongst other it provides the following features:

- Shared bookmarks with &konqueror;

- Shared cookies with &konqueror;

- Handle tabbed browsing

- Display tab previews

- Handle support for NS plugins (eg: flash)

- Share General &kde; Proxy settings

- Browse anonymously

- Inspect web pages

- File and &FTP; protocol handling

- KWallet support for storing passwords

- Ad-Block support

- &kget; Download integration

## Introduction

&rekonq; is a lightweight web browser for &kde; based on WebKit. Its code is based on the Nokia QtDemoBrowser. Its implementation is going to embrace &kde; technologies, in order to have a full-featured &kde; web browser.

## Using &rekonq;

Here's a screenshot of &rekonq; Screenshot

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

A three button mouse can be useful when you are running &rekonq; 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 a middle mouse button 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;, &rekonq; defaults to single-clicking.

### Starting &rekonq;

&rekonq; can be started in the following ways

- From the application launcher select Applications Internet rekonq

- &Alt;F2 will open &krunner;, type rekonq (lower case) and press &Enter; to start &rekonq;

## Configure &rekonq;

### Do the general settings of &rekonq;

You want to configure the general behavior of &rekonq;? You found the right place to get it explained.

To open the general settings go to Toolbutton Configure rekonq

Now you should see this Screenshot

Here a List of configurable points and explanation for it:

When starting rekonq:

  You can configure what &rekonq; should do on startup.

Home page URL:

  You can either set your home page directly through tipping the &URL; in.

Set to Current Page

  Sets your home page to the one you are visiting at the moment.

Default search engine:

  Here you can choose the search engine you like to be searched with as default.

Use KGet for downloading files

  This activates the &kget; download integration. If this is active &rekonq; will download everything through &kget;

List links with KGet

  ?????

### Configure the Tabs settings

Here you learn how to change the settings for tabs.

To come to the dialog open Toolbutton Configure rekonq Tabs

Now this dialog should appear Screenshot

Here a List of configurable points and explanation for it:

Open links in new tab instead of in new window

  This enables the default opening of links in new tabs.

Always show tab bar

  This forces &rekonq; to show the tab bar even if there is only one tab.

Open new tabs in the background

  This makes &rekonq; not switching to new tabs.

Open new tabs after currently active one

  This makes it to default that tabs are opened next to the currently active one.

Show preview when hovering tab

  This shows you an preview of the content of a tab if you hover it. This can be useful if you have many tabs opened.

Activate previously used tab when closing the current one

  This makes &rekonq; storing your last opened tab and if you close your current one it will reopen the old one. This also can be useful if you use many tabs.

### Configure the Fonts settings

Now you should see this Screenshot

Following will explain the configurable things and what they do

Standard font

  Here you can set your default font. The first part is the name of the font followed by the size of the font.

Fixed font

  Here you can set your font for &rekonq; labels. The same synopsis like Standard font.

Font size

  To configure your preferred size of font.

Minimal font size:

  You can configure the minimal size of fonts in &rekonq;. Every smaller font will grow to that size.

### Configure the WebKit settings

Now you should see this Screenshot

### Network configuration

#### Handling of Cookies with &rekonq;

This is a screenshot of the cookie settings dialog Screenshot

As you can see the Cookies can be configured in many ways.

&rekonq; can handle Cookies in three ways

- "Ask for Confirmation"

#### Rest

Now you should see this Screenshot

Now you should see this Screenshot

### Configure the Adblock settings

Now you should see this Screenshot

Now you should see this Screenshot

### Configure the Shortcut settings

Now you should see this Screenshot

### Configure the Web Shortcuts settings

Now you should see this Screenshot

## Credits and License

&rekonq;

Program copyright: &underGPL;

### Developers

- &The.rekonq.Team; &The.rekonq.Team.mail; Find more about us in the 'About &rekonq;' section

Documentation copyright 2008 &Andrea.Diamantini; &Andrea.Diamantini.mail;

Documentation copyright 2009-2010 &Rohan.Garg; &Rohan.Garg.mail;

Documentation copyright 2010 &Jonathan.Kolberg; &Jonathan.Kolberg.mail;

&underFDL; &underGPL;

## Installation

### How to obtain &rekonq;

Stable Packages of &rekonq; can be downloaded via standard repositories of your distribution

You also can compile &rekonq; yourself see Compilation and Installation for that.

### Requirements

In order to successfully use &rekonq;, you need at least &Qt; 4.6.x and &kde; 4.4.x.

### Compilation and Installation

If you wish to compile &rekonq;, you have to install the headers of kdelibs and you need git and the build essentials installed.

Under Debian/Ubuntu you get those through running

``sudo` `apt-get` `install` `build-essential kdelibs5-dev git-core``

Under OpenSuse you get those through running

``sudo` `zypper` `in` `libkde4-devel git-core gcc gcc-c++ make cmake``

We will be using git, as the most recent code is available on the git repository. The gitorious page for rekonq can be found here. Stable releases, can also be downloaded here in form of tarballs.

Now we need to checkout the latest code. To do so, in a terminal run:

``git` `clone` `git://gitorious.org/rekonq/mainline.git``

To compile the code tip in the following

``cd` `directory_where_rekonq_source_code_is``

``mkdir` `build``

``cd` `build``

``cmake` `-DCMAKE_INSTALL_PREFIX=``kde4-config` `--prefix``` `..``

``make``

``sudo` `make` `install``

&documentation.index;