runtime/doc/kcontrol/filemanager/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <articleinfo>
  10
  11 <authorgroup>
  12 <author>&Mike.McBride; &Mike.McBride.mail;</author>
  13 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  14 </authorgroup>
  15
  16 <date>2002-10-16</date>
  17 <releaseinfo>3.1</releaseinfo>
  18
  19 <keywordset>
  20 <keyword>KDE</keyword>
  21 <keyword>KControl</keyword>
  22 <keyword>file manager</keyword>
  23 </keywordset>
  24 </articleinfo>
  25 <sect1 id="file-manager">
  26 <title>File Manager</title>
  27
  28 <para>In this module, you can configure various aspects of
  29 &konqueror;'s file manager functionality. </para>
  30
  31 <note><para>&konqueror;'s web browser functionality has its <ulink
  32 url="help:/kcontrol/khtml/index.html">own configuration
  33 modules</ulink>.</para></note>
  34
  35 <sect2 id="fileman-use">
  36 <title>Use</title>
  37
  38 <para> The configuration options for the file manager are
  39 organized under tabs as follows:</para>
  40
  41 <variablelist>
  42 <varlistentry>
  43 <term><guilabel>Appearance</guilabel></term>
  44 <listitem><para>This tab contains options for customizing the appearance of
  45 &konqueror; windows, such as the default font
  46 text color.</para></listitem>
  47 </varlistentry>
  48
  49 <varlistentry>
  50 <term><guilabel>Behavior</guilabel></term>
  51 <listitem><para>This tab contains a couple of &konqueror;
  52 global options.</para></listitem>
  53 </varlistentry>
  54
  55 <varlistentry>
  56 <term><guilabel>Previews</guilabel></term>
  57 <listitem>
  58 <para>On this tab, you can customize when &konqueror; should show
  59 previews.</para>
  60 </listitem>
  61 </varlistentry>
  62 </variablelist>
  63
  64 <sect3 id="fileman-appearance">
  65 <title>Appearance</title>
  66
  67 <para>The following settings determine how text and colors are displayed in
  68 &konqueror; File Manager mode windows.</para>
  69
  70 <variablelist>
  71 <varlistentry>
  72 <term><guilabel>Standard font:</guilabel></term>
  73 <listitem>
  74 <para>This is the font used to display text such as file names in
  75 &konqueror; windows.</para>
  76 </listitem>
  77 </varlistentry>
  78
  79 <varlistentry>
  80 <term><guilabel>Font size:</guilabel></term>
  81 <listitem>
  82
  83 <para>Lets you control the size of text, while the <guilabel>Standard
  84 Font</guilabel> setting determines the font face used.</para>
  85 </listitem>
  86 </varlistentry>
  87
  88 <varlistentry>
  89 <term><guilabel>Normal text color:</guilabel></term>
  90 <listitem>
  91 <para>Determines the standard text color.</para>
  92 </listitem>
  93 </varlistentry>
  94
  95 <varlistentry>
  96 <term><guilabel>Height for icon text:</guilabel></term>
  97 <listitem>
  98 <para>The maximum number of lines that can be used to draw icon text.  Long lines are truncated at the end of the last line.</para>
  99 <tip> <para>You can still see word-wrapped filenames by pausing the mouse pointer over the icon.</para></tip>
 100 </listitem>
 101 </varlistentry>
 102
 103 <varlistentry>
 104 <term><guilabel>Width for icon text:</guilabel></term>
 105 <listitem>
 106 <para>The maximum width for the icon text when &konqueror; is in multi-column view mode.</para>
 107 </listitem>
 108 </varlistentry>
 109
 110 <varlistentry>
 111 <term><guilabel>Underline filenames:</guilabel></term>
 112 <listitem>
 113 <para>When <guilabel>Underline filenames</guilabel> is checked,
 114  filenames will be underlined so that they look like links on a web
 115  page.</para>
 116 </listitem>
 117 </varlistentry>
 118
 119 <varlistentry>
 120 <term><guilabel>Display file sizes in bytes:</guilabel></term>
 121 <listitem>
 122 <para>The final check box on this page determines how &konqueror;
 123 displays file sizes, when you are in one of the file manager modes
 124 that normally shows this information.  If you check the
 125 <guilabel>Display file sizes in bytes</guilabel> box then file sizes
 126 are always shown in bytes.  If you leave it unchecked then file sizes
 127 are shown in bytes, kilobytes or megabytes, depending on their
 128 size.</para>
 129 </listitem>
 130 </varlistentry>
 131 </variablelist>
 132 </sect3>
 133
 134 <sect3 id="fileman-behav">
 135 <title>Behavior</title>
 136
 137 <variablelist>
 138 <title><guilabel>Misc Options</guilabel></title>
 139 <varlistentry>
 140 <term>Open folders in separate windows</term>
 141 <listitem> <para>If this option is checked, a new
 142 &konqueror; window will be created when you open a
 143 folder, rather than simply showing that folder's contents in the
 144  current
 145 window.</para></listitem>
 146 </varlistentry>
 147
 148 <varlistentry>
 149 <term>Show network operations in a single window</term>
 150 <listitem>
 151 <para>If unchecked, and you download a
 152 file, a dialog box will appear that shows the status of the
 153 download.</para>
 154
 155 <screenshot>
 156   <screeninfo>Download Dialog Box</screeninfo>
 157   <mediaobject>
 158   <imageobject><imagedata fileref="kfileman2.png"
 159  format="PNG"/></imageobject>
 160   <textobject> <phrase>Download Dialog Box</phrase> </textobject>
 161   <caption>
 162   <para>Individual Download Dialog Box</para>
 163   </caption>
 164   </mediaobject>
 165 </screenshot>
 166
 167 <para>If you start a new transfer, another dialog box will
 168 appear. (&Netscape; users will be familiar with
 169 this behavior) </para>
 170
 171 <para>If checked, all transfer status windows will be grouped
 172 together under a single dialog box.</para>
 173 <screenshot>
 174   <screeninfo>Download Dialog Box</screeninfo>
 175   <mediaobject>
 176   <imageobject><imagedata fileref="kfileman1.png"
 177  format="PNG"/></imageobject>
 178   <textobject><phrase>Download Dialog Box</phrase></textobject>
 179   <caption>
 180   <para>Collected Download Dialog Box</para>
 181   </caption>
 182   </mediaobject>
 183 </screenshot>
 184
 185 <para>If you choose to use the Collected download dialog box, you can
 186 delete transfers by clicking once on the transfer you want to cancel,
 187 then clicking the <guibutton>Delete</guibutton> Button on the
 188 left.</para>
 189
 190 </listitem>
 191 </varlistentry>
 192
 193 <varlistentry>
 194 <term><guilabel>Show file tips</guilabel></term>
 195 <listitem>
 196 <para> Here you can control if, when moving the mouse over a file, you
 197 want to see a small popup window with additional information about
 198 that file.</para>
 199 </listitem>
 200 </varlistentry>
 201
 202 <varlistentry>
 203 <term><guilabel>Show previews in file tips</guilabel></term>
 204 <listitem>
 205 <para>Here you can control if the file tip should show a
 206 thumbnail preview of the file.
 207 </para>
 208 </listitem>
 209 </varlistentry>
 210
 211 <varlistentry>
 212 <term><guilabel>Home URL</guilabel></term>
 213 <listitem><para>This is the &URL; (&eg; a
 214 folder or a web page) where &konqueror; will jump to
 215 when the <guibutton>Home</guibutton> button is pressed.</para><para>The
 216 default is the users home folder, indicated with a
 217 <literal>~</literal>.</para></listitem>
 218 </varlistentry>
 219 </variablelist>
 220
 221 <para>You can set a path that is your <guilabel>Home URL</guilabel> by
 222 typing into the text field, or using the <guiicon>browse</guiicon>
 223 icon.  The default is <literal>~</literal> which is a standard
 224 shortcut for your $<envar>HOME</envar> folder.  When you choose the
 225 <guiicon>home</guiicon> icon on your panel, in a file open or save
 226 dialog, or from within &konqueror; in file manager mode, this is the
 227 folder you will be shown.</para>
 228
 229 <para>The <guilabel>Ask confirmation for</guilabel> setting tells
 230 &konqueror; what to do when you choose to <quote>Delete</quote>,
 231 <quote>Trash</quote>, or <quote>Shred</quote> a file in a &konqueror;
 232 window.  If any box is checked, &konqueror; asks for confirmation before
 233 performing the corresponding action.</para>
 234
 235 </sect3>
 236
 237 <sect3>
 238 <title>Previews</title>
 239
 240 <para>&konqueror; has a
 241 preview feature for many file types, including <acronym>HTML</acronym>
 242 files, images, &PostScript; and <acronym>PDF</acronym>, sound, web
 243 archives (if you have the appropriate &konqueror; plugin installed)
 244 and text files.</para>
 245
 246 <para>If you enable previews for one of these, files of that particular
 247 file type will not be represented by standard icons in the filemanager, but
 248 will instead be shown as miniature previews.  On slow computers, the
 249 previews can take some time to show up, so you might not want to enable
 250 this feature.</para>
 251
 252 <para>In this module you can specify which <quote>protocols</quote>
 253 you wish the previews to be available for.  Creating the previews
 254 requires that &konqueror; download at least part of the file, in order
 255 to create the preview.  &konqueror;, like the rest of &kde; is
 256 entirely network transparent, and will treat a remote &FTP; folder
 257 just as if it was on your local hard drive.  This can result in a
 258 delay, especially if you are viewing, for example, a folder full of
 259 images over a slow network connection.</para>
 260
 261 <para>For each protocol, you can independently enable or disable
 262 previews.  For example, you might enable previews for
 263 <acronym>NFS</acronym> mounted drives if you have a fast network, but
 264 disable them for &FTP; because your Internet connection is via a
 265 modem.</para>
 266
 267 <para>You can further refine the maximum size file that &konqueror;
 268 will attempt to show a preview for.  The default is 1 MB.  In other
 269 words, by default, if a file is 900 kB in size, and the protocol you
 270 are viewing the folder with is enabled, then &konqueror; will
 271 create a preview icon for it.  If the file is 1.1 MB in size,
 272 &konqueror; will not make a preview, even if the protocol is
 273 enabled.</para>
 274
 275 <para>You can turn on and off previews <quote>on the fly</quote> from
 276 within &konqueror;, using the <guimenu>View</guimenu> menu. For
 277 example, if you normally want to see image previews on every protocol,
 278 but find a particular server is very slow to send you the data, you
 279 might turn it off for the present, and turn it on again later.</para>
 280
 281 <para>You may also like to enable the checkbox <guilabel>Increase size
 282 of previews relative to icons</guilabel>, in order to see more
 283 information in the thumbnails.</para>
 284
 285 <para>Many image files already contain a thumbnail.  You can enable
 286 the <guilabel>Use thumbnails embedded in files</guilabel> to make use
 287 of these. This will save time waiting for thumbnails to be created
 288 when viewing a folder full of images you have not previously seen in
 289 &konqueror;.</para>
 290
 291 </sect3>
 292
 293 </sect2>
 294
 295 </sect1>
 296
 297 </article>