tdebase/doc/userguide/the-filemanager.docbook

<sect1 id="file-manager">

<title>The File Manager</title>
<indexterm><primary>&konqueror;</primary><secondary>File
Management</secondary></indexterm>
<indexterm><primary>File Management</primary></indexterm>

<mediaobject>
<imageobject>
<imagedata fileref="konq-simple.png" format="PNG" />
</imageobject>
<caption><para>&konqueror; with simple settings</para></caption>
</mediaobject>

<sect2 id="filemanager-intro">
<title>Introduction</title>

<para>&tde; includes a versatile and powerful file manager called
&konqueror; that allows you to do everything you want with the files
stored on your computer, your network, and even the Internet. There
are too many features of &konqueror; to describe here, so we will just
take an overview. For more details about what &konqueror; can
do, refer to the <ulink url="help:/konqueror">&konqueror; Handbook</ulink>.</para>
</sect2>

<sect2 id="folder-structure">
<title>Folders</title>

<para>When you first open &konqueror; in file management mode, you can
see two panes: on the right is the folder view; on the left is the
sidebar. The folder view contains icons for
each item inside the current folder. These items can be
folders or files. Many file types can be <quote>previewed</quote>
without opening a new application to edit them in.<indexterm><primary>Previews</primary></indexterm> To preview a file,
hold the mouse cursor over the name of the file for about a second: a
popup window will appear, showing the contents of the file and other some
useful information, like file's size and which user owns the file.</para>

<para>You can open any item by clicking on the icon for the
file.  Folders will be opened in the same window; files will either be
opened in the appropriate program, or the file manager will ask you
what program to use. For instance, if do not have a word-processor set up to
open &Microsoft; Word documents, the file manager will
ask you what to do.</para>

<para>You can go back to the last-opened folder by clicking on the
<guiicon>Back</guiicon><!--screenie --> button or go up one folder by clicking
the <guiicon>Up</guiicon><!--screenie --> button.</para>
</sect2>

<sect2 id="the-navigation-panel">
<title>The Navigation Panel (aka <quote>The Sidebar</quote>)</title>

<indexterm><primary>Navigation Panel</primary></indexterm>
<indexterm><primary>Sidebar</primary></indexterm>

<mediaobject>
<imageobject>
<imagedata fileref="konq-sidebar.png" format="PNG" />
</imageobject>
<caption><para>The &konqueror; sidebar</para></caption>
</mediaobject>

<para>Navigating through the folders by using
the folder view can become impractical. The sidebar provides
shortcuts and special functions that make it easier to
find what you are searching for.</para>

<para>On the left edge of the sidebar be several buttons, each
 with a different icon, such as the following:</para>

<!-- TODO: Add screenies of what each of these buttons looks like -->
<variablelist>

<varlistentry>
<term><guilabel>Bookmarks</guilabel></term>

<listitem>
<para>As &konqueror; (the file manager) also serves as a very powerful
web browser, it also has a bookmark functionality. Here you will find the
same structure as in your <guimenu>Bookmarks</guimenu> menu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Devices</guilabel></term>

<listitem>
<para>Next the sidebar provides a list of all known devices
on your computer. These devices can be either physical drives &mdash;
such as your hard disk, &CD-ROM; drive, or floppy disk drive &mdash;
or virtual <quote>drives</quote> &mdash; such as remote shares or hard disk partitions.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>History</guilabel></term>

<listitem>
<para>&konqueror; will remember the web pages you have visited and list them
either by date or alphabetically in a tree structure. You can select the
behavior by right clicking on the <guilabel>History</guilabel> item and
selecting <guimenu>Sort by</guimenu>. Left click on an item (&eg;
<guilabel>www.kde.org</guilabel>) and &konqueror; will show you the documents you have visited. Left
clicking on a document (&eg; <guilabel>index.html</guilabel>) will open
the web site in the folder view.</para>
<para>Right clicking on a history item, like <menuchoice><guimenu>www.kde.org</guimenu><guimenuitem>index.html</guimenuitem>
</menuchoice>, opens a slightly different popup menu: you will also find the
item <guimenuitem>New Window</guimenuitem>, which makes &konqueror; open the
site in a new window.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Home Directory</guilabel></term>

<listitem>
<para>The <guilabel>Home Directory</guilabel> item is in the sidebar's navigation
panel. You will find your home directory as the first entry. Below you will
find all folders of your home directory. Left clicking on any
folder in this view opens the folder in the folder view.  Alternatively, you can also
work with the folders' context menus, create subfolders, and so on.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sidebar Media Player</guilabel></term>

<listitem>
<!-- TODO: think of a better solution for marking up the file -->
<!-- formats. It should probably involve entities -->
<para>Try dragging a music file (like <acronym>MP3</acronym>, Ogg, or
<literal role="extension">.wav</literal> files)
on the sidebar. The file will immediately be played.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Newsticker</guilabel></term>
<!-- I don't have this button. Ought to check what it depends on -->
<listitem>
<para>Newsticker will display a customisable list of news sources. Right-click
either on the <guilabel>Configure button</guilabel> or on one of the
newssource buttons (e.g. TDE News, which is usually predefined) to add a new
newsticker source.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Network</guilabel></term>

<listitem>
<para>Here you can browse the services provided by other computers on
the network. The &lisa;-Daemon has to be started in order to work
correctly. The network browser allows you to see a variety of services
provided by a computer. You can easily browse <acronym>SMB</acronym>
shares, &HTTP; sites, or transfer files via the secure FISH
layer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Root Directory</guilabel></term>

<listitem>
<para>Everything on a &UNIX;-based system is organized in a file
system tree. This tree must have a root and here it is. The
<guilabel>Root Directory</guilabel> function is like the
<guilabel>Home Directory</guilabel> function. The only difference is
that every folder is being displayed, not only your home
directory.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Services</guilabel></term>

<listitem>
<para>This is somehow the "rest". Try browsing through the different
items. If an Audio &CD; is in your &CD; or <acronym>DVD</acronym>
drive you will be able to find everything on it and even more in the
<guilabel>Audio CD Browser</guilabel> item (you can even compress
audio files and save them on your hard drive with this
function).</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="filemanager-icons">
<title>Icons</title>

<para>
To select only one icon hold down the &Ctrl; key and click on the icon
you want to select. If you want to select more than one icon, hold
down &Ctrl; while you click on each of the items you want to select.
Once one or more icons are selected you can do what you want with
them.  If you want to move or copy items, select them and then drag them
(with the left mouse button down) to the desired location. When
you release the mouse button a menu will come up offering you to
<guimenuitem>Move</guimenuitem><indexterm><primary>Moving
Files</primary></indexterm>,
<guimenuitem>Copy</guimenuitem><indexterm><primary>Copying
Files</primary></indexterm>, or <guimenuitem>Link</guimenuitem> the
selected items.  You can also <guimenuitem>Cancel</guimenuitem> your
action.
</para>

<para>Many other actions can be applied to the selected items by
right-clicking on one of the selected items, and choosing the action
from the menu which appears. (The exact contents of this menu depend on the
type of files selected, so it is called a <quote>context menu</quote>).</para>
</sect2>

<sect2 id="links">
<title>Links and Shortcuts</title>

<para>
As already mentioned above you can link files or folders anywhere. It means
that the linked folder will appear and behave just like the original in
another location without consuming additional space on your harddrive.
So if you, for example, have a number of documents, and only a few are used
regularly, you can easily group them in a folder and create links in it.
</para>

</sect2>

<sect2 id="trash">
<title>The Trash</title>

<indexterm><primary>Trash</primary></indexterm>
<indexterm><primary><quote>Recycle Bin</quote></primary></indexterm>

<para>Before a file is deleted in the &tde; file manager it will be
moved to the <filename>Trash</filename> folder to give you the
possibility of getting it back if you deleted it by accident.  The
trash bin will show all deleted items. You can select the one to be
recovered and move it to its original place as described in <xref
linkend="filemanager-icons" />.  If you right click on the trash bin and select
<guimenuitem>Empty trash bin</guimenuitem> the files in it will be
deleted permanently.</para>

<!-- Add links to "further reading" here -->
<itemizedlist>
<title>Related Information</title>

<listitem><para>The <ulink url="help:/konqueror">&konqueror; Handbook</ulink>
has much more information about the features available in
&konqueror;.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>