<chapter id="config">

<chapterinfo>
<authorgroup>
<author
>&Pamela.Roberts;</author>
<othercredit role="translator"
><firstname
>John</firstname
><surname
>Knight</surname
><affiliation
><address
><email
>anarchist_tomato@herzeleid.net</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</authorgroup>
<date
>2003-11-06</date
> <releaseinfo
>3.2</releaseinfo
> </chapterinfo>


<title
>Configuring &konqueror;</title>

<para
>In common with the rest of &kde;, &konqueror; is highly configurable, so you can really get the look and feel that best fits your needs and wishes.</para>

<sect1 id="configure-bars">
<title
>Toolbars</title>

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

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

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

<!-- FIXME -->
<para
>On the left hand end of each bar you can see some vertical lines. By &LMB; clicking on them, you <quote
>flatten</quote
> 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.</para>

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

<para
>The icons shown in the various bars can be changed by using the <menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure Toolbars...</guimenuitem
></menuchoice
> option, which brings up the <guilabel
>Configure Toolbars</guilabel
> dialogue box. The Main and Extra Toolbars are divided into sections, such as Main Toolbar &lt;&konqueror;&gt;, Main Toolbar &lt;khtmlpart&gt; and Extra Toolbar &lt;khtmlsettingsplugin&gt;. 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.</para>

</sect1>

<sect1 id="configshort">
<title
>Shortcuts</title>
<para
>To change the shortcut key arrangements used by &konqueror; select <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts... </guimenuitem
></menuchoice
>. This will launch a dialogue box as shown below. </para>
<mediaobject>
<imageobject>
<imagedata fileref="shortcut1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Shortcut config screenshot 1</phrase>
</textobject>
</mediaobject>
<para
>Search through the combo box to find the action you want to add or change the shortcut keys for and select it by <mousebutton
>left</mousebutton
> clicking on the name. You will then be able to change the shortcut by selecting the <guilabel
>None</guilabel
>, <guilabel
>Default</guilabel
> or <guilabel
>Custom</guilabel
> radio button or by clicking on the large button in the <guilabel
>Shortcut for Selected Action</guilabel
> area.</para>
<para
>The <guilabel
>Define Shortcut</guilabel
> dialogue box will then open. </para>
<mediaobject>
<imageobject>
<imagedata fileref="shortcut2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Shortcut config screenshot 2</phrase>
</textobject>
</mediaobject>
<para
>Choose whether you want to change the <guilabel
>Primary</guilabel
> or <guilabel
>Alternate</guilabel
> shortcut then press the key combination you want to act as the shortcut, for example <keycombo action="simul"
> &Ctrl;&Shift;<keycap
>S</keycap
></keycombo
>. If the <guilabel
>Auto-Close</guilabel
> box is checked the dialogue will vanish as soon as you enter the key combination, otherwise it will remain until you press <guibutton
>OK</guibutton
> or <guibutton
>Cancel</guibutton
>. Clicking on the little black icon with a white cross in it clears the shortcut.</para>

<sect2 id="userdefmenus">
<title
>User Defined Menus</title>
<para
>You can add your own pop up menu to &konqueror; so that pressing one key combination will make the menu appear then pressing a second key, or using the <keysym
>Up arrow</keysym
> and <keysym
>Down arrow</keysym
> keys and pressing <keycap
>Enter</keycap
>, will select an item from it.</para>
<para
>To do this add a <guilabel
>Custom</guilabel
> shortcut for each of the actions you want to appear in the menu and in the <guilabel
>Define Shortcut </guilabel
> dialogue check the <guilabel
>Multi-Key</guilabel
> box, press the key combination that you want to bring up your new menu then, separately, press the key that will choose that item from the menu.</para>
</sect2>
</sect1>

<sect1 id="othersettings">
<title
>Other Settings</title>
<para
>Selecting <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
> Configure Konqueror...</guimenuitem
></menuchoice
> brings up a dialogue box which you can use to control most aspects of &konqueror;'s behaviour. It contains several sections which are selected by <mousebutton
>left </mousebutton
> clicking on one of the icons at the left of the dialogue box.</para>
<para
>Pressing the <guibutton
>Help</guibutton
> button will give you detailed instructions about how to use each of these sections, or you can use the <link linkend="bubble"
>What's This?</link
> feature.</para>
</sect1>


</chapter>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-parent-document:("index.docbook" "book" "chapter")
End:
-->