diff options
Diffstat (limited to 'doc/konqueror')
24 files changed, 4204 insertions, 0 deletions
diff --git a/doc/konqueror/CMakeLists.txt b/doc/konqueror/CMakeLists.txt new file mode 100644 index 000000000..f0fff7db1 --- /dev/null +++ b/doc/konqueror/CMakeLists.txt @@ -0,0 +1,12 @@ +################################################# +# +# (C) 2010-2011 Serghei Amelian +# serghei (DOT) amelian (AT) gmail.com +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_handbook( DESTINATION konqueror ) diff --git a/doc/konqueror/Makefile.am b/doc/konqueror/Makefile.am new file mode 100644 index 000000000..da8216ae4 --- /dev/null +++ b/doc/konqueror/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/doc/konqueror/basics.docbook b/doc/konqueror/basics.docbook new file mode 100644 index 000000000..4212090e9 --- /dev/null +++ b/doc/konqueror/basics.docbook @@ -0,0 +1,383 @@ +<chapter id="basics"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-10-20</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>&konqueror; Basics</title> + +<important><para>Like all &tde; applications, &konqueror; is highly + configurable. This document describes how &konqueror; behaves with the normal, + default settings.</para> +<para> A three button mouse can be useful when you are running +&konqueror; or any other &tde; application. If your mouse only has two buttons +then you should be able to set your system up so that you can simulate a &MMB; +by pressing both buttons at the same time.</para> +<para>You can read more about mouse usage in <xref +linkend="lmb-mmb"/></para> +<para>If you are used to having to double-click to perform an action, +then take care, because in common with the rest of &tde;, &konqueror; defaults +to single-clicking.</para></important> + +<sect1 id="konq-start"> +<title>Starting &konqueror;</title> + +<para>Being a combined File Manager and Browser, +&konqueror; will automatically +switch between the two modes as needed when it is running, but it is convenient +to be able to choose which mode is to be used when you start it up.</para> + +<itemizedlist> +<listitem><para>If you have a <guiicon>house</guiicon> shaped icon on the panel +or desktop, then <mousebutton>left</mousebutton> click on it to open +&konqueror; as a file manager.</para></listitem> + +<listitem><para>Or <mousebutton>left</mousebutton> click on <guiicon>world +</guiicon> shaped icon on the panel or desktop to open &konqueror; in browser +mode.</para></listitem> + +<listitem><para>From the <guimenu>TDE</guimenu> menu, select +<menuchoice><guisubmenu>Internet</guisubmenu><guimenuitem>Konqueror Web +Browser</guimenuitem></menuchoice> to start it as a browser, or +<guimenuitem>Home</guimenuitem> to launch &konqueror; in file manager mode. +</para></listitem> + +<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> +will open a <guilabel>Run Command</guilabel> dialog box, type +<userinput><command>konqueror</command></userinput> (lower case) and press +<keycap>Enter</keycap> or the <guibutton>Run</guibutton> button to start in +file +manager mode, or just enter a &URL; such as + <userinput>http://www.konqueror.org</userinput> to start &konqueror; as a +browser.</para></listitem> + +</itemizedlist> + +<para>&konqueror; is also started automatically when you +<mousebutton>left</mousebutton> click on a desktop icon that represents a +folder, such as a hard disk drive or the <guiicon>Trash</guiicon> icon. +</para> + + +</sect1> + +<sect1 id="parts"> +<title>The Parts of &konqueror;</title> + +<para>A brief look at the main parts of &konqueror;'s window:</para> + +<mediaobject> +<imageobject><imagedata format="PNG" fileref="parts.png"/></imageobject> +<textobject> +<phrase>Here's a screenshot of &konqueror;</phrase> +</textobject> +</mediaobject> + +<para>The <interface>Titlebar</interface> is the strip across the top of +&konqueror;'s window, and operates in the same way as for other &tde; +applications. <mousebutton>Right</mousebutton> click on the central portion to +bring up the neat Titlebar menu.</para> + +<para>The <interface>Menubar</interface> is the strip containing the names of +the drop-down menus. <mousebutton>Left</mousebutton> click on a name to +alternately show and hide that menu, or use <keycombo +action="simul">&Alt;<keycap>the underlined +letter</keycap></keycombo> in the name as a hot key, for example <keycombo +action="simul">&Alt;<keycap>E</keycap></keycombo> to show the +<guimenu>Edit</guimenu> menu. The various menus are described in the <link +linkend="menubar">Menubar</link> section of this document.</para> + +<para>The <interface>Toolbar</interface> contains icons for commonly used +operations. <mousebutton>Left</mousebutton> clicking on an icon will activate +it. If you have enabled tooltips in the Control Center <menuchoice><guimenu> +Appearance & +Themes</guimenu><guisubmenu>Style</guisubmenu></menuchoice> +dialog a brief description of what that icon does will appear when you hover +the pointer over it.</para> + +<para>Some icons, for example the Up and Back icons in the previous screenshot, +have a small black triangle at their bottom right corner. If you hold the &LMB; +pressed while the cursor is over this type of icon a small dropdown menu will +appear.</para> <para><mousebutton>Right</mousebutton> clicking on the +<interface>Toolbar </interface> will bring up the <link +linkend="rmb-menus"><guilabel>Toolbar Menu</guilabel></link> which you can use +to change the <interface>Toolbar</interface>'s appearance and position.</para> + +<para>The <interface>Location Toolbar</interface> shows the path to the +directory, &URL; or file being viewed. You can type a path or &URL; here and +press &Enter; or <mousebutton>left</mousebutton> click on the +<guiicon>Go</guiicon> icon at the right hand end of the <interface>Location +Toolbar</interface> to go to it. The black icon at the left hand end of the +<interface>Location Toolbar</interface> clears the text entry box.</para> + +<para>The <interface>Bookmark Toolbar</interface> is the area under the +<interface>Location Toolbar</interface> in the previous screenshot. You can add +frequently used bookmarks here; see the <link +linkend="orgbmark">Organizing +Your +Bookmarks</link> section of this document.</para> + +<para>The <interface>Window</interface> is the main area of &konqueror; and +can show you the contents of a directory, web page, document or image. +</para> + +<para>The <interface>Status Bar</interface> runs across the bottom of the +&konqueror;'s window +and often shows general information about whatever the mouse pointer is +hovering +over. If you have split the main window into a number of views you will get an +Status Bar for each view, and it will include a small green light at the left +hand end to show which is the <quote>active</quote> +view. <mousebutton>Right</mousebutton> clicking on the Status Bar brings up the +Status Bar <link linkend="rmb-menus"><mousebutton>Right</mousebutton> Mouse +Button Menu</link>.</para> + +<note><para>Don't worry if your &konqueror; doesn't look exactly like this +screenshot; it is highly configurable. In particular:</para> + +<itemizedlist> +<listitem><para>You can use the <link +linkend="menu-settings"><guimenu>Settings</guimenu></link> menu to choose +whether to show or hide the Menubar, Main Toolbar, Location Toolbar and +Bookmark Toolbar, or even to add an Extra Toolbar.</para></listitem> +<listitem><para>You can also <quote>flatten</quote> the toolbars by +<mousebutton>left</mousebutton> 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.</para></listitem> +<listitem><para>This screenshot does not show the optional <link linkend="sidebar"> +Navigation Panel</link>.</para></listitem> +</itemizedlist> + +<para>For more details of how to change &konqueror;'s appearance, see the <link +linkend="config">Configuring &konqueror;</link> section</para></note> + +</sect1> + +<sect1 id="bubble"> +<title>Tooltips and What's This?</title> + +<para>You can find out a lot about how &konqueror; works without needing to +read +this entire document if you take advantage of <guilabel>Tooltips</guilabel> and + the +<guimenuitem>What's This?</guimenuitem> feature.</para> + +<para>If <guilabel>Tooltips</guilabel> have been enabled in &tde; (TDE menu + <menuchoice><guimenu>Control Center</guimenu><guisubmenu>Appearance & + Themes</guisubmenu><guisubmenu>Style</guisubmenu></menuchoice>, + <guilabel>Style</guilabel> dialog) then when you hover the mouse pointer + over a Toolbar or Navigation Panel +button it should bring up a terse description of what that button does.</para> + +<para><guimenuitem>What's This?</guimenuitem> is invoked by the Menubar +<menuchoice><guimenu>Help</guimenu><guimenuitem>What's This?</guimenuitem></menuchoice> item, by +<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>, 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.</para> + +<para>When this question mark is visible, a &LMB; click won't actually do +anything until you have clicked on a control (or the text alongside it) that +supports <guimenuitem>What's This?</guimenuitem>, in which case it will +display +a reasonably comprehensive description of what the control is supposed to do. +Most of the dialog boxes that &konqueror; brings up support the +<guimenuitem>What's This?</guimenuitem> feature.</para> + +</sect1> + +<sect1 id="lmb-mmb"> +<title><mousebutton>Left</mousebutton> and <mousebutton>Middle</mousebutton> +Mouse Button Actions</title> + +<para>If you click the &LMB; on an item in &konqueror;'s window, it will + be +<quote>activated</quote>. Thus</para> + +<itemizedlist> + +<listitem><para><mousebutton>Left</mousebutton> click on an icon in the Toolbar +to do whatever that icon is supposed to do.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on an item in the Menubar +to make that menu drop down.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a menu item to do that +thing.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on an icon in the +Bookmark + Toolbar +to open that &URL;.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a link in a web page +to make &konqueror; follow that link.</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a folder icon or +name and &konqueror; will descend into (show the contents of) that folder. +</para></listitem> +<listitem><para><mousebutton>Left</mousebutton> click on a file name or icon +and &konqueror; will do whatever it thinks appropriate, based on the file type. +In general this means opening <acronym>HTML</acronym> pages, or previewing +text, image or +<application>KOffice</application> files, showing them within &konqueror;'s +window (<quote>Preview</quote> means that you can see the file but not change +it).</para> + +<para>&konqueror; decides what the file type is by matching the filename +extension against a list of known types. If that fails it tries to guess +the type from the file contents. You can change the list of known file types +and associated actions with the <guilabel>File Associations</guilabel> page of +the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... +</guimenuitem></menuchoice> dialog.</para></listitem> + +</itemizedlist> + +<para>Clicking the &MMB; on a file or folder name or icon does essentially the +same as <mousebutton>left</mousebutton> clicking except that it usually does it +in a new &konqueror; window, unless the <guilabel>Open links in new tab instead +of in new window</guilabel> box has been checked in the +<guimenuitem>Behavior</guimenuitem> page of the +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure + +Konqueror...</guimenuitem></menuchoice> dialog. &konqueror; can open +links on pages and <menuchoice><guimenu>Bookmarks</guimenu></menuchoice>, +as well as the +<guibutton>Home</guibutton>, <guibutton>Up</guibutton>, +<guibutton>Back</guibutton> and <guibutton>Forward</guibutton> +entries in a new tab or window.</para> + +<para>Holding the &Shift; key down while pressing the &MMB; will open the link +in the background.</para> +<important><para>If you click the &MMB; when the mouse cursor is over a blank +part of the main view (not over a link or file name or icon) &konqueror; will +copy the contents of the clipboard into the Location Toolbar and try to use +that as a &URL;.</para></important> +</sect1> + +<sect1 id="rmb-menus"> +<title><mousebutton>Right</mousebutton> Mouse Button Menus</title> + +<para>Clicking the &RMB; on almost any part of &konqueror;'s window +will bring up an appropriate context menu.</para> + +<note><para>If you have enabled the <guilabel>Right click goes back in +history</guilabel> option in &konqueror;'s <link linkend="othersettings"> +configuration</link> settings a +simple <mousebutton>right</mousebutton> click is equivalent to clicking on the +<guibutton>Back</guibutton> button. In this case you can access the context +menu by moving the mouse with the <mousebutton>right</mousebutton> button held +down.</para></note> + +<variablelist> + +<varlistentry> +<term>On the Titlebar</term> +<listitem><para><mousebutton>Right</mousebutton> clicking on any free area of +the Titlebar brings up the Titlebar Menu, allowing you to control the position +of &konqueror;'s window as well as the decoration applied to all &tde; program +windows.</para></listitem> +</varlistentry> + +<varlistentry> +<term>On the Main Toolbar</term> +<listitem><para><mousebutton>Right</mousebutton> click on any free area of the +Toolbar to bring up the Toolbar Menu. You can use it to control whether the +Toolbar is at the top, bottom, left or right of &konqueror;'s window. +You can also use the Toolbar Menu to set the size of the buttons on the +Toolbar, +and whether they are shown as icons, text or both.</para></listitem> +</varlistentry> + +<varlistentry> +<term>On the Location Toolbar</term> +<listitem><para><mousebutton>Right</mousebutton> click in the + &URL; +entry box area to perform Cut, Copy, Paste or Clear operations in this area, or +to change the automatic <link linkend="path-complete">Text Completion</link> +features.</para></listitem> +</varlistentry> + +<varlistentry> +<term>On the Bookmark Toolbar</term> +<listitem><para> If you have the Bookmark Toolbar showing, then +<mousebutton>right</mousebutton> 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.</para></listitem> +</varlistentry> + +<varlistentry> +<term>Within a View</term> +<listitem><para>If you <mousebutton>right</mousebutton> click on any free area +of a view then you will get a menu that contains, among other options, the + <guiicon>Up</guiicon>, +<guiicon>Back</guiicon>, <guiicon>Forward</guiicon> and +<guiicon>Reload</guiicon> navigation commands. + </para></listitem> +</varlistentry> + +<varlistentry> +<term>On a File or Folder</term> +<listitem><para>This is a most useful feature. <mousebutton>Right</mousebutton> +clicking on the name or icon of any file or folder not only +<quote>selects</quote> that item but also brings up a menu allowing you to +<guiicon>Cut</guiicon>, Move, <guiicon>Copy</guiicon> or Remove the item in +various +ways, add it to your <guimenu>Bookmarks</guimenu>, open it with the program of +your choice or preview it, rename it, or edit the file type or +properties.</para></listitem> </varlistentry> + +<varlistentry> +<term>On the Status Bar</term> +<listitem><para><mousebutton>Right</mousebutton> click on the Status Bar at the +bottom of a window or view to add or remove a view within &konqueror;'s +window.</para></listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="man-info"> +<title>Viewing Help, Man and Info Pages</title> + +<para>You can view &tde; Help and &UNIX; Man and Info pages directly in +&konqueror;, without having to start up <application>KHelpCenter</application>. +</para> + +<para>To view a &tde; Help page, enter +<userinput>help:/<replaceable>application name</replaceable></userinput> (for +example <userinput>help:/kmail</userinput> to view the &kmail; documentation.) +into &konqueror;'s Location Toolbar window. +</para> + +<para> +If you want to read &UNIX; Man pages &konqueror; makes it easy. For +example type <userinput>man:/touch</userinput> or +<userinput>#touch</userinput> into the Location Toolbar to see the page for +the <command>touch</command> command.</para> + +<para>To browse through &UNIX; Info pages, entering +<userinput>info:/dir</userinput> takes you to Info's top level directory, then +it's just a matter of clicking on the right links to find the page you +want. Alternatively, use <userinput>info:/<replaceable>command +name</replaceable></userinput> to go straight to the Info page you want.</para> + +<note><para>Unfortunately, &tde; Help pages are stored in such a way that they +cannot be viewed in other browsers. If you really need to do this your only +recourse is to go online and visit <ulink url="http://docs.kde.org"> +http://docs.kde.org</ulink>.</para></note> +</sect1> + +</chapter> + +<!-- +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: +--> diff --git a/doc/konqueror/bookmarks.docbook b/doc/konqueror/bookmarks.docbook new file mode 100644 index 000000000..6797f4499 --- /dev/null +++ b/doc/konqueror/bookmarks.docbook @@ -0,0 +1,129 @@ +<chapter id="bookmarks"> +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-05</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>Using Bookmarks</title> + +<para>Although you can use &konqueror;'s bookmarks to record the locations of +your own files and folders, they are most useful when you are surfing the +Web, letting you build up a list of useful sites.</para> + +<para>To open the <guimenu>Bookmarks</guimenu> menu you may either +<mousebutton>left</mousebutton> click on the +<guimenu>Bookmarks</guimenu> menu or use the <keycombo +action="simul">&Alt;<keycap>B</keycap></keycombo> shortcut. Once +the list is visible, you can navigate through it with the arrow keys or with +your mouse, then press &Enter; or +<mousebutton>left</mousebutton> click to visit the selected location.</para> + +<para>To add a new item to the list use <menuchoice><guimenu>Bookmarks +</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice> or +<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> or +<mousebutton>right</mousebutton> click on a clear space in the web page or +folder view and select <guimenuitem>Bookmark this Location</guimenuitem> from +the pop up menu.</para> + +<para>The <guimenu>Bookmarks</guimenu> list can contain subfolders containing +other bookmarks, you can create these with <menuchoice><guimenu>Bookmarks +</guimenu><guimenuitem>New Bookmark Folder...</guimenuitem></menuchoice> . +To add a bookmark into a subfolder rather than into the main Bookmark list, +select the folder from within the <guimenu>Bookmarks</guimenu> list and use +the <guimenuitem>Add Bookmark</guimenuitem> item in that folder.</para> + +<para>You can also access your bookmarks from the <link linkend="sidebar"> +<guilabel>Navigation Panel</guilabel></link>.</para> + +<sect1 id="orgbmark"> +<title>The Bookmark Editor</title> + +<para>The <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit +Bookmarks</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark +Editor</guilabel>.</para> +<para>This shows a tree view of your bookmarks and bookmark subfolders. +As is usual for tree views in &tde;, subfolders are shown with a small square +at the left of the folder name; if the square contains a <keycap>+</keycap> +sign <mousebutton>left</mousebutton> clicking on it will expand the view to +show the contents of that subfolder and the <keycap>+</keycap> sign will +change to <keycap>-</keycap>, <mousebutton>left</mousebutton> clicking on the +<keycap>-</keycap> sign will collapse the subfolder view.</para> + +<para>To select an item in the list you can <mousebutton>left</mousebutton> +click on it, or you can navigate through the list by using the <keysym> +Up arrow</keysym> and <keysym>Down arrow</keysym> keys to move around, +<keysym>Right arrow</keysym> to expand a subfolder and <keysym> +Left arrow</keysym> to collapse it.</para> + +<para>You can move an item to a different place in the list by using the +normal Drag and Drop or <guimenuitem>Cut</guimenuitem> and <guimenuitem> +Paste</guimenuitem> methods. The order in which the items appear in +the <guilabel>Bookmark Editor</guilabel> is the order they will appear in the +<guimenu>Bookmarks</guimenu> drop down list. The <menuchoice><guimenu>Insert +</guimenu><guimenuitem>Insert Separator</guimenuitem></menuchoice> option can +be used to insert separating lines into the list wherever you wish.</para> + +<para>A new subfolder can be created at the selected point in the list by +using the <guimenuitem>Create New Folder...</guimenuitem> option in the +<guimenu>Insert</guimenu> menu or from the drop down menu you get when you +<mousebutton>right</mousebutton> click on an item in the main part of the +window, or with <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> +</para> + +<para>To change the name of a bookmark or folder select it then press +<keycap>F2</keycap> or choose the <guimenuitem>Rename</guimenuitem> item from +the <guimenu>Edit</guimenu> menu or the pop up menu that appears when you +<mousebutton>right</mousebutton> click on the item. Similarly, you can edit +the &URL; by pressing <keycap>F3</keycap> or choosing the <guimenuitem> +Change URL</guimenuitem> menu item.</para> + +<para>The <guilabel>Bookmark Editor</guilabel> lets you import bookmarks from +a range of other browsers into &konqueror;'s bookmark list, putting them into + a new folder or replacing all current bookmarks. To do this select +<guisubmenu>Import</guisubmenu> from the <guimenu>File</guimenu> menu. The +<menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu> +</menuchoice> option can be used to export &konqueror;'s bookmarks to a +&Netscape; or Mozilla browser.</para> + +<para>If you often use the &Netscape; browser as well as &konqueror;, then +rather than importing your &Netscape; bookmarks into &konqueror; it is +better to select the <guimenuitem>Show Netscape Bookmarks in Konqueror +Windows</guimenuitem> item in the <guimenu>Settings</guimenu> menu. If you +do this any updates to &Netscape;'s bookmarks are automatically seen by +&konqueror;.</para> + +<para>To select which bookmark subfolder is used to hold the Bookmark +Toolbar items select the subfolder then choose <guimenuitem>Set as Toolbar +Folder</guimenuitem> from the <guimenu>Edit</guimenu> menu.</para> + +<para>If you are tidying up your bookmarks and have forgotten what a +particular web page is, you can easily open it from within the <guilabel> +Bookmark Editor</guilabel> by <mousebutton>right</mousebutton> clicking +on the item and selecting <guimenuitem>Open in Konqueror</guimenuitem> from +the pop up menu. If you just want to check that the &URL; is still valid +select <guimenuitem>Check Status</guimenuitem> instead.</para> + +<important><para>Don't forget to save your changes with <menuchoice> +<guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> or +<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> before you leave +the <guilabel>Bookmark Editor</guilabel>. +</para></important> +</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: +--> diff --git a/doc/konqueror/browser.docbook b/doc/konqueror/browser.docbook new file mode 100644 index 000000000..c6c8ecbb2 --- /dev/null +++ b/doc/konqueror/browser.docbook @@ -0,0 +1,482 @@ +<chapter id="browser"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-05</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + + +<title>&konqueror; the Web Browser</title> + +<mediaobject> +<imageobject><imagedata format="PNG" fileref="konqorg.png"/></imageobject> +<textobject> +<phrase>Browsing www.konqueror.org</phrase> +</textobject> +</mediaobject> + +<sect1 id="conn-inet"> +<title>Connecting to the Internet</title> + +<para>Once you are connected to the Internet you can use &konqueror; to browse +the Web just as easily as you can use it to handle your local files. Just type +a &URL; into the <guilabel>Location</guilabel> Toolbar window, press +&Enter;, and you are away!</para> + +<itemizedlist> +<listitem><para>If you use a dial-up modem connection, then you will be using +&kppp; or a similar dialer program to make the connection.</para></listitem> + +<listitem><para>If your machine is connected to a local area network +(<acronym>LAN</acronym>) that gives you a proxy connection to the Internet +then you will have to set &konqueror; up for the proxy connection. This can be +done with the <guilabel>Proxy</guilabel> page of the <menuchoice><guimenu> +Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem> +</menuchoice> dialog.</para></listitem> + +<listitem><para>If you are lucky enough to have a high speed cable connection, +then the service provider will probably give you an external cable modem which +needs an ethernet connection to your machine. Unfortunately the details of how +to establish the connection depend on the service provider and to some extent +on which Linux/&UNIX; distribution you are using. Some <acronym>ISP</acronym>s +connect their customers to the Internet through a proxy server, in which case +you will have to set up &konqueror; to use it. You may find it useful to +search the archives of your distribution's user group mailing list for +help.</para> +</listitem> +</itemizedlist> + +<note><para>An error message such as <errorname>Unknown Host</errorname> +usually means that &konqueror; cannot find a connection to the Internet or that +you have entered an incorrect &URL;.</para></note> + +</sect1> + +<sect1 id="surf"> +<title>Surfing and Searching</title> + +<para>Once you have a connection to the Internet, you can surf with +&konqueror; just as you can with any other browser.</para> + +<para>Type a &URL; into the Location Toolbar window, press +&Enter; or <mousebutton>left</mousebutton> click on the +<guibutton>Go</guibutton> button at the right hand end of the Location +Toolbar, and &konqueror; will download and display that page. +If you have visited the page before, &konqueror;'s +<link linkend="path-complete">Automatic Text Completion</link> feature can help +you type the &URL; a second time, or you could look through the +<guilabel>History</guilabel> page in the +<link linkend="sidebar">Navigation Panel</link>. If you want to use one of +the web's search engines, &konqueror;'s <link linkend="enhanced-browsing"> +Web Shortcuts</link> feature can make this easier.</para> + +<para><mousebutton>Left</mousebutton> click on a link in the page to + go there.</para> + +<para>To open a link in a new instance of &konqueror;, leaving the +old page still visible, &MMB; click on the link or <mousebutton> right +</mousebutton> click on it and select the +<guimenuitem>Open in New Window</guimenuitem> option. Alternatively, you might want to <guimenuitem>Open in New Tab</guimenuitem>. <link linkend="tabbrowse">Tabbed Browsing</link> will let +you hold a number of pages in one &konqueror; window and quickly switch +between them with a single mouse click.</para> + +<para>You could also select the multiple view mode with <keycombo +action="simul">&Ctrl;&Shift;<keycap>L</keycap> +</keycombo> +or the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View +Left/Right</guimenuitem></menuchoice> option which will let you see different +pages at the same time. This can be useful if you are looking through a +complicated set of <acronym>HTML</acronym> pages, but make sure the little link +box at the bottom right hand corner is empty when you are doing +this.</para> +<para>To go back to the previous page use the <keycombo +action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo> +shortcut, the <guibutton>Back</guibutton> button on the Toolbar, or the Menubar +<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice> +option.</para> +<para>Similarly, once you have gone back you can go forward by using +<keycombo action="simul">&Alt;<keysym>Right +Arrow</keysym></keycombo>, the <guibutton>Forward</guibutton> button, or the +Menubar +<menuchoice><guimenu>Go</guimenu> +<guimenuitem>Forward</guimenuitem></menuchoice> option.</para> + +<para>If you want to stop the download for any reason then use the +<keycap>Esc</keycap> key, the Toolbar <guibutton>Stop</guibutton> button or the +Menubar <menuchoice><guimenu>View</guimenu> +<guimenuitem>Stop</guimenuitem></menuchoice> item.</para> + +<para>When you are viewing a web page you should see two new icons in the +Toolbar, looking like magnifying glasses with small <keycap>+</keycap> and +<keycap>-</keycap> symbols. Use these to adjust the size of the text in the +page if you find it difficult to read. How well this works will +depend on how the web page has been constructed.</para> +</sect1> + +<sect1 id="tabbrowse"> +<title>Tabbed Browsing</title> +<para>By using this feature you can make &konqueror; load multiple web pages in +the same window, and switch between them using tabbed pages. This way, you can +preload a page <quote>in the background</quote> while you carry on reading another.</para> + +<para>To use tabbed browsing, <mousebutton>right</mousebutton> click on a +link and choose <guimenuitem>Open in New Tab</guimenuitem> from the drop down +menu. The page will be downloaded and displayed as normal, but with tabs +across the top of the view, one tab for each page. <mousebutton>Left +</mousebutton> click on a tab to view that page, or you can use the shortcuts +<keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo> and +<keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo> to cycle through +the tab pages. Alternatively, you can scroll through the tabs using +the mouse <mousebutton>wheel</mousebutton> while the mouse pointer is +over the tab bar (presuming that your mouse has one). Also, +double-clicking over the empty tab bar space will open a new +tab.</para> + +<para>The <guimenuitem>Open in Background Tab</guimenuitem> option in the +&RMB; menu also downloads the page and shows a new tab for it, but the new +page will not be displayed until you <mousebutton>left</mousebutton> click +on the tab.</para> + +<para>If you check the <guilabel>Open links in new tab instead of in new window +</guilabel> box in the <guimenuitem>Web Behavior</guimenuitem> page of the +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... +</guimenuitem></menuchoice> dialog, &MMB; clicking on a link will open it +in a new tab page and if you hold the &Shift; key down while clicking the +&MMB; the link will be opened in a background tab page.</para> + +<para><mousebutton>Right</mousebutton> clicking on a tab will bring up a +menu with the following options:</para> +<variablelist> + +<varlistentry> +<term><guimenuitem>New Tab</guimenuitem></term> +<listitem><para>This opens a new, blank, tabbed page view. +You can then download a web page into it by typing the &URL; into the +Location Bar or by making a selection from the Bookmark Toolbar or the +<link linkend="sidebar">Navigation Panel</link> history page.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Duplicate Tab</guimenuitem></term> +<listitem><para>To create a duplicate tabbed page.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Detach Tab</guimenuitem></term> +<listitem><para>This option removes the selected tabbed +page from the current &konqueror; window and opens it in a new instance of +&konqueror;.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Close Tab</guimenuitem></term> +<listitem><para>To close the selected tab page.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Reload</guimenuitem></term> +<listitem><para>Reloads the content of the current tab.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Reload all Tabs</guimenuitem></term> +<listitem><para>Reloads the content of every tab.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Switch to Tab</guimenuitem></term> +<listitem><para>Displays a submenu showing all other tabs. Choosing a tab from +this list makes it the active tab.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Close Other Tabs</guimenuitem></term> +<listitem><para>To close all but the selected tab page.</para> +</listitem> +</varlistentry> +</variablelist> +</sect1> + +<sect1 id="enhanced-browsing"> +<title>Web Shortcuts</title> + +<para>If enabled, &konqueror;'s Web Shortcuts +feature lets you submit a query directly to a search engine or similar web site +without having to visit the site first.</para> <para>For example, entering +<userinput>gg:konqueror</userinput> into the Location Bar and pressing &Enter; +will ask <trademark>Google</trademark> to search for items related to +&konqueror;.</para> <para>To see what Web Shortcuts are available, and perhaps +add your own, use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +Konqueror...</guimenuitem></menuchoice> to open the <guilabel>Settings +</guilabel> dialog box and click on the <guiicon>Web Shortcuts</guiicon> +icon.</para> + +<para>Once there, to make a new Web Shortcut select +<guibutton>New...</guibutton> and you will now have a new dialog +requesting the options and specifications of your new Web +Shortcut. The first field is for the human readable name of the search +provider; that is, simply the name of the Search provider. For +example, <trademark>Google</trademark>.</para> + +<para>In the next field you should enter the &URI; that is used to do a +search on the search engine. The whole text to be searched for can be +specified as <userinput>\{@}</userinput> or +<userinput>\{0}</userinput>. The recommended version is +<userinput>\{@}</userinput> since it removes all query variables +(<replaceable>name</replaceable>=<replaceable>value</replaceable>) +from the resulting string whereas <userinput>\{0}</userinput> will be +substituted with the unmodified query string.</para> + +<para>You can use <userinput>\{1}</userinput> +... <userinput>\{n}</userinput> to specify certain words from the +query and +<userinput>\{<varname><replaceable>name</replaceable></varname>}</userinput> +to specify a value given by +<userinput><varname><replaceable>name</replaceable></varname>=<replaceable>value</replaceable></userinput> +in the user query. In addition it is possible to specify multiple +references (names, numbers and strings) at once, like +<userinput>(\{<varname><replaceable>name1</replaceable></varname>,<varname><replaceable>name2</replaceable></varname>,...,"<replaceable>string</replaceable>"})</userinput>. The first +matching value (from the left) will be used as substitution value for +the resulting &URI;. A quoted string can be used as the default value if +nothing matches from the left of the reference list.</para> + +<para>To make a basic Web Shortcut here however, all that is required +is the &URI; that is used to do a search on the search +engine. Following our previous example with +<trademark>Google</trademark>, we would enter +<userinput>http://www.google.com/search?q=\{@}&ie=UTF-8&oe=UTF-8</userinput>. You +can often easily find where to place the <userinput>\{@}</userinput> +by doing a search on the search engine in question, and then analysing +the &URL; address. For example, doing a <trademark>Google</trademark> +search for &konqueror; produces the &URL;: <ulink +url="http://www.google.com/search?q=konqueror&ie=UTF-8&oe=UTF-8">http://www.google.com/search?q=konqueror&ie=UTF-8&oe=UTF-8</ulink>. Now +you need to merely replace &konqueror; with +<userinput>\{@}</userinput> in this example to find the appropriate +&URI; to be entered.</para> + +<para>In the third field you need to enter the &URI; shortcut. For +example, the <userinput>gg</userinput> in +<userinput>gg:konqueror</userinput>. In the next option — the +drop-down menu — you have the option to select the character set that +will be used to encode the search query. Once you have entered all the +options correctly to your satisfaction, press &Enter; and your new Web +Shortcut should now be available in &konqueror;.</para> + +</sect1> + +<sect1 id="accesskeys"> + +<title>Access Keys</title> + +<para>&konqueror; has full support for the +<sgmltag class="attribute">accesskey</sgmltag> &HTML; attribute in +forms and links. Access keys allow you to use +the keyboard keys for functions which would perhaps normally be done +with the mouse, such as following links. The benefit of this is, quite +simply, that users can interact with a page with devices other than a +pointing device.</para> + +<para>To activate the access keys in &konqueror;, press and release +&Ctrl;. Once this is pressed, if a particular link on the website has +the <sgmltag class="attribute">accesskey</sgmltag> attribute in the given link, then the +character(s) should appear over the link, identifying what needs to be +pressed. Then, you can enter the character(s) associated with the link +as an alternative to following the link with the mouse. To disable the +access keys once activated you can press &Ctrl; again.</para> + +<note><para>The proper use of this feature requires that the web +designer of the page has specifically assigned, using the +<sgmltag class="attribute">accesskey</sgmltag> attribute, an access key for the +link. Many web designers might not include the +<sgmltag class="attribute">accesskey</sgmltag> in their links and forms, and +consequently this feature will be unusable on the given +webpage.</para></note> + +</sect1> + +<sect1 id="useragent"> +<title>Browser Identification</title> +<para>When &konqueror; connects to a web site it sends some brief browser +identification information, known as the <quote>User Agent</quote> string. +Many web sites use this information to customize the pages that they send +back, based on the strengths and weaknesses of different browsers.</para> +<para>Unfortunately, some badly designed sites refuse to work properly +unless you are using a browser that the site recognizes as a +<quote>valid</quote> one, even though if given a chance, &konqueror; will +work satisfactorily with the vast majority of web pages.</para> +<para>To overcome this problem you can change the browser identification +information that &konqueror; sends for specific sites or domains by +selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem> +Configure Konqueror...</guimenuitem></menuchoice> to bring up the <guilabel> +Settings</guilabel> dialog box and clicking the <guiicon>Browser Identification</guiicon> +icon.</para> +<note><para>Problems with getting a web page to work properly may also be due +to its use of &Java; or JavaScript. If you suspect that this may be the case +check that they have been enabled in the <guiicon>Java & JavaScript +</guiicon> section of the <guilabel>Settings</guilabel> dialog box.</para></note> + +</sect1> + +<sect1 id="save-print-web"> +<title>Saving and Printing Web Items</title> + +<para>When you are viewing a web page you can save it (or at least the basic +&HTML; or similar source text) to your local disk with +<menuchoice><guimenu>Location</guimenu><guimenuitem>Save +As...</guimenuitem></menuchoice>. If the page +you are viewing uses frames, then you will also be given the +<menuchoice><guimenu>Location</guimenu><guimenuitem>Save Frame +As...</guimenuitem></menuchoice> option. <mousebutton>Left</mousebutton> click + in the frame you want to save first.</para> + +<para>If the page uses a background image, you can get and save that with the +<menuchoice><guimenu>Location</guimenu><guimenuitem>Save Background +Image As...</guimenuitem></menuchoice> option.</para> + +<para>But if what you really want is that glorious picture of the latest +Ferrari, then <mousebutton>right</mousebutton> clicking on the image will +give you a drop-down menu with a +<guimenuitem>Save Image As...</guimenuitem> option. Be sure to respect the +owner's copyright, and ask for permission before using any pictures saved this +way for anything other than your own viewing pleasure.</para> + +<para>If you <mousebutton>right</mousebutton> click on a link (which may be a +picture) and select <guimenuitem>Save Link As...</guimenuitem> from the pop +up menu the basic &HTML; or similar source text will be +downloaded and saved on your local disk.</para> + +<para><mousebutton>Right</mousebutton> clicking on a link (which may be a +picture) and choosing <guimenuitem>Copy Link Location</guimenuitem> will copy +the &URL; of the link to the clipboard so you can then paste it into, say, an +e-mail to a friend telling her about this wonderful new site.</para> + +<para><mousebutton>Right</mousebutton> clicking on a picture and choosing +<guimenuitem>Copy Image Location</guimenuitem> copies the &URL; of the picture +to the clipboard.</para> + +<para>To save a complete web page, including images, select <guimenuitem> +Archive Web Page...</guimenuitem> from the <guimenu>Tools</guimenu> menu. +Note that this feature is provided by a <link linkend="konq-plugin">plugin +</link> and may not have been installed on your system. The web page will be +saved as a single file with a <literal role="extension">.war</literal> +extension and can be opened by <mousebutton>left</mousebutton> clicking +on the filename in &konqueror; running in File Manager mode.</para> + +<para>Printing a copy of the page you are viewing is easily done with the +Menubar <menuchoice><guimenu>Location</guimenu> +<guimenuitem>Print...</guimenuitem></menuchoice> or <guimenuitem>Print +Frame</guimenuitem> option or with the Toolbar <guiicon>Print</guiicon> +button.</para> + +</sect1> + +<sect1 id="ftp"> +<title>&FTP;</title> + +<para>&FTP;, or File Transfer Protocol, is one of the the earliest, and still +perhaps the best, way of transferring files between computers over the +Internet.</para> + +<para>With &FTP; you can see files and folders on the distant computer just +as if they were on your own system, download them onto your computer using +&konqueror;'s normal <guimenuitem>Copy</guimenuitem> and +<guimenuitem>Paste</guimenuitem> or Drag n' Drop methods and, if allowed, +upload files from your machine to the other computer's filesystem. To try it, +type the &URL;</para> + +<screen> +<userinput>ftp://ftp.kde.org/pub/kde</userinput> +</screen> + +<para>into the Location Toolbar and press &Enter;. As long as +you are connected to the Internet, and as long as the &tde;'s &FTP; site is +not too busy, you should end up seeing the <filename +class="directory">/pub/kde</filename> folder at &kde-ftp;</para> + +<note><para>Although, strictly speaking, &FTP; &URL;s should +be entered starting with <userinput>ftp://</userinput> and <acronym>WWW +</acronym> &URL;s starting with <userinput>http://</userinput> +&konqueror; is usually smart enough to figure out what is meant, and insert +these characters for you if you leave them out.</para></note> + +<para>When you access an &FTP; site it will usually need some form of username +and password from you. To simplify things, most &FTP; sites that offer files +for free downloading will accept the word <systemitem class="username"> +anonymous</systemitem> as a username and your email +address as a password, and to make your life even easier &konqueror; will +automatically supply these without troubling you.</para> + +<note><para>If you try to access an &FTP; site that does not need a proper +username or password but which is too busy to accept any more connections, +&konqueror; often interprets the <quote>busy</quote> message as a request for +a name and password and will therefore pop up a dialog box asking you to +supply them.</para></note> + +<para>Sites that are more concerned with security will need a proper username +and password, in which case &konqueror; will ask you for them or you can +include the username in the &URL; you type into the Location Toolbar, as +for example</para> + +<screen> +<userinput>ftp://<replaceable>username</replaceable>@ftp.cia.org</userinput> +</screen> + +<para>&konqueror; will then prompt you for the password.</para> + +<para>&konqueror; can also support automatic logins as specified in a +<filename>.netrc</filename> file. Details of how to enable this feature are +given at <ulink url="http://www.konqueror.org/faq.html#netrc"> +http://www.konqueror.org/faq.html#netrc</ulink></para> + +</sect1> + + +<sect1 id="portnumbers"> +<title>&URL;s with Port Numbers</title> +<para>If you specify a port number in your &URL;, as in for example +<userinput>http://intranet.corp.com:1080</userinput>, you might get the error +message <quote>Access to restricted port in POST denied</quote>. This is done +for security reasons. If you nevertheless need to access a server on this port, +just add a key line +<screen><userinput> +OverridenPorts=CommaSeparatedListOfAllowedPorts +</userinput></screen> +to <filename>$TDEDIR/share/config/tdeio_httprc +</filename> or +<filename>~/.trinity/share/config/tdeio_httprc</filename>.</para> +<para>For example +<screen><userinput>OverridenPorts=23,15 +</userinput></screen> +(it should not include any embedded spaces).</para> +<para>&konqueror; will reject the following ports (the list is hardcoded in +<filename>tdelibs/tdeio/tdeio/job.cpp</filename>):</para> +<para> + 1, 7, 9, 11, 13, 15, 17, 19, + 20, 21, 22, 23, 25, 37, 42, 43, + 53, 77, 79, 87, 95, 101, 102, 103, 104, + 109, 110, 111, 113, 115, 117, 119, 123, + 135, 139, 143, 179, 389, 512, 513, 514, + 515, 526, 530, 531, 532, 540, 556, 587, + 601, 989, 990, 992, 993, 995, 1080, + 2049, 4045, 6000, 6667 +</para> +</sect1> + + +</chapter> + +<!-- +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: +--> diff --git a/doc/konqueror/cmndline.png b/doc/konqueror/cmndline.png Binary files differnew file mode 100644 index 000000000..380fead0f --- /dev/null +++ b/doc/konqueror/cmndline.png diff --git a/doc/konqueror/commands.docbook b/doc/konqueror/commands.docbook new file mode 100644 index 000000000..945fd11c4 --- /dev/null +++ b/doc/konqueror/commands.docbook @@ -0,0 +1,985 @@ +<chapter id="commands"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-06</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>Command Reference</title> + +<note><para>The shortcut key combinations shown in this chapter are the +default ones. They can of course be <link linkend="configshort">changed</link>. +</para></note> + +<sect1 id="specshort"> +<title>Special Shortcuts</title> +<para>There are some useful shortcuts that are not shown in any of the menus:</para> +<variablelist> + +<varlistentry> +<term><keycap>F6</keycap></term> +<listitem> +<para>Sets the focus to the text entry box in the Location Toolbar.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo></term> +<listitem> +<para>Activate the next tab page.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo></term> +<listitem> +<para>Activate the previous tab page.</para> +</listitem> +</varlistentry> + +</variablelist> + + +</sect1> + +<sect1 id="menubar"> +<title>The Menubar</title> <para>Note that some menu entries only appear when +they are applicable to the file you currently have open in &konqueror;. For +example, the +<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem> +</menuchoice> +item will not appear when you are viewing the contents of a directory.</para> +<sect2 id="menu-location"> +<title>The <guimenu>Location</guimenu> Menu</title> + +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>New Window</guimenuitem> +</menuchoice></term> +<listitem><para>Open another &konqueror; +window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> <guimenuitem>New Tab</guimenuitem> +</menuchoice></term> +<listitem><para>Open another &konqueror; tab, containing a +blank page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>Duplicate Window</guimenuitem> +</menuchoice></term> +<listitem><para>Open another &konqueror; window, duplicating the +current +one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>Open Location...</guimenuitem> +</menuchoice></term> +<listitem><para>Open a folder or file by entering its path + (for example <filename class="directory">/home/pam</filename> or +<filename>/home/pam/fred.txt</filename>) in a simple dialog +box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Send Link</guimenuitem> +</menuchoice></term> +<listitem><para>Send an email containing a link to the current +location.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Send File</guimenuitem> +</menuchoice></term> +<listitem><para>Send an email containing the selected file as an +attachment.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Save Background Image As...</guimenuitem> +</menuchoice></term> +<listitem> +<para>Only applies if you are viewing a web page with a background image. Opens +the <guilabel>Save As dialog</guilabel> box to let you save the background +image file to your own computer.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>Save As...</guimenuitem> +</menuchoice></term> +<listitem><para>Only applies if you are viewing a document or web page, uses +the +<guilabel>Save As...</guilabel> dialog box to let you save a copy to your own +computer.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Save Frame As...</guimenuitem> +</menuchoice></term> +<listitem><para>Similar to <guimenuitem>Save As...</guimenuitem> but for +use with a web site that uses frames.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>Print...</guimenuitem> +</menuchoice></term> +<listitem><para>Print.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Print Frame</guimenuitem> +</menuchoice></term> +<listitem><para>Print selected frame of a Web +page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Location</guimenu> +<guimenuitem>Open With Netscape/Mozilla</guimenuitem> +</menuchoice></term> +<listitem><para>Open the web page you are +viewing in &konqueror; with &Netscape;/<application>Mozilla</application> as well.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> +</shortcut> +<guimenu>Location</guimenu> +<guimenuitem>Quit</guimenuitem> +</menuchoice></term> +<listitem><para>Close down this instance of +&konqueror;.</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="menu-edit"> +<title>The <guimenu>Edit</guimenu> Menu</title> + +<note><para>Most items in the Menubar <guimenu>Edit</guimenu> menu can also be +found by &RMB; clicking on a free area of a view.</para></note> + +<variablelist> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Undo</guimenuitem> +</menuchoice></term> +<listitem><para>Sometimes lets you reverse a mistaken +action.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Cut</guimenuitem> +</menuchoice></term> +<listitem><para>Puts selected item(s) into the clipboard. If +you then do a a <guimenuitem>Paste</guimenuitem> the item(s) will be moved +from the original location to the new one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Copy</guimenuitem> +</menuchoice></term> +<listitem><para>Copy selected item(s) to the +clipboard.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Paste</guimenuitem> +</menuchoice></term> +<listitem><para>Paste item(s) from clipboard to the currently viewed +folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>F2</keycap> +</shortcut><guimenu>Edit</guimenu> +<guimenuitem>Rename</guimenuitem> +</menuchoice></term> +<listitem><para>Lets you rename a file or folder without + having to +open the <guimenuitem>Properties...</guimenuitem> dialog box. +</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>Delete</keycap></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Move to Trash</guimenuitem> +</menuchoice></term> +<listitem><para>Move selected item(s) to the Trash +folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Delete</guimenuitem> +</menuchoice></term> +<listitem><para>Delete the selected item(s).</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>F7</keycap></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Copy Files</guimenuitem> +</menuchoice></term> +<listitem><para>Copy the selected item(s) to another +folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Move Files</guimenuitem> +</menuchoice></term> +<listitem><para>Move the selected item(s) to another +folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Create New</guimenuitem> +</menuchoice></term> +<listitem><para>Create a link to an application, +<acronym>URL</acronym>, Floppy or &CD-ROM; device, or create a new Folder or +text or &HTML; file. See the <link linkend="making">Create +New...</link>section for more details.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Edit File Type...</guimenuitem> +</menuchoice></term> +<listitem><para>Open the <guilabel>Edit File Type</guilabel> +dialog box</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Properties..</guimenuitem> +</menuchoice></term> +<listitem><para>Open the <guilabel>Edit Properties</guilabel> +dialog box</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu> +</menuchoice></term> +<listitem><para>Contains a number of options for changing the items selected in +the &konqueror; window: +<!-- DANGER: Nested variablelist! Be careful... --> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guisubmenu>Selection</guisubmenu> +<guimenuitem>Select...</guimenuitem> +</menuchoice></term> +<listitem><para>Together with the <guimenuitem>Unselect...</guimenuitem>, +<guimenuitem>Unselect All</guimenuitem> and <guimenuitem>Invert</guimenuitem> +Selection commands, this provides an easy and powerful way of selecting +multiple +files.</para> +<para>It brings up a simple dialog box where you can enter a file +name using the wild card characters * and ?, for example entering +<literal role="extension">*.html</literal> will select all files ending with +<literal role="extension">.html</literal> while <filename>?a*</filename> will +select all files which have the letter a as the second character in their +filename.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guisubmenu>Selection</guisubmenu> +<guimenuitem>Unselect...</guimenuitem> +</menuchoice></term> +<listitem><para>Unselect files or folders via a dialog similar to the one used +by <guimenuitem>Select...</guimenuitem>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guisubmenu>Selection</guisubmenu> +<guimenuitem>Unselect All</guimenuitem> +</menuchoice></term> +<listitem><para>Unselect all selected files or +folders.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo> +</shortcut><guimenu>Edit</guimenu> +<guisubmenu>Selection</guisubmenu> +<guimenuitem>Invert Selection</guimenuitem> +</menuchoice></term> +<listitem><para>Invert current selection.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> +</shortcut><guimenu>Edit</guimenu> +<guisubmenu>Selection</guisubmenu> +<guimenuitem>Select All</guimenuitem> +</menuchoice></term> +<listitem><para>Selects all text in an &HTML; +page or in a text page being previewed, you can then +<guimenuitem>Copy</guimenuitem> it and <guimenuitem>Paste</guimenuitem> it into +a text editor.</para></listitem> </varlistentry> +</variablelist> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> +</shortcut><guimenu>Edit</guimenu> +<guimenuitem>Find...</guimenuitem> +</menuchoice></term> +<listitem><para>Find a text string in a text +page you are previewing or in an &HTML; +page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>F3</keycap></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Find Next</guimenuitem> +</menuchoice></term> +<listitem><para>Find the next occurrence of the text string +in the text or &HTML; page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Go to Line...</guimenuitem> +</menuchoice></term> +<listitem><para>Go to a particular line number in a text +page you are previewing.</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="menu-view"> + +<title>The <guimenu>View</guimenu> Menu</title> + +<variablelist> +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guisubmenu>View Mode...</guisubmenu> +</menuchoice></term> +<listitem><para>Selects <guimenuitem>Icon</guimenuitem>, +<guimenuitem>MultiColumn</guimenuitem>, <guimenuitem>Tree</guimenuitem>, +<guimenuitem>Detailed List</guimenuitem> +or <guimenuitem>Text</guimenuitem> view mode.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Use index.html</guimenuitem> +</menuchoice></term> +<listitem><para>If a selected folder contains a file +<filename>index.html</filename>, it will be opened as a web +page rather than showing the folder as a list of +files.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Lock to current location</guimenuitem> +</menuchoice></term> +<listitem><para>Lock to current location. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Unlock all views</guimenuitem> +</menuchoice></term> +<listitem><para>Unlock all views. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Link View</guimenuitem> +</menuchoice></term> +<listitem><para>Link current view to others in a multiple view +window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>F5</keycap></shortcut> +<guimenu>View</guimenu> +<guimenuitem>Reload</guimenuitem> +</menuchoice></term> +<listitem><para>Reload.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycap>Esc</keycap></shortcut> +<guimenu>View</guimenu> +<guimenuitem>Stop</guimenuitem> +</menuchoice></term> +<listitem><para>Stop load (particularly useful when web +browsing).</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Icon Size</guimenuitem> +</menuchoice></term> +<listitem><para>Select size of icons used when +viewing a folder in Icon Mode.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guisubmenu>Sort</guisubmenu> +</menuchoice></term> +<listitem><para>Choose order in which items are presented in the +window when in Icon or MultiColumn View mode.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Case Insensitive Sort</guimenuitem> +</menuchoice></term> +<listitem><para>Choose whether the sort order in Tree, Detailed List +or Text View modes is case sensitive.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap> +</keycombo> +</shortcut> +<guimenu>View</guimenu> +<guimenuitem>View Document Source</guimenuitem> +</menuchoice></term> +<listitem><para>View document source text.</para> +<para>Only available if you are viewing a document or &HTML; +page.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>View Frame Source</guimenuitem> +</menuchoice></term> +<listitem><para>View frame source text</para> +<para>Only applies if you are viewing a web site that uses frames. Similar to +<guimenuitem>View Document Source</guimenuitem>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap> +</keycombo> +</shortcut> +<guimenu>View</guimenu> +<guimenuitem>View Document Information</guimenuitem> +</menuchoice></term> +<listitem><para>View document information, such as title, &URL;, and &HTTP; +headers used in retrieving the document.</para> +<para>Only available if you are viewing an &HTML; +page.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Security...</guimenuitem> +</menuchoice></term> +<listitem><para>Tells you whether the current browser connection is +secured with <acronym>SSL</acronym> and lets you bring up the +<guilabel>Cryptography Configuration...</guilabel> dialog +box. <mousebutton>Left</mousebutton> clicking on the Menubar padlock icon does +the same thing.</para></listitem> </varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Set Encoding</guimenuitem> +</menuchoice></term> +<listitem><para>Set encoding</para> +<para>Allows you to choose the character encoding used to display +&HTML; pages. <guimenuitem>Auto</guimenuitem> is usually the + best +choice.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guisubmenu>Preview</guisubmenu> +</menuchoice></term> +<listitem><para>Lets you choose to show thumbnails of images, text +files +or &HTML; pages instead of the normal icons in Icon or +MultiColumn View modes.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Show Hidden Files</guimenuitem> +</menuchoice></term> +<listitem><para>Show hidden (dot) files.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Show details...</guimenuitem> +</menuchoice></term> +<listitem><para>Lets you choose which file and folder details are +shown in Tree, Detailed List and Text views.</para></listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Background Color...</guimenuitem> +</menuchoice></term> +<listitem><para>Select background color for the File Manager mode. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Background Image...</guimenuitem> +</menuchoice></term> +<listitem><para>Select background image for the File Manager mode. +</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="menu-bookmarks"> +<title>The <guimenu>Bookmarks</guimenu> Menu</title> + +<note><para>See the section <link linkend="bookmarks">Using Bookmarks</link> +in this manual for a fuller description of these menu items. +</para></note> +<variablelist> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> +</shortcut> +<guimenu>Bookmarks</guimenu> +<guimenuitem>Add Bookmark</guimenuitem> +</menuchoice></term> +<listitem><para>Add current selection to your +bookmarks.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Bookmarks</guimenu> +<guimenuitem>Bookmark Tabs as Folder...</guimenuitem> +</menuchoice></term> +<listitem> +<para>Create a bookmark folder containing links to all of the &URL;s currently +open in &konqueror; tabs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Bookmarks</guimenu> +<guimenuitem>Edit Bookmarks...</guimenuitem> +</menuchoice></term> +<listitem><para>Open the <link linkend="bookmarks">Bookmark Editor</link>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Bookmarks</guimenu> +<guimenuitem>New Bookmark Folder...</guimenuitem> +</menuchoice></term> +<listitem><para>Create a new folder in your Bookmarks +folder.</para></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="menu-tools"> +<title>The <guimenu>Tools</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo></shortcut> +<guimenu>Tools</guimenu> +<guimenuitem>Run Command...</guimenuitem> +</menuchoice></term> +<listitem><para>Run a program by entering its name in a +simple dialog box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut> +<guimenu>Tools</guimenu> +<guimenuitem>Open Terminal</guimenuitem> +</menuchoice></term> +<listitem><para>Open a &konsole; terminal + window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Tools</guimenu> +<guimenuitem>Find File...</guimenuitem> +</menuchoice></term> +<listitem><para>Open the &kfind; application.</para></listitem> +</varlistentry> +</variablelist> + +<para>If you have &konqueror; plugins installed there will be additional +entries in the <guimenu>Tools</guimenu> menu. See the <link +linkend="konq-plugin">&konqueror; Plugins</link> chapter for further +details.</para> +</sect2> + +<sect2 id="menu-settings"> +<title>The <guimenu>Settings</guimenu> Menu</title> + +<note><para>See also the section <link linkend="save-settings">Saving Settings +and Profiles</link>.</para></note> + +<variablelist> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut> +<guimenu>Settings</guimenu> +<guimenuitem>Show Menubar</guimenuitem> +</menuchoice></term> +<listitem><para>Show/Hide the menubar.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Toolbars</guimenuitem> +</menuchoice></term> +<listitem><para>Opens a sub menu where you can choose to show or hide +the various Toolbars.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift; +<keycap>F</keycap></keycombo> +</shortcut> +<guimenu>Settings</guimenu> +<guimenuitem>Full Screen Mode</guimenuitem> +</menuchoice></term> +<listitem> +<para>Changes &konqueror; to full screen mode, in which the &konqueror; window +takes up the whole screen, and does not have the usual window decorations. To +exit full screen mode, click on the <guiicon>Exit Full Screen Mode</guiicon> +icon on the toolbar, or press <keycombo action="simul">&Ctrl;&Shift; +<keycap>F</keycap></keycombo>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>View Properties Saved in Folder</guimenuitem> +</menuchoice></term> +<listitem><para>Save View properties to current + folder. If this is selected, a <filename>.directory</filename> file will be +written in the current directory storing the settings you last used to view the +directory. These settings are then loaded when you open the directory in &konqueror;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Remove Folder Properties</guimenuitem> +</menuchoice></term> +<listitem><para>Remove settings stored in folder by <guimenuitem>View +Properties Saved in Folder</guimenuitem>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guisubmenu>Load View Profile</guisubmenu> +</menuchoice></term> +<listitem><para>Load the settings associated with a particular view profile.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Save View Profile "<replaceable>ProfileName</replaceable>"...</guimenuitem> +</menuchoice></term> +<listitem><para>Save the current settings to the current view profile.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure View Profiles...</guimenuitem> +</menuchoice></term> +<listitem><para>Lets you change an existing view profile or create a +new one.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> <guimenu>Settings</guimenu> +<guimenuitem>Configure Shortcuts...</guimenuitem> +</menuchoice></term> <listitem><para>Lets you +see and change &konqueror;'s shortcut key bindings, i.e. the +associations between actions such as <guimenuitem>Copy</guimenuitem> and keys +or combinations of keys such a <keycombo +action="simul">&Ctrl;<keycap>V</keycap></keycombo>. If you do +this take care not to duplicate an existing shortcut.</para> +</listitem></varlistentry> + +<varlistentry> +<term><menuchoice> <guimenu>Settings</guimenu> +<guimenuitem>Configure Toolbars...</guimenuitem> +</menuchoice></term> <listitem><para> +Lets you configure the Main, Extra and Location Toolbars. See the +section <link linkend="configure-bars">Changing Bars</link>. +</para></listitem> </varlistentry> + +<varlistentry> +<term><menuchoice> <guimenu>Settings</guimenu> +<guimenuitem>Configure &konqueror;...</guimenuitem> </menuchoice></term> +<listitem><para>Lets you configure the File manager, File Associations, +Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or +Toolbars by bringing up the appropriate dialog box.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> <guimenu>Settings</guimenu> +<guimenuitem>Configure Spell Checking...</guimenuitem> </menuchoice></term> +<listitem> +<para>Displays the spell checking configuration dialog box, in which you can +change settings associated with spell checking in &konqueror;.</para> +</listitem> +</varlistentry> + + +</variablelist> + +</sect2> + +<sect2 id="menu-help"> +<title>The <guimenu>Help</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>&konqueror; Handbook</guimenuitem> +</menuchoice></term> +<listitem><para>View this document.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo + action="simul">&Shift;<keycap>F1</keycap></keycombo></shortcut> +<guimenu>Help</guimenu> +<guimenuitem>What's This?</guimenuitem> +</menuchoice></term> +<listitem><para>Draws a question mark (?) beside the mouse +pointer, clicking on a window item such as the +<guiicon>Stop</guiicon> button will then display a brief explanation. See +<link linkend="bubble">Tooltips and What's This?</link> .</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>&konqueror; Introduction</guimenuitem> +</menuchoice></term> +<listitem><para>Revisit the introductory pages that you got when +&konqueror; was first started.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>Report Bug/Request Enhancement...</guimenuitem> +</menuchoice></term> +<listitem><para>Report bug.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>About &konqueror;...</guimenuitem> +</menuchoice></term> +<listitem><para>Display some brief information about +&konqueror;'s version number, authors and license agreement.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>Help</guimenu> +<guimenuitem>About KDE...</guimenuitem> +</menuchoice></term> +<listitem><para>Show some information about the version of &tde; that +you are running.</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> +</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: +--> diff --git a/doc/konqueror/config.docbook b/doc/konqueror/config.docbook new file mode 100644 index 000000000..90a1a5212 --- /dev/null +++ b/doc/konqueror/config.docbook @@ -0,0 +1,137 @@ +<chapter id="config"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-06</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + + +<title>Configuring &konqueror;</title> + +<para>In common with the rest of &tde;, &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 &tde; 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> dialog box. The Main and Extra Toolbars +are divided into sections, such as Main Toolbar <&konqueror;>, Main +Toolbar <tdehtmlpart> and Extra Toolbar <tdehtmlsettingsplugin>. 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 dialog box as shown below. +</para> +<mediaobject> +<imageobject> +<imagedata fileref="shortcut1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Shortcut config screenshot 1</phrase> +</textobject> +</mediaobject> +<para>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>If you select <guilabel>Define Shortcut</guilabel>, and then +select <guilabel>Advanced</guilabel>, the dialog box below will be shown: +</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 dialog 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> dialog 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 dialog box +which you can use to control most aspects of &konqueror;'s behavior. +It contains several sections which are selected by <mousebutton>left +</mousebutton> clicking on one of the icons at the left of the dialog +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: +--> diff --git a/doc/konqueror/credits.docbook b/doc/konqueror/credits.docbook new file mode 100644 index 000000000..02155b3f4 --- /dev/null +++ b/doc/konqueror/credits.docbook @@ -0,0 +1,182 @@ +<chapter id="credits"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-06</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + + +<title>Credits and License</title> + +<para>&konqueror;. Program copyright 1999-2003, the &konqueror; + developers:</para> + +<variablelist> + +<varlistentry> +<term>&David.Faure; &David.Faure.mail;</term> +<listitem><para>developer (parts, I/O lib) and maintainer</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem><para>developer (framework, parts)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Michael.Reiher; &Michael.Reiher.mail;</term> +<listitem><para>developer (framework)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Mattias.Welk; &Mattias.Welk.mail;</term> +<listitem><para>developer</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Alexander.Neundorf; &Alexander.Neundorf.mail;</term> +<listitem><para>developer (list views)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Michael.Brade; &Michael.Brade.mail;</term> +<listitem><para>developer (list views, I/O lib)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Lars.Knoll; &Lars.Knoll.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering +engine)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Antti.Koivisto; &Antti.Koivisto.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering +engine)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Dirk.Mueller; &Dirk.Mueller.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering +engine)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Peter.Kelly; &Peter.Kelly.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine, +JavaScript)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O +lib)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Matt.Koss; &Matt.Koss.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Alex.Zepeda; &Alex.Zepeda.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Stephan.Kulow; &Stephan.Kulow.mail;</term> +<listitem><para>developer (I/O lib)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Richard.J.Moore; &Richard.J.Moore.mail;</term> +<listitem><para>developer (&Java; applet support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>Dima Rogozin <email>[email protected]</email></term> +<listitem><para>developer (&Java; applet support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>Wynn Wilkes <email>[email protected]</email></term> +<listitem><para>developer (&Java;2 manager support and other major improvements +to applet support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Harri.Porten; &Harri.Porten.mail;</term> +<listitem><para>developer (JavaScript)</para></listitem> +</varlistentry> + +<varlistentry> +<term>Stefan Schimanski <email>[email protected]</email></term> +<listitem><para>developer (&Netscape; plugin support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</term> +<listitem><para>developer (framework)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&George.Staikos; &George.Staikos.mail;</term> +<listitem><para>developer (SSL support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>Dawit Alemayehu <email>[email protected]</email></term> +<listitem><para>developer (I/O lib, Authentication support)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Torsten.Rahn; &Torsten.Rahn.mail;</term> +<listitem><para>Graphics / icons</para></listitem> +</varlistentry> + +<varlistentry> +<term>Torben Weis <email>[email protected]</email></term> +<listitem><para>kfm author</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> +<listitem><para>developer (navigation panel framework)</para></listitem> +</varlistentry> + +<varlistentry> +<term>&Stephan.Binner; &Stephan.Binner.mail;</term> +<listitem><para>developer (misc stuff)</para></listitem> +</varlistentry> + +</variablelist> + +<para>Documentation copyright 2000-2003</para> + +<itemizedlist> +<listitem><para>&Erwan.Loisant; &Erwan.Loisant.mail;</para></listitem> +<listitem><para>&Pamela.Roberts; &Pamela.Roberts.mail;</para></listitem> +</itemizedlist> + +<para>Documentation updated for &tde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para> +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; +&underGPL; + +</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: +--> diff --git a/doc/konqueror/dirtree.png b/doc/konqueror/dirtree.png Binary files differnew file mode 100644 index 000000000..fc20b2cc6 --- /dev/null +++ b/doc/konqueror/dirtree.png diff --git a/doc/konqueror/dragdrop.png b/doc/konqueror/dragdrop.png Binary files differnew file mode 100644 index 000000000..8994a5c89 --- /dev/null +++ b/doc/konqueror/dragdrop.png diff --git a/doc/konqueror/faq.docbook b/doc/konqueror/faq.docbook new file mode 100644 index 000000000..0d7ce4ec2 --- /dev/null +++ b/doc/konqueror/faq.docbook @@ -0,0 +1,169 @@ +<chapter id="faq"> +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-06</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>Questions and Answers</title> + +<qandaset> + +<!-- Link is dead, unfortunately. I suppose this is a more general thing anyway +<qandaentry> +<question><para>How can I browse web sites using non latin + scripts?</para></question> +<answer><para>Detailed instructions can be found at <ulink +url="http://www.konqueror.org/i18n.html">http://www.konqueror.org/i18n.html</ulink></para></answer> +</qandaentry> +--> + +<qandaentry> +<question><para>Can I run &konqueror; from another window +manager?</para></question> + +<answer><para>Just install &Qt;, tdelibs and tdebase, and from your favorite +window manager, launch &konqueror;. It should work just fine, but if it +doesn't (&tde; developers don't test that case often), report it to <ulink +url="http://bugs.kde.org">http://bugs.kde.org</ulink> and try running +<application>tdeinit</application> before running &konqueror;; it usually +helps.</para></answer> +</qandaentry> + +<qandaentry> +<question><para>Where does &konqueror; keep all its configuration +data?</para></question> +<answer><para>Generally in the <filename>~/.trinity</filename> folder (this may +be <filename>~/.trinity</filename> on your system, depending on how &tde; 3 +was installed). Don't alter these files unless you really know what you are +doing.</para> + +<itemizedlist> + +<listitem><para>The <filename +class="directory">~/.trinity/share/apps/konqueror/profiles</filename> folder +holds individual files containing settings for each of your <link +linkend="save-settings">profiles. </link></para></listitem> + +<listitem><para>Your bookmarks are held in <filename +class="directory">~/.trinity/share/apps/konqueror/bookmarks.xml</filename></para></listitem> +<listitem><para>Cookies are held in <filename +class="directory">~/.trinity/share/apps/kcookiejar/cookies</filename></para></listitem> +<listitem><para>Your history, as used for the auto-completion feature, is in +<filename>~/.trinity/share/config/konq_history</filename></para></listitem> + +<listitem><para>In the folder <filename +class="directory">~/.trinity/share/config/</filename> the files +<filename>konqiconviewrc</filename>, <filename>konqlistviewrc</filename> and +<filename>konquerorrc</filename> hold a whole lot of general configuration +settings.</para></listitem> + +<listitem><para>The folder +<filename class="directory">~/.trinity/share/cache/http/</filename> +contains the browser cache.</para></listitem> + +<listitem><para>The Navigation Panel uses the files and subfolders in +<filename +class="directory">~/.trinity/share/apps/konqsidebartng</filename></para></listitem> +</itemizedlist> + +<para>Any folder specific view settings are put into <literal +role="extension">.directory</literal> files in the individual +folders.</para></answer> +</qandaentry> + +<qandaentry> +<question><para>How do I clear out the history file?</para></question> +<answer><para>There are two <quote>histories</quote>:</para> +<itemizedlist> +<listitem><para>One is used for text completion in the Location Toolbar text entry +box. To clear this <mousebutton>right</mousebutton> click on the text entry +box and select <guimenuitem>Clear History +</guimenuitem>.</para> +</listitem> +<listitem><para>The other is the log of visited locations. Select the History +page in the Navigation Panel, +<mousebutton>right</mousebutton> click on an entry and choose +<guimenuitem>Remove Entry</guimenuitem> to remove just that entry or +<guimenuitem>Clear History</guimenuitem> to delete all +entries.</para></listitem> + +</itemizedlist> + +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I enable, disable or clear the browser +cache?</para></question> <answer> +<para>If you select <guimenuitem>Cache</guimenuitem> in the dialog launched by +selecting +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror... +</guimenuitem></menuchoice>, you will be presented with a dialog box that lets +you disable the cache, clear it or set its size, and change the caching +policy.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How can I change the timeout values used by &konqueror; +when web browsing?</para></question> <answer> +<para>In the Control Center <menuchoice><guimenu>Internet & Network</guimenu> +<guimenuitem>Preferences</guimenuitem></menuchoice> page.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I set my <quote>home</quote> page - the page loaded +on startup?</para></question> +<answer><para>Start &konqueror; with the <guiicon>Web Browser</guiicon> icon +on the panel. Open the page you want to be loaded in any new <quote>Web +Browser</quote> window and select <guimenuitem>Save View Profile "Web +Browsing"</guimenuitem> from the <guimenu>Settings</guimenu> menu.</para> + +<para>All new &konqueror; windows that are started with the <guiicon>Web +Browser</guiicon> icon on the panel, or from the <guimenu>location</guimenu> +menu, and new empty tabs, will now start at this page.</para> + +<note><para>This does not change the behavior of the +<guiicon>Home</guiicon> button on the &konqueror; toolbar, which will +continue to take you to the &URI; defined in the &konqueror; configuration +module. You can reach that module from within &konqueror;, via +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +Konqueror</guimenuitem><guilabel>Behavior</guilabel></menuchoice>. By +default this is set to <userinput>~</userinput>, which is your Home folder. +You may set this to any &URI;, either local or remote, and pressing the +<guiicon>Home</guiicon> icon on the toolbar will display it.</para></note> + +<para>To have &konqueror; start up with no page loaded, use +<userinput>about:blank</userinput>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>I can't find the answer to my question here.</para></question> +<answer> +<para>Take a look at <ulink url="http://www.konqueror.org/faq.html"> +http://www.konqueror.org/faq.html</ulink> or +<ulink url="http://www.konqueror.org/konq-java.html"> +http://www.konqueror.org/konq-java.html</ulink>.</para> +</answer> +</qandaentry> + +</qandaset> + +</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: +--> diff --git a/doc/konqueror/filemanager.docbook b/doc/konqueror/filemanager.docbook new file mode 100644 index 000000000..a1ef9eb4f --- /dev/null +++ b/doc/konqueror/filemanager.docbook @@ -0,0 +1,898 @@ +<chapter id="filemanager"> +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2005-04-01</date> +<releaseinfo>3.4</releaseinfo> +</chapterinfo> + +<title>&konqueror; the File Manager</title> + +<sect1 id="dirfolders"> +<title>Folders and Paths</title> +<para>In &UNIX; and &Linux; all folders are arranged in a simple +inverted tree structure descending and branching down from from a single top +level folder. This means that you can get from any folder to +any other by going <quote>up</quote> until you reach a common point then +<quote>down</quote> through the appropriate subfolders until you reach +your +target.</para> + +<para>The position of any file or folder in the tree can be described by its +<quote>path</quote>, which is a simple list of the folders you would have +to descend through to get to the target folder or file. For example +<filename class="directory">/home/pam</filename> is the subfolder <filename +class="directory">pam</filename> of the subfolder <filename +class="directory">home</filename> of the top level folder, and <filename> +/home/pam/words.txt</filename> is the file <filename>words.txt</filename> in +that subfolder. The leading <quote>/</quote> in these paths represents the +top level folder.</para> + +<para>Every folder accessible by your system — including those on +other hard disk partitions, your floppy and &CD-ROM; — will appear +in the tree descending +from /, their exact paths will depend on how your system was set up (see +also +the section on <link linkend="floppy-cd">Floppy and &CD-ROM; Drives</link>). +</para> +<para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote> +folder to hold their personal files and settings; for example +<filename class="directory">/home/john</filename> and +<filename class="directory">/home/mary</filename>. The +symbol <keycap>~</keycap> is often used to represent the user's home +folder, so that <filename>~/letter.txt</filename> refers to the file +<filename>letter.txt</filename> in my home folder.</para> +<para>Note that the term <quote>directory</quote> is often used instead of +<quote>folder</quote>.</para> +</sect1> + +<sect1 id="viewmode"> +<title>View Modes</title> +<para>In File Manager mode, &konqueror; shows you what files and +subfolders are held in a folder, and can provide you with some +information about them.</para> +<para>The <quote>path</quote> of the folder you are looking at is shown in +the Titlebar, and also in the Location Toolbar, prefixed with <quote>file: +</quote> to indicate that the folder is part of your computer's normal file +system. For example <filename>file:/home/pam</filename>.</para> + +<para>The way that &konqueror; displays the files and folders depends mainly +on your choice of View Mode. This can be selected from the <menuchoice> +<guimenu>View</guimenu><guisubmenu>View Mode</guisubmenu></menuchoice> +sub menu, which gives you the following options: +</para> + +<variablelist> + +<varlistentry> +<term><guimenuitem>Icon View</guimenuitem></term> +<listitem><para>Displays the name and a suitable icon for each file or folder. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>MultiColumn View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Icon View</guimenuitem> except that the +display is neatly formatted into regular columns.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Detailed List View</guimenuitem></term> +<listitem><para>Displays each file or folder on a separate line, as a small +icon followed by the file or folder name followed by information about the +item. The amount of information shown is controlled by the <menuchoice> +<guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice> +sub menu settings. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Text View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> +except that icons are not shown and the first character in each line will be +<quote>/</quote> if the item is a folder. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Tree View</guimenuitem></term> +<listitem><para>This option is useful for <link linkend="navigation"> +navigating</link> through the folder tree below the current folder. +The display is similar to <guimenuitem>Detailed List View</guimenuitem> +except that the start of each line will show a small <keycap>+</keycap> sign +in a box if the item is a folder. +<mousebutton>Left</mousebutton> clicking on the box will expand the display to +show the contents of that folder.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Info List View</guimenuitem></term> +<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> +except that, where applicable, it shows the number of lines, words and +characters and file format for each file. +</para></listitem> +</varlistentry> +</variablelist> + +<para>The default file icons shown in <guimenuitem>Icon View</guimenuitem> and +<guimenuitem>MultiColumn View</guimenuitem> modes can be replaced by small +preview images of the file contents, see the section <link linkend="previews"> +File Previews</link> of this handbook for more details.</para> + +<sect2 id="filetipinfo"> +<title>File Tip Info</title> +<para>Checking the <guilabel>Show file tips</guilabel> box in the <guilabel> +Behavior</guilabel> page of the &konqueror; Configuration dialog causes a +small pop up information +window to appear when the mouse pointer is hovered over a file or folder name +or icon in <guimenuitem>Icon View</guimenuitem> or <guimenuitem> +MultiColumn View</guimenuitem> mode. +</para> +<para>If the <guilabel>Show previews in file tips</guilabel> checkbox is +checked the pop up window will also show a small image of the file contents. +</para> +</sect2> + +<sect2 id="previews"> +<title>File Previews</title> +<para>Selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Preview +</guisubmenu></menuchoice> from the Menubar will bring up a sub menu +that lets you enable file previews for certain types of file.</para> +<para>Generally this means that the file's icon will be replaced by a small +image showing the file contents.</para> +<para>If file preview is enabled for <guimenuitem>Sound Files</guimenuitem> +the file will be played whenever the mouse cursor is hovering over the file +name or icon.</para> +<para>Note that file previews are only available in <guimenuitem>Icon View +</guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes.</para> +<para>Because &konqueror; has to read much more data than just the file name +details to generate a preview, file previews may not be appropriate +when viewing files on a floppy or from a remote system. The <guilabel>Previews +</guilabel> page of the File Manager Configuration +dialog allows you to disable file previews for protocols such as +<link linkend="ftp">ftp</link> where reading the extra data would take too +long.</para> +</sect2> + +</sect1> + +<sect1 id="navigation"> +<title>Navigation</title> +<para>To get to a file with &konqueror; you first need to navigate +through the folder tree to find the folder containing that +file.</para> + +<para>To move between folders you can simply step up and down the +tree:</para> + +<itemizedlist> +<listitem><para>To descend into a subfolder <mousebutton>left +</mousebutton> click on its name or +icon -- mdash; or if you have already <quote>selected</quote> it (see below) -- mdash; then just press +<keycap>Enter</keycap>.</para></listitem> +<listitem><para>To go up the folder tree you can click on the <guiicon>Up +</guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar +<menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice> +option.</para></listitem> +</itemizedlist> + +<para>To <quote>select</quote> a file or folder in the displayed folder +without opening it in any way use the <keysym>up</keysym> and <keysym>down +</keysym> arrow keys to move through the items. +The selected item will be highlighted and some information about it +will be displayed in the Status Bar.</para> + +<para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem> +Tree View</guimenuitem> can help you locate folders in the tree below the +current folder; in this mode each folder is shown with a small box at +the left. If the box contains a <keycap>+</keycap> sign, <mousebutton>left +</mousebutton> clicking on the box (not on the folder name or icon) will +display a sub tree showing files and subfolders contained in that folder. +The small box will then change to show a <keycap>-</keycap> sign. +<mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once +you have found the folder you are looking for, <mousebutton>left +</mousebutton> click on the folder name or icon to open it.</para> + +<para>The <link linkend="sidebar">Navigation Panel</link> can also help you +find your way around the file system.</para> + +<para>You can go directly to any folder by typing its path into the +Location Toolbar window or into the dialog box invoked by the Menubar +<menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem> +</menuchoice> item or by <keycombo action="simul">&Ctrl;<keycap> +O</keycap></keycombo>. &konqueror;'s <link linkend="path-complete"> +Text Completion</link> feature may be useful when you do this. Don't forget +that in &Linux; / &UNIX; file and folder names are case sensitive.</para> + +<para>When you have moved to a new folder you can go back to your +previous choice by using the Toolbar <guiicon>Back</guiicon> button, the +Menubar +<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice> +item, or <keycombo action="simul">&Alt;<keysym>Left +Arrow</keysym></keycombo>. Once you have gone back you can go forward. Use the Toolbar +<guiicon>Forward</guiicon> button, the Menubar +<menuchoice><guimenu>Go</guimenu> +<guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo +action="simul">&Alt;<keysym>Right +Arrow</keysym></keycombo>.</para> + +<para>Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo +action="simul">&Alt;<keysym>Up +Arrow</keysym></keycombo>.</para> + +<tip><para>Holding the &LMB; pressed while the mouse pointer is +over the Toolbar <guiicon>Up</guiicon>, <guiicon>Back</guiicon> or +<guiicon>Forward</guiicon> buttons brings up a menu of recently visited +locations.</para></tip> + +<sect2 id="file-find"> +<title>Finding Files and Folders</title> + +<para>If you don't know or can't remember where a file or folder is within +your system, then use the Toolbar <guiicon>Find File</guiicon> button or the +Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find +File...</guimenuitem></menuchoice> option. This will embed the file finder +application &kfind; into &konqueror;'s window. See the &kfind; Handbook +for help in using &kfind;. +</para> + +<note><para>If the name of a file or folder begins with a period (dot), then +it is a <quote>hidden</quote> file or folder, and will not normally be shown +by &konqueror;. To see hidden files or folders use the Menubar <menuchoice> +<guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem> +</menuchoice> option.</para> +<para>Another reason &konqueror; may not show the file or folder you are +looking for is that you may have the <link linkend="konq-plugin"><guisubmenu> +View Filter</guisubmenu></link> plugin set to display only certain types of +file.</para></note> + +</sect2> + +<sect2 id="floppy-cd"> +<title>Floppy and &CD-ROM; Drives</title> + +<para>Any floppy disk, &CD; drive or other hard disk partition that you have +on your system will usually appear in the <filename class="directory">/ +</filename>, <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or +<filename class="directory">/auto</filename> folder, having a path something +like <filename class="directory">/mnt/floppy</filename> or +<filename class="directory">/cdrom</filename>. The details will depend on +how your system was set up.</para> + +<para>&UNIX; / &Linux; requires that you <command>mount</command> a floppy disk +or &CD-ROM; when you have inserted it into the drive, and <command>mount +</command> other hard disk partitions when you want to access them. You also +need to unmount a floppy disk or &CD-ROM; before removing it to register that +it is no longer available.</para> + +<para>How you do this will depend on how your system:</para> + +<itemizedlist> +<listitem><para>You may have an <application>Automount</application> 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.</para></listitem> + +<listitem><para>You may have <guiicon>Floppy</guiicon>, &CD-ROM; and hard disk +icons on your desktop, in which case &LMB; click on the icon to mount it. +Doing this should also bring up a &konqueror; window showing the contents of +the floppy, &CD-ROM; or partition. To unmount, <mousebutton>right</mousebutton> +click on the icon and choose the <guimenuitem>Unmount</guimenuitem> item. +Visit the section <link linkend="making">Create New...</link> in this Handbook +to see how to create such an icon.</para></listitem> + +<listitem><para>Or you can do it the traditional way by typing into a text +console window:</para> + +<para><userinput><command>mount /mnt/floppy</command></userinput></para> + +<!-- This markup doesn't work properly, it puts 'mount' and '/mnt/floppy' +on separate lines +<screen> +<userinput><command>mount</command> + <option><replaceable>/mnt/floppy</replaceable></option></userinput> +</screen> --> + +<para>to mount, for example, the floppy drive, and</para> + +<!-- Same as above +<screen> +<userinput><command>umount</command> + <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen> +--> + +<para><userinput><command>umount /mnt/floppy</command></userinput></para> + +<para>to unmount it (<command>umount</command> not <command>unmount</command>). +</para> + +<note><para>Rather than having to open a text console to type the +<command>mount +</command> or <command>umount</command> commands, you may prefer to use +&konqueror;'s <menuchoice><guimenu> Tools</guimenu><guimenuitem>Execute Shell +Command</guimenuitem></menuchoice> +(<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>) + feature. +</para></note> + +</listitem> + +</itemizedlist> +</sect2> + +</sect1> + +<sect1 id="deleting"> +<title>Deleting Files and Folders</title> + +<para>&konqueror; gives you two ways to dispose of an unwanted file or +folder:</para> + +<itemizedlist> +<listitem><para>You can move it to the <filename>Trash</filename> folder, which +is the safest method as you can get it back if you realize that you have made a +mistake.</para></listitem> + +<listitem><para>You can just plain Delete it, which +removes the entry from the folder and adds the disk area occupied by the +file(s) to the system's list of free disk areas, in the same way as the +<command>rm</command> command.</para></listitem> +</itemizedlist> + +<para>The simplest way to remove a file or folder is to position +the mouse pointer over its name or icon and press the &RMB;, which +will bring up a menu containing the options <guimenuitem>Move to +Trash</guimenuitem> and <guimenuitem>Delete</guimenuitem>.</para> + +<para>Or, if you have <quote>selected</quote> the item, the Menubar +<guimenu>Edit</guimenu> menu will give you the choice of +<quote><guimenuitem>Move to Trash</guimenuitem></quote> and +<quote><guimenuitem>Delete</guimenuitem></quote> options.</para> + +<para><keycap>Delete</keycap> will move the selected item or items to Trash.</para> + +<para><keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo> +will really, truly and irrevocably delete the selected item or +items.</para> + +<note><para>You won't be able to remove a file or folder if you don't have +the necessary permissions; see the section on <link linkend="super-user">Super +User Mode</link> for further details.</para></note> + +</sect1> + +<sect1 id="moving"> +<title>Moving and Copying</title> + +<para>To copy a file or subfolder between folders you can:</para> + +<itemizedlist> +<listitem><para>Position the mouse pointer over its name or icon and hold down +the &RMB;, which will bring up a menu containing the +<guimenuitem>Copy</guimenuitem> option. Choose that.</para> + +<para>Or if the item is <quote>selected</quote> you can use the +<guiicon>Copy</guiicon> button on the Toolbar or the Menubar +<menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Copy</guimenuitem></menuchoice> +item, or the <keycombo +action="simul">&Ctrl;<keycap>C</keycap></keycombo> +shortcut key combination. You can also select <link linkend="multiple">multiple</link> files or folders to copy/move as well.</para></listitem> + +<listitem><para>Navigate to the folder you want to copy the item into then +Paste the item into the new folder by using the Toolbar +<guiicon>Paste</guiicon> button or the Menubar +<menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo +action="simul">&Ctrl;<keycap>V</keycap></keycombo> shortcut, or by +moving the mouse pointer to a clear area of the window and holding the &RMB; +down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option. +</para></listitem> +</itemizedlist> + +<para>Moving a file or subfolder between folders can be done in the +same +way as copying, except that you choose the <guimenuitem>Cut</guimenuitem> +option +or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> +instead of <guimenuitem>Copy</guimenuitem>. The item that you have +<guimenuitem>Cut</guimenuitem> will be removed from the original folder when +you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para> + +<para>You can also copy or move selected item(s) to another folder by using +<menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Copy Files</guimenuitem></menuchoice> (<keycap>F7</keycap>) or +<menuchoice><guimenu>Edit</guimenu><guimenuitem>Move Files</guimenuitem> +</menuchoice> (<keycap>F8</keycap>), or by selecting +<guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from +the drop down menu you get when you <mousebutton>right</mousebutton> click on +an file or folder name in the File Manager window.</para> + +<note><para>You may not be able to copy or move a file or folder if +you don't have the necessary permissions. See the section on <link +linkend="super-user">Super User Mode</link> for further +details.</para></note> + +<sect2 id="dnd"> +<title>Using Drag 'n Drop</title> + +<para>&konqueror; also supports Drag and Drop copying and moving of files and +folders.</para> + +<para>You can do this by having two instances of &konqueror;, one showing the +folder you want to copy from, the other showing the target folder. +Position the mouse pointer over the item you wish to copy or move, then, +holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the +target + +folder. Release the button and you will be +presented with a menu choice of <guimenuitem>Copy</guimenuitem> or +<guimenuitem>Move</guimenuitem>. Take care to <quote>drop</quote> the item into + an empty area of the target +folder view - dropping it on top of another file name or icon can cause +problems.</para> + +<para>You can also set up &konqueror; to show more than one folder within +its window and drag & drop between them.</para> + +<mediaobject> +<imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject> +<textobject> +<phrase>Split Views for Drag & Drop</phrase> +</textobject> +</mediaobject> + +<para>This screenshot illustrates the use of the Menubar +<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View +Left/Right</guimenuitem></menuchoice> option, also available with the shortcut +<keycombo +action="simul">&Ctrl;&Shift;<keycap>L</keycap> +</keycombo>, +to split the main &konqueror; window into two views, each showing the contents +of a different folder.</para> + +<para>To be able to show different folders in each view they should not be +linked; the little boxes at the bottom right of each view should be empty. +</para> + +<para>The <quote>active</quote> view, that is the one whose path is shown in +the Location Toolbar and which responds to navigation and Menubar commands, is +shown by the little green light in the bottom left corner. To make a view +active, <mousebutton>left</mousebutton> click on an empty area of the view or +on its Status Bar.</para> + +<para>To remove an active view from &konqueror;'s window use the <keycombo +action="simul">&Ctrl;&Shift;<keycap>R</keycap> +</keycombo> shortcut, or the Menubar <menuchoice><guimenu>Window</guimenu> +<guimenuitem>Remove +Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar +and choose the <guimenuitem>Remove Active View</guimenuitem> option from the +resulting menu.</para> + +<para>If you use &konqueror; tabs, you can drag and drop between tabs +by dragging the file to the tab label, without letting go yet. The +destination tab will pop to the front, allowing you to continue +dragging and then drop the file.</para> + +</sect2> + +<sect2 id="dups"> +<title>Duplicate File Names</title> +<para>If you try to paste a file into a folder that already +contains a file with the same name, &konqueror; will pop up a dialog box warning +you that the file already exists. You can then choose to: +</para> +<itemizedlist> +<listitem><para> +<guilabel>Overwrite</guilabel> the old file with the newly copied one. +The <guibutton>Overwrite All</guibutton> button can be used if you have copied +multiple items.</para></listitem> +<listitem><para>Cancel the paste operation by pressing the <guibutton>Skip +</guibutton> or <guibutton>Skip All</guibutton> button.</para></listitem> +<listitem><para>Give the file that is being copied a different name. You can +do this by typing a new name into the text entry box or get &konqueror; to +<guibutton>Propose</guibutton> one. When you have done this press the +<guibutton>Rename</guibutton> button.</para></listitem> +</itemizedlist> +</sect2> +</sect1> + +<sect1 id="multiple"> +<title>Selecting Multiple Files</title> + +<para>You sometimes want to delete, copy or move a number of files that are +similar in some way. For example you may wish to move all of the .png graphics +files from one folder to another. &konqueror; makes this easy by letting you +select multiple files based on similarities in their file names.</para> + +<para>Use the Menubar +<menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu> +<guimenuitem>Select...</guimenuitem></menuchoice> item or the shortcut +<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>. This +brings up a little dialog box in which you enter a filename containing +the wildcard characters <keycap>*</keycap>, which matches any number +of characters, and <keycap>?</keycap> which matches a single +character. Press <guibutton>OK</guibutton> and &konqueror; will +highlight all files with matching names. For example;</para> + +<itemizedlist> +<listitem><para> <userinput><filename>flag*.png</filename></userinput> will +select all filenames starting with the letters <quote>flag</quote> and ending +with <quote><literal role="extension">.png</literal></quote>.</para></listitem> +<listitem><para><userinput><filename>memo?.txt</filename></userinput> will +select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but +not <filename>memo99.txt</filename>.</para></listitem> +</itemizedlist> + +<para>When you have selected a range of files, you can narrow down the +selection +by uing the Menubar <menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Unselect...</guimenuitem></menuchoice> option or <keycombo +action="simul">&Ctrl;<keycap>-</keycap></keycombo> to specify +which of the selected files should be removed from the selection.</para> + +<para>Use <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> +or the Menubar <menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Unselect All</guimenuitem></menuchoice> option or just +&LMB; click on a clear area of the view to cancel the +selection.</para> + +<para>You can even invert the selection: that is, deselect all selected +files and select those that were previously unselected. Use the +Menubar <menuchoice><guimenu>Edit</guimenu><guimenuitem>Invert +Selection</guimenuitem></menuchoice> option or <keycombo +action="simul">&Ctrl;<keycap>*</keycap></keycombo> to do this.</para> + +<para>You can also select multiple files and folders by holding the <keycap>&Ctrl;</keycap> button while you click on each individual file or folder. This enables you to then move or copy multiple files and folders to a different location at one time by using the same method above.</para> + +<para>A number of useful shortcut keys can be used in list, tree and text +view modes:</para> +<variablelist> + +<varlistentry> +<term><keycap>Space</keycap></term> +<listitem> +<para>Toggle the current selection. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><keycap>Insert</keycap></term> +<listitem> +<para>Toggle the current selection and move down to the next item. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><keycombo action="simul">&Ctrl;<keysym>Up Arrow</keysym></keycombo>, +<keycombo action="simul">&Ctrl;<keysym>Down Arrow</keysym></keycombo>, +<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>, +<keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>, +<keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo>, +<keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo> +</term> +<listitem> +<para>Move the selection, toggling the selection of everything on the way. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>, +<keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo>, +<keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo>, +<keycombo action="simul">&Shift;<keycap>End</keycap></keycombo>, +<keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo>, +<keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo> +</term> +<listitem> +<para>Deselect everything, then move the selection, selecting everything on +the way. +</para> +</listitem> +</varlistentry> +</variablelist> + +<para>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.</para> + +<note><para>Depending on your keyboard type and locale, you may find +that the <keycombo +action="simul">&Ctrl;<keycap>+</keycap></keycombo>, <keycombo +action="simul">&Ctrl;<keycap>-</keycap></keycombo> and <keycombo +action="simul">&Ctrl;<keycap>*</keycap></keycombo> shortcuts +only work with the Numeric keypad <keycap>+</keycap>, <keycap>-</keycap> and +<keycap>*</keycap> keys.</para></note> + +</sect1> + +<sect1 id="making"> +<title>Create New</title> + +<para>When &konqueror; is in File Manager mode, picking +<guisubmenu>Create New</guisubmenu> from the <guimenu>Edit</guimenu> +menu or from the context menu you get by &RMB; clicking on a free +area in a folder view gives you a submenu letting you create any +of the following in the current folder:</para> + +<variablelist> + +<varlistentry> +<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem> + </menuchoice></term> +<listitem><para>This option is most useful if you want to create an icon that +will open a particular application. It opens a dialog box with three tabbed +pages. The first, <guilabel>General</guilabel>, is where you choose an icon and +the text that will appear with it. The second page, +<guilabel>Permissions</guilabel>, lets you select who can use or modify the +icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that +will run the application, for example, <userinput>kedit</userinput> to start up +the &kedit; text editor. <userinput>kedit /home/pam/todo.txt</userinput> would +open the file <filename>/home/pam/todo.txt</filename> in &kedit;. Advanced +options such as the file types which the application can open are also +available from this page.</para> + +<para>To make the application icon appear on your desktop, create the link in +your <filename class="directory">~/Desktop</filename> folder (this may be +called something slightly different depending on how &tde; was installed on +your system) or get to the +<guisubmenu>Create New...</guisubmenu> sub menu by +<mousebutton>right</mousebutton> clicking on a free area of the desktop +instead of within &konqueror;'s window.</para> + +<para>If you have a lot of specialized application links and don't want to +clutter up the desktop, then why not create them in your Applications +folder. You can get there in &konqueror; by choosing +<menuchoice><guimenu>Go</guimenu> +<guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon +on your desktop to open your Applications folder, which is usually in +<filename class="directory">~/.trinity/share/applnk</filename>.</para> + +<para>To put an application link icon into the panel, first create it in the +Applications folder then drag the icon onto a clear area of the +panel.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term> +<listitem><para>This lets you create an icon to open &konqueror; at a +particular +folder or web page. As with <guimenuitem>Link To +Application...</guimenuitem> +you can make the application icon appear on your desktop by creating the link +in +your <filename>~/Desktop</filename> folder or going to the +<guisubmenu>Create +New...</guisubmenu> sub menu by right clicking on a free area of the +desktop. 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 +<guimenuitem>Properties...</guimenuitem> and entering the preferred text in +the +<guilabel>General</guilabel> tab page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></term> +<listitem><para>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 <mousebutton>right</mousebutton> click on +the icon and select <guimenuitem>Unmount</guimenuitem>. 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. However, in most cases you will want to create the icon +on +your desktop.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Hard Disk...</guimenuitem></term> +<listitem><para>This option is similar to <guimenuitem>Floppy +Device...</guimenuitem> but for a hard disk drive or + partition.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>CD/DVD-ROM Device...</guimenuitem></term> +<listitem><para>This option is similar to <guimenuitem>Floppy +Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym> +drive.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Folder...</guimenuitem></term> +<listitem><para>An easy way of creating a new (sub)folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Text File...</guimenuitem></term> +<listitem><para>Use this to create an ordinary, empty, text file. A +dialog box will be opened for you to enter the name of your new +file.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>HTML File...</guimenuitem></term> +<listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When +you +type the new file's name into the dialog box it is probably best to give +it a <literal role="extension">.html </literal> extension to avoid +confusion.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Presentation Document...</guimenuitem></term> +<listitem><para>Creates a skeleton &koffice; +&kpresenter; document. Give its name a <literal role="extension">.kpr</literal> +extension.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Text Document...</guimenuitem></term> +<listitem><para>Creates a skeleton <application>KOffice</application> &kword; +document using the standard &kword; style template. Give its name a <literal +role="extension">.kwd</literal> extension.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Spread Sheet Document...</guimenuitem></term> +<listitem><para>Use this to create a new <application>KOffice</application> +&kspread; spreadsheet file, and name it with a <literal +role="extension">.ksp</literal> extension.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Illustration Document...</guimenuitem></term> +<listitem><para>Creates a new <application>KOffice</application> &karbon14; +document. Name it with the extension <literal +role="extension">.kil</literal>.</para></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="newname"> +<title>Changing Names and Permissions</title> + +<para>The two easiest ways to change the name of a file or folder is to either +<mousebutton>right</mousebutton> click on it and select +<guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> button.</para> + +<para>To change the name or permissions of a file or folder +<mousebutton>right</mousebutton> click on its name or icon and select the +<guimenuitem>Properties...</guimenuitem> item, or if you have +<quote>selected</quote> the file or folder, then you can use the Menubar +<menuchoice><guimenu>Edit</guimenu> +<guimenuitem>Properties</guimenuitem></menuchoice> option.</para> + +<para>This will bring up the Properties dialog box with two tabbed +pages:</para> + +<itemizedlist> +<listitem><para><guilabel>General</guilabel>, which gives you some +information about the item and lets you change its name and, for a folder, +the associated icon.</para></listitem> +<listitem><para><guilabel>Permissions</guilabel>, which shows you the item's +ownership and access permissions and lets you change the permissions. +</para></listitem> +</itemizedlist> + +<sect2 id="copyrename"> +<title>Copy and Rename</title> +<para>If you want to make a copy of an existing file with a different name -- +perhaps as a backup -- mdash; in the same folder as the original file, do a normal +<guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem> +it a dialog box will pop up complaining that the file already exists. +Just type the new name into the dialog's text box and press the +<guibutton>Rename</guibutton> button (or if you are feeling lazy pressing the +<guibutton>Propose</guibutton> button will generate a new name for you).</para> +</sect2> + +<sect2 id="super-user"> +<title>Super User Mode</title> + +<para>If you are running as a normal user and try to access files outside of +your own home folder you will often be prevented from doing so and get an +error message such as <errorname>Access Denied</errorname>.</para> + +<para>To access these files you need to be logged in as the system +administrator, often known as the Super User or <systemitem class="username">root</systemitem>.</para> + +<para>Rather than logging out then in again, you can launch &konqueror; from +the +<guimenu>TDE</guimenu> Menu in Super User mode by selecting +<menuchoice><guisubmenu>System</guisubmenu><guimenuitem>File Manager - Super + User Mode +</guimenuitem></menuchoice>. You will be asked for the <systemitem class="username">root</systemitem> +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.</para> + +<warning><para>Take care. As Super User (<systemitem class="username">root</systemitem>), you have complete control of +your system, and a wrong command can easily do irrevocable damage.</para> +<para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it +seriously increases your vulnerability to malicious hacking.</para></warning> + +</sect2> +</sect1> + +<sect1 id="file-associations"> +<title>Configuring File Associations</title> + +<!-- TODO: The content should probably be here too, but this'll do for --> +<!-- now. --> +<para>&tde; provides many applications which can open many different +types of file. Most of the time, the defaults will work with no +problems, but &konqueror; provides a powerful system to allow you to +change the applications used to open each file type. For more details, +choose the +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +Konqueror...</guimenuitem></menuchoice> menu item, select +<guilabel>File Associations</guilabel> in the configuration dialog, +and click on <guibutton>Help</guibutton>.</para> + +</sect1> + + +<sect1 id="commandline"> +<title>At the Command Line</title> + +<para>Although &konqueror; is a very powerful and flexible +<acronym>GUI</acronym> file manager, there are occasions when the experienced +&Linux; / &UNIX; user wants to get down to the basics and work at the text +command line level.</para> + +<para>You can, of course, open an instance of &konsole;, perhaps with +&konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open +Terminal</guimenuitem></menuchoice> option or with <keycombo +action="simul">&Ctrl;<keycap>T</keycap></keycombo>.</para> +<para>If you only want to launch a program or view a &URL;, the <menuchoice> +<guimenu>Tools</guimenu><guimenuitem>Run Command</guimenuitem></menuchoice> +(<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) option may be +easier.</para> + +<para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command... +</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl; +<keycap>E</keycap></keycombo>) opens a small command line dialog window where +you can enter a shell command such as <userinput>ps -ax | grep tdeinit +</userinput>. Note that it does not support full featured terminal control +characters, so applications such as <userinput>top</userinput> and <userinput> +less</userinput> will not work properly, but it is available immediately +without the delay involved in starting &konsole;. +</para> + +<para>For more complex operations, &konqueror; has another nice feature: the +Menubar <menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal +Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as +a new view within &konqueror;. As long as the link icon is visible at the +bottom right corner of each view, the terminal will follow any folder changes +you make in the normal file manager view.</para> + +<mediaobject> +<imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject> +<textobject> +<phrase>Including the terminal emulator</phrase> +</textobject> +</mediaobject> + +</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: +--> diff --git a/doc/konqueror/index.docbook b/doc/konqueror/index.docbook new file mode 100644 index 000000000..a48974b89 --- /dev/null +++ b/doc/konqueror/index.docbook @@ -0,0 +1,110 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd" [ + <!ENTITY kappname "&konqueror;"> + <!ENTITY package "tdebase"> + <!ENTITY konqueror-introduction SYSTEM "introduction.docbook"> + <!ENTITY konqueror-basics SYSTEM "basics.docbook"> + <!ENTITY konqueror-filemanager SYSTEM "filemanager.docbook"> + <!ENTITY konqueror-browser SYSTEM "browser.docbook"> + <!ENTITY konqueror-path-complete SYSTEM "path-complete.docbook"> + <!ENTITY konqueror-bookmarks SYSTEM "bookmarks.docbook"> + <!ENTITY konqueror-sidebar SYSTEM "sidebar.docbook"> + <!ENTITY konqueror-save-settings SYSTEM "save-settings.docbook"> + <!ENTITY konqueror-plugins SYSTEM "plugins.docbook"> + <!ENTITY konqueror-config SYSTEM "config.docbook"> + <!ENTITY konqueror-commands SYSTEM "commands.docbook"> + <!ENTITY konqueror-faq SYSTEM "faq.docbook"> + <!ENTITY konqueror-credits SYSTEM "credits.docbook"> + <!ENTITY % English "INCLUDE" > <!-- change language only here --> + <!ENTITY % addindex "IGNORE"> +]> + +<book lang="&language;"> + +<bookinfo> +<title>The &konqueror; Handbook</title> + +<authorgroup> +<author>&Pamela.Roberts; &Pamela.Roberts.mail;</author> + +<othercredit role="developer"> +<othername>The KDE Team</othername> +<contrib>Developers</contrib> +</othercredit> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<copyright> +<year>2000</year> <year>2002</year> +<holder>Erwan Loisant</holder> +<holder>Pamela Roberts</holder> +</copyright> + +<legalnotice>&FDLNotice;</legalnotice> + +<date>2002-09-22</date> +<releaseinfo>3.1</releaseinfo> + +<abstract><para>&konqueror; is &tde;'s advanced File Manager, Web Browser and + Universal Viewing Application.</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>Konqueror</keyword> +<keyword>Kdebase</keyword> +<keyword>File Manager</keyword> +<keyword>Browser</keyword> +<keyword>Viewer</keyword> +</keywordset> + +</bookinfo> + + +&konqueror-introduction; +&konqueror-basics; +&konqueror-filemanager; +&konqueror-browser; +&konqueror-path-complete; +&konqueror-bookmarks; +&konqueror-sidebar; +&konqueror-save-settings; +&konqueror-plugins; +&konqueror-config; +&konqueror-commands; +&konqueror-faq; +&konqueror-credits; + + +<appendix id="installation"> +<title>Installation</title> + +<para>&konqueror; is part of the tdebase package which an essential part of +&tde;.</para> + +<para>For instructions on acquiring &tde; please see <ulink +url="http://www.kde.org">http://www.kde.org</ulink>.</para> + +<para>For further information about &konqueror; you might like to visit +<ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink>.</para> + + +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +</appendix> + + +&documentation.index; +</book> + +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +sgml-minimize-attributes: nil +sgml-general-insert-case: lower +End: +--> diff --git a/doc/konqueror/introduction.docbook b/doc/konqueror/introduction.docbook new file mode 100644 index 000000000..fc57dbaa4 --- /dev/null +++ b/doc/konqueror/introduction.docbook @@ -0,0 +1,64 @@ +<chapter id="introduction"> +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-10-20</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>Overview</title> + +<para><emphasis>&konqueror;</emphasis> is an advanced +<link linkend="filemanager">file manager</link> for the +Trinity Desktop Environment, providing file management functions ranging from simple +cut/copy and paste operations to advanced local and remote network file +browsing. Folder contents can be displayed in a variety of text and icon +<link linkend="viewmode">view modes</link>, which can include thumbnail +preview images of file contents. File and folder properties can easily be +examined and changed and applications launched with a simple click of the +&LMB;.</para> + +<para><emphasis>&konqueror;</emphasis> is an <acronym>HTML</acronym> 4.01 +compliant <link linkend="browser">web browser</link> with built in support for +JavaScript (ECMA-262), <acronym>CSS</acronym> (Cascading Style Sheets) and +bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure +running of &Java; applets, &Netscape; plugins for viewing &Flash;, &RealAudio; and &RealVideo; and <acronym>SSL</acronym> for secure +communications. Advanced features include automatic &URL; and form completion, +the ability to import bookmarks from other browsers and tabbed browsing. +</para> + +<para><emphasis>&konqueror;</emphasis> is also an excellent full featured +<link linkend="ftp">FTP</link> client.</para> + +<para><emphasis>&konqueror;</emphasis> is a universal viewing application, +capable of displaying images and documents without having to launch another +application. It does this by embedding components (&tde; Parts) provided by +other applications; from &kview; for image viewing, &kdvi; for +<acronym>DVI</acronym> viewing, &kghostview; for &PostScript; documents and +from the various &koffice; applications for their document types. +</para> + +<para><emphasis>&konqueror;</emphasis> is a fully customizable application +which anyone can <link linkend="config">configure</link> to suit their own +needs, from changing the overall style and the sizes of text and icons to +selecting which items appear in the Menubar, changing the number and +positions of the toolbars and even defining new shortcut key combinations. +Different configuration <link linkend="save-settings">profiles</link> can be +saved for easy recall as needed. +</para> + +</chapter> + +<!-- +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: +--> diff --git a/doc/konqueror/konqorg.png b/doc/konqueror/konqorg.png Binary files differnew file mode 100644 index 000000000..0812aa045 --- /dev/null +++ b/doc/konqueror/konqorg.png diff --git a/doc/konqueror/man-kbookmarkmerger.1.docbook b/doc/konqueror/man-kbookmarkmerger.1.docbook new file mode 100644 index 000000000..dc041c71d --- /dev/null +++ b/doc/konqueror/man-kbookmarkmerger.1.docbook @@ -0,0 +1,112 @@ +<?xml version="1.0" ?> +<!-- vim:set ts=4 noet syntax=xml: --> +<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +<!ENTITY % English "INCLUDE"> +<!ENTITY kbookmarkmerger "<command>kbookmarkmerger</command>"> +]> + +<refentry lang="&language;"> +<refentryinfo> + <title>KDE User's Manual</title> + <author> + &Frerich.Raabe; + &Frerich.Raabe.mail; + </author> + <date>February 1st, 2005</date> + <productname>Trinity Desktop Environment</productname> +</refentryinfo> + +<refmeta> + <refentrytitle>&kbookmarkmerger;</refentrytitle> + <manvolnum>1</manvolnum> +</refmeta> + +<refnamediv> + <refname>&kbookmarkmerger;</refname> + <refpurpose>A program for merging a given set of bookmarks into the + user's list of bookmarks.</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis> + &kbookmarkmerger; + <arg choice="opt" rep="repeat">Qt Options</arg> + <arg choice="opt" rep="repeat">KDE Options</arg> + <arg choice="req">directory</arg> +</cmdsynopsis> +</refsynopsisdiv> + +<refsect1> +<title>Description</title> +<para>&kbookmarkmerger; is a program for merging a given set of bookmarks into +the user's set of bookmarks; if the user doesn't have any bookmarks created +yet, a new bookmark list is created and the given bookmarks are inserted into +it. While doing this, &kbookmarkmerger; keeps track of which files were +merged in a previous run already, so no bookmark will get installed to the +user's bookmarks more than once. In case &tde; is running while +&kbookmarkmerger; is executed, the &tde; bookmark subsystem will be informed +of any changes to the user's bookmarks, so that all applications accessing +that information (&ie; &konqueror;) will pick the changes up instantly.</para> + +<para>The traditionally used approach to achieve something like this was to +use carefully crafted skeleton home directories when creating a new user +account, to provide the user with a standard set of bookmarks. The problem +with this approach is that after the user account has been created, no new +bookmarks can be propagated.</para> + +<para>This mechanism is useful for system administrators who want to propagate +a bookmark pointing to a certain document (for instance, important notes about +the system) to all users. Distributors might find it useful as well, for +instance by augmenting the software packages they supply with bookmark files +which &kbookmarkmerger; merges into the user's bookmark list when the +package is installed. That way, documentation shipped with a software package +is easily and visibly accessible right after the package has been +installed.</para> + +<para>The only parameter required by &kbookmarkmerger; is the name of a +directory which shall be scanned for bookmark files. All files in the given +directory will be considered for being merged into the user's setup. The +files in the given directory should be valid <acronym>XBEL</acronym> +files.</para> +</refsect1> + +<refsect1> +<title>See Also</title> +<para><ulink url="help:/konqueror/index.html">&konqueror; manual</ulink></para> +</refsect1> + +<refsect1> +<title>Examples</title> +<screen>joe@hal9000:~> <command>kbookmarkmerger <filename>/usr/local/extra-bookmarks</filename></command></screen> +<para>Merges all bookmark files stored in +<filename>/usr/local/extra-bookmarks</filename> into joe's list of +bookmarks.</para> +</refsect1> + +<refsect1> +<title>Standards</title> +<variablelist> +<varlistentry><term/><listitem><para> + <ulink url="http://pyxml.sourceforge.net/topics/xbel/"><acronym>XBEL</acronym> specification</ulink> +</para></listitem></varlistentry> +</variablelist> +</refsect1> + +<refsect1> +<title>Restrictions</title> +<para>When determining whether a given bookmark file has been merged into the +user's bookmarks already or not, &kbookmarkmerger; merely looks at the +filename of the bookmark file - the contents are not checked at all. This means +that changing a bookmark file which was already merged into a user's bookmarks +will not trigger merging it once again.</para> + +<para>Also note that in case a user modifies a bookmark which was merged into +his setup, the original bookmark file will be left unmodified.</para> +</refsect1> + +<refsect1> +<title>Author</title> +<para>&Frerich.Raabe; &Frerich.Raabe.mail;</para> +</refsect1> +</refentry> + diff --git a/doc/konqueror/parts.png b/doc/konqueror/parts.png Binary files differnew file mode 100644 index 000000000..1439d0b89 --- /dev/null +++ b/doc/konqueror/parts.png diff --git a/doc/konqueror/path-complete.docbook b/doc/konqueror/path-complete.docbook new file mode 100644 index 000000000..a05f0845c --- /dev/null +++ b/doc/konqueror/path-complete.docbook @@ -0,0 +1,82 @@ +<chapter id="path-complete"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-05</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + + +<title>Automatic Text Completion</title> + +<para>You can get &konqueror; to help you enter a path or &URL; into the +Location Toolbar by enabling one of the <guimenuitem>Text Completion</guimenuitem> +features. To do this <mousebutton>right</mousebutton> + click on a clear part of the Location Toolbar text entry box and select +<guisubmenu>Text Completion</guisubmenu> from the pop up menu. This will let you +choose between the following options:</para> + +<variablelist> + +<varlistentry> +<term><guimenuitem>None</guimenuitem></term> +<listitem><para>What you get is what you type.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Manual</guimenuitem></term> +<listitem><para>When you have typed part of a path or &URL;, pressing +<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> will complete the entry if it is +possible to do so unambiguously.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Automatic</guimenuitem></term> +<listitem><para>As you type into the Location Toolbar window &konqueror; will +automatically extend what you type to complete one possible path or &URL;, +highlighting the characters it has added. Continue typing if that's not what +you wanted or press &Enter; to accept it.</para></listitem> + </varlistentry> + +<varlistentry> +<term><guimenuitem>Dropdown List</guimenuitem></term> +<listitem><para>A drop-down window will appear as you type, showing the +possible matches to what you have typed so far. When the path or &URL; that +you want appears in the window double click on it with the &LMB;. +You can also use the +<keysym>Down Arrow</keysym> and <keysym>Up Arrow</keysym> +keys to select it then press &Enter;.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Short Automatic</guimenuitem></term> +<listitem><para>This is like Automatic mode except that it only extends +what you have typed as far as the next <keycap>/</keycap> symbol in the path +or &URL;. Press <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> to accept the +suggestion, &Enter; when the complete path or &URL; is +shown.</para></listitem> +</varlistentry> + +</variablelist> +<para>You should try out these different modes and pick the one that suits you + best.</para> +<para>The history of recently visited &URL;s that &konqueror; uses for the +Text Completion function can be viewed and edited in the <guilabel>History +</guilabel> page of the <link linkend="sidebar">Navigation Panel</link>.</para> + + +</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: +--> diff --git a/doc/konqueror/plugins.docbook b/doc/konqueror/plugins.docbook new file mode 100644 index 000000000..4cb56795d --- /dev/null +++ b/doc/konqueror/plugins.docbook @@ -0,0 +1,162 @@ +<chapter id="plugins"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2002-09-22</date> +<releaseinfo>3.1</releaseinfo> +</chapterinfo> + + +<title>Plugins</title> + +<sect1 id="netscape-plugin"> +<title>&Netscape; Plugins</title> + +<para>Currently, &konqueror; supports &Netscape; 4.x plugins.</para> + +<para>Selecting <menuchoice><guimenu>Settings</guimenu><guisubmenu> +Configure Konqueror...</guisubmenu><guimenuitem>Plugins</guimenuitem> +</menuchoice> will give you a dialog box with two tabbed pages; +<guilabel>Scan</guilabel> and <guilabel>Plugins</guilabel>.</para> + +<para>The <guilabel>Scan</guilabel> page controls how &tde; scans for new +&Netscape; plugins, either manually by pressing the <guibutton>Scan for New +Plugins</guibutton> button or automatically each time &tde; starts up.</para> + +<para>The scan is done by looking through the folders listed in the +<guilabel>Scan Folders</guilabel> list for <literal +role="extension">.so</literal> files containing plugin code. It examines every +such file to find out which <acronym>MIME</acronym> types the plugin +supports. It then creates <acronym>MIME</acronym> type definitions for &tde; in +the user's <filename class="directory"> ~/.trinity/share/mimelnk</filename> +folder to make other applications aware of them.</para> + +<para>The <guilabel>Plugins</guilabel> page shows you the &Netscape; plugins +that &tde; has found, and for each plugin it lists the <acronym>MIME</acronym> +types and the filename suffixes it uses to recognize them.</para> + +<para>The dialog box also contains a checkbox <guilabel> +Enable plugins globally</guilabel> which you can use to enable or disable +plugins that can be contained in <acronym>HTML</acronym> pages (these can +be considered a security risk).</para> + +</sect1> + +<sect1 id="konq-plugin"> +<title>&konqueror; Plugins</title> + +<para>The package tdeaddons contains several useful plugins that interact with +&konqueror; in various ways. These are explained briefly below, more detailed +information may be obtained by looking through the <guimenuitem>Konqueror +Plugins</guimenuitem> section in the &tde; Help Center.</para> + +<variablelist> + +<varlistentry> +<term>Web Page Translation</term> +<listitem><para>This uses AltaVista's BabelFish site to translate the current +<acronym>HTML</acronym> page to whatever language you want (within reason). It +can be launched with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Translate +Web Page</guisubmenu></menuchoice>.</para></listitem> +</varlistentry> + +<varlistentry> +<term>Folder View Filter</term> +<listitem><para>This is controlled by +<menuchoice><guimenu>Tools</guimenu><guisubmenu>View +Filter</guisubmenu></menuchoice> and allows you to choose which types of item +are displayed in a folder.</para></listitem> +</varlistentry> + +<varlistentry> +<term>DOM Tree Viewer</term> +<listitem><para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show +DOM Tree</guisubmenu></menuchoice> opens a new window which displays the +document object model (DOM) of the current <acronym>HTML</acronym> +page.</para></listitem> +</varlistentry> + +<varlistentry> +<term>HTML Validator</term> +<listitem><para>This is started with +<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web +Page</guisubmenu><guimenuitem>Validate HTML</guimenuitem></menuchoice>. It +uses the W3C HTML validator to validate the current page, very useful when +creating web pages.</para></listitem> +</varlistentry> + +<varlistentry> +<term>CSS Validator</term> +<listitem><para>Started with +<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web +Page</guisubmenu><guimenuitem>Validate CSS</guimenuitem></menuchoice>, it uses +the W3C CSS validator to validate the current page's Cascading Style +Sheets.</para></listitem> +</varlistentry> + +<varlistentry> +<term>HTML Settings</term> +<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>HTML +Settings</guisubmenu></menuchoice> to enable or disable a number of HTML +settings without going through the <guimenu>Settings</guimenu> dialog. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Image Gallery</term> +<listitem><para>In File Manager mode, you can select +<menuchoice><guimenu>Tools</guimenu><guisubmenu>Create Image +Gallery</guisubmenu></menuchoice> to create an HTML page with +thumbnails of all the images in the current folder. By default the HTML page +is called <filename>images.html</filename> and the thumbnails are put into a +new <filename>thumbs</filename> folder. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>User Agent Changer</term> +<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Change +Browser Identification</guisubmenu></menuchoice> to get a menu that allows +you to change the User Agent string without going through the <guimenu>Settings +</guimenu> dialog procedure. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Archive Web Page</term> +<listitem><para>Invoked with <menuchoice><guimenu>Tools</guimenu><guisubmenu> +Archive Web Page</guisubmenu></menuchoice>, this tool creates an archive +(<literal role="extension">.war</literal> ) file containing the web page being +viewed including the images. <mousebutton>Left</mousebutton> click on the +archive file name to view the saved page. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Navigation Panel Media Player</term> +<listitem><para>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. +</para></listitem> +</varlistentry> + +</variablelist> + +</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: +--> diff --git a/doc/konqueror/save-settings.docbook b/doc/konqueror/save-settings.docbook new file mode 100644 index 000000000..2eab552ea --- /dev/null +++ b/doc/konqueror/save-settings.docbook @@ -0,0 +1,92 @@ +<chapter id="save-settings"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-11-06</date> +<releaseinfo>3.2</releaseinfo> +</chapterinfo> + +<title>Saving Settings & Profiles</title> +<sect1 id="save-settings-general"> +<title>General Settings</title> +<para>When you close down &konqueror; your current <guimenu>View</guimenu> +menu settings (such as the <guimenuitem>View Mode</guimenuitem>, +<guimenuitem>Use index.html</guimenuitem> and <guimenuitem>Show Hidden Files +</guimenuitem> items) are not automatically saved as the default +options; however, you can have &konqueror; remember these settings by +selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View +Profile "Web Browsing"...</guimenuitem></menuchoice> and the current +setting will become the default option to be used the next time +&konqueror; is started.</para> + +<para>But you can also specify different <guimenu>View</guimenu> menu settings +for an individual folder. To do this check the <guimenuitem>View Properties +Saved in Folder</guimenuitem> box in the <guimenu>Settings</guimenu> menu, +change the <guimenu>View</guimenu> settings to whatever you want then uncheck +the +<guimenuitem>View Properties saved in Folder</guimenuitem> box. Doing this +creates a <filename>.directory</filename> file in that folder to hold the +folder <guimenu>View</guimenu> settings. Use the <menuchoice><guimenu> +Settings</guimenu><guimenuitem>Remove Folder Properties</guimenuitem> +</menuchoice> option to remove the folder specific +settings (or just delete the <filename>.directory</filename> file).</para> +<note><para>One nice use of this feature is if you have a folder full of +pictures. You can set that particular folder to display thumbnails of the +pictures (by choosing <guimenuitem>Icon View</guimenuitem> and <menuchoice> +<guisubmenu>Preview</guisubmenu><guimenuitem>Show Previews</guimenuitem> +</menuchoice> from the <guimenu>View</guimenu> menu) when you open it, while +not displaying images as thumbnails in other folders.</para></note> +</sect1> + +<sect1 id="save-settings-view-profiles"> +<title>View Profiles</title> +<para>&konqueror; can save a whole set of options as a <quote>View +Profile</quote>. Some view profiles are part of the standard &konqueror; +installation, such as <property>Web Browsing</property> and <property>File +Management</property>, but you can add your own, too.</para> + +<para>To modify a view profile (say, the <property>Web Browsing</property> +profile), load the profile with +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Load View +Profile</guisubmenu><guimenuitem>Web Browsing</guimenuitem> </menuchoice>, and +change the &konqueror; settings to whatever you want. Now select +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View Profile "Web +Browsing"...</guimenuitem></menuchoice>. In the dialog which appears, you can +change the name of the profile, which will create a new profile with that name, +or you can leave the name as it is to modify the current profile. If you select +<guilabel>Save URLs in profile</guilabel>, the current &URL; will be loaded +when you load that view profile. This functions in a similar way to the +<quote>Home Page</quote> in many web browsers. If you want &konqueror; to start +up with an empty window enter <userinput>about:blank</userinput> into the +location bar before saving the profile.</para> + +<note><para>You can create a desktop icon to start &konqueror; with your new +profile. First create a desktop icon by dragging the &konqueror; icon from the +<guimenu>TDE</guimenu> menu onto the desktop and selecting <guimenuitem>Copy +Here</guimenuitem>. Then <mousebutton>right</mousebutton> click on the new +icon, select +<guimenuitem>Properties...</guimenuitem> and change <guilabel>Program +Name</guilabel> in the <guilabel>Execute</guilabel> tab page to +<userinput><command>kfmclient</command> <option>openProfile +<replaceable>MyNewProfile</replaceable></option></userinput>, +<replaceable>MyNewProfile</replaceable> being what you called the new +profile. Then in the <guilabel>General</guilabel> tab page change the name to +something like <filename>MyNewProfile</filename> and pick a more +suitable icon.</para></note> + +</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: +--> diff --git a/doc/konqueror/shortcut1.png b/doc/konqueror/shortcut1.png Binary files differnew file mode 100644 index 000000000..4d7a77c30 --- /dev/null +++ b/doc/konqueror/shortcut1.png diff --git a/doc/konqueror/shortcut2.png b/doc/konqueror/shortcut2.png Binary files differnew file mode 100644 index 000000000..7c461b417 --- /dev/null +++ b/doc/konqueror/shortcut2.png diff --git a/doc/konqueror/sidebar.docbook b/doc/konqueror/sidebar.docbook new file mode 100644 index 000000000..14e82bcd9 --- /dev/null +++ b/doc/konqueror/sidebar.docbook @@ -0,0 +1,201 @@ +<chapter id="sidebar"> + +<chapterinfo> +<authorgroup> +<author>&Pamela.Roberts;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2002-09-22</date> +<releaseinfo>3.1</releaseinfo> +</chapterinfo> + +<title>The Navigation Panel</title> + +<para>The Navigation Panel appears as a separate view at the left of +&konqueror;'s window. It can be invoked with <menuchoice><guimenu>Window +</guimenu><guimenuitem>Show Navigation Panel</guimenuitem></menuchoice> or +toggled on and off with the <keycap>F9</keycap> key.</para> + +<mediaobject> +<imageobject><imagedata format="PNG" fileref="dirtree.png"/></imageobject> +<textobject> +<phrase>With the Navigation Panel</phrase> +</textobject> +</mediaobject> + +<para>It contains a number of tabbed pages; <mousebutton>left</mousebutton> +click on a tab's icon to view that page. <mousebutton>Left</mousebutton> +clicking on the icon for the visible page will collapse the Navigation Panel +so that only the tab icons are visible.</para> +<variablelist> + +<varlistentry> +<term><guilabel>Bookmarks</guilabel></term> +<listitem><para>This page shows a tree view of your Bookmarks. <mousebutton> +Left</mousebutton> click on an item to open it in the main view.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>History</guilabel></term> +<listitem><para>This page shows a tree view of your browsing History. +<mousebutton>Left</mousebutton> clicking on an item will open it in the main +view, or you can open it in a new &konqueror; window by <mousebutton>right +</mousebutton> clicking and selecting <guimenuitem>New Window</guimenuitem> +from the pop up menu.</para> +<para>You can remove an item from the history by <mousebutton>right +</mousebutton> clicking on it and selecting <guimenuitem>Remove Entry +</guimenuitem>. Selecting <guimenuitem>Clear History...</guimenuitem> will +clear out the entire history.</para> +<para>The pop up menu you get when you <mousebutton>right</mousebutton> click +on any entry in the History page also gives you the option of choosing +whether the entire history is sorted by name or by date.</para> +<para>Selecting <guimenuitem>Preferences...</guimenuitem> from this pop up +menu brings up the <guilabel>History Sidebar</guilabel> control module. This +can be used to set the maximum size of your history and set a time after which +items are automatically removed. You can also set different fonts for new and +old &URL;s. +The <guilabel>Detailed tooltips</guilabel> checkbox controls how much +information is displayed when you hover the mouse pointer over an item in the +history page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Home Folder</guilabel></term> +<listitem><para>This page shows a tree view of the subfolders your home +folder. Note that <quote>hidden</quote> folders (those with names +beginning with a dot) are not shown. +<mousebutton>Left</mousebutton> click on an item to open it in the +main view, or <mousebutton>right</mousebutton> click to display a pop up +menu allowing you to open the subfolder in a new window or as a new tab +page of the main view. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Network</guilabel></term> +<listitem><para>This page is intended to show a tree view of your important +network connections, although local folders can also be included. Again, +you can <mousebutton>left</mousebutton> click on an item to open it in the +main view or <mousebutton>right</mousebutton> click to bring up a menu with +a wider range of possibilities.</para> +<para>The folders shown in the <guilabel>Network</guilabel> page are held in +the folder <filename class="directory"> +~/.trinity/share/apps/konqsidebartng/virtual_folders/remote/</filename>, and you can make +new ones just as you would make any other subfolder. The items within +these folders are held as <literal role="extension">.desktop</literal> files +and can be created with &konqueror;'s <menuchoice><guisubmenu>Create New</guisubmenu> +<guimenuitem>Link to Location (URL)...</guimenuitem></menuchoice> option.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Root Folder</guilabel></term> +<listitem><para>The Root Folder tree has the path <filename +class="directory">/</filename>, and is the base folder of your system's +local files. If you expand the <quote>Root</quote> folder you will find +another folder called <filename class="directory">root</filename>. This +belongs to the system administrator or Super User and is her home folder. +You will also find a folder called +<filename class="directory">home</filename>, in which you should be able to +find your own <quote>Home</quote> folder again.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Services</guilabel></term> +<listitem><para>This page provides quick access to the following services: +</para> +<para>The <guilabel>Audio CD Browser</guilabel>.</para> +<para><guilabel>Devices</guilabel>. This shows your hard disc +partitions, floppy and &CD-ROM;. <mousebutton>Left</mousebutton> click on +a device or partition name to mount it and display its contents in the main +view. A mounted device or partition can be unmounted by <mousebutton>right +</mousebutton> clicking on the device name and selecting <guimenuitem>Unmount +</guimenuitem> from the pop up menu. +</para> +<para>The <guilabel>LAN Browser</guilabel> allows you to browse other +machines connected to your Local Area Network.</para> +<para>The <guilabel>Print System Browser</guilabel> tree gives you quick +access to &tde;'s print manager <application>Kprinter</application>.</para> +</listitem> +</varlistentry> +</variablelist> + +<para>The Navigation Panel configuration can be changed by <mousebutton>right +</mousebutton> clicking on the empty area below the bottom tab icon or by +<mousebutton>left</mousebutton> clicking on the <guilabel>Configuration +Button</guilabel> icon (the top icon in the previous screenshot, it may not +be present in your setup). Doing this brings up a menu with the following +options:</para> +<variablelist> + +<varlistentry> +<term><guisubmenu>Add New</guisubmenu></term> +<listitem><para>This option lets you add a new tab page to the Navigation +Panel. The new page can contain the <guimenuitem>Sidebar Media Player +</guimenuitem> (a <link linkend="konq-plugin">&konqueror; Plugin</link> +feature) or a new +<guimenuitem>Folder</guimenuitem> tree view.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Multiple Views</guimenuitem></term> +<listitem><para>Selecting this option splits the Navigation Panel so that +two tab pages can be seen at once.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Show Tabs Left</guimenuitem></term> +<listitem><para>This option lets you choose whether the tab icons are shown at +the left or right of the Navigation Panel.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Show Configuration Button</guimenuitem></term> +<listitem><para>Use this option to show or hide the <guilabel>Configuration +Button</guilabel> icon.</para> +</listitem> +</varlistentry> + +</variablelist> + +<para><mousebutton>Right</mousebutton> clicking on a tab icon brings up a +menu with the following options:</para> + +<variablelist> +<varlistentry> +<term><guimenuitem>Set URL</guimenuitem></term> +<listitem><para>Only available for folder pages, this option lets you +change the &URL; (path) of the folder viewed in that page.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Set Icon</guimenuitem></term> +<listitem><para>To change the tab icon.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Remove</guimenuitem></term> +<listitem><para>To remove the tab page from the Navigation Panel.</para> +</listitem> +</varlistentry> + +</variablelist> + + +</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: +--> |
