Warning, /system/dolphin/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY % addindex "IGNORE">
0004   <!ENTITY % English "INCLUDE"><!-- change language only here -->
0005 ]>
0006 
0007 <book id="dolphin" lang="&language;">
0008 
0009 <bookinfo>
0010 <title>The &dolphin; Handbook</title>
0011 
0012 <authorgroup>
0013 <author>
0014 <firstname>Peter</firstname>
0015 <othername></othername>
0016 <surname>Penz</surname>
0017 <affiliation>
0018 <address><email>peter.penz@gmx.at</email></address>
0019 </affiliation>
0020 </author>
0021 <author>
0022 <firstname>Orville</firstname>
0023 <surname>Bennett</surname>
0024 <affiliation>
0025 <address>&Orville.Bennett.mail;</address>
0026 </affiliation>
0027 </author>
0028 <author>
0029 <firstname>Michael</firstname>
0030 <surname>Austin</surname>
0031 <affiliation>
0032 <address><email>tuxedup@users.sourceforge.net</email></address>
0033 </affiliation>
0034 </author>
0035 <author>
0036 <firstname>David</firstname>
0037 <surname>Edmundson</surname>
0038 <affiliation>
0039 <address><email>kde@davidedmundson.co.uk</email></address>
0040 </affiliation>
0041 </author>
0042 <author>
0043 <firstname>Alan</firstname>
0044 <surname>Blanchflower</surname>
0045 </author>
0046 <author>
0047 <firstname>Frank</firstname>
0048 <surname>Reininghaus</surname>
0049 <affiliation>
0050 <address><email>frank78ac@googlemail.com</email></address>
0051 </affiliation>
0052 </author>
0053 
0054 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0055 </authorgroup>
0056 
0057 <copyright>
0058 <year>2006</year>
0059 <holder>Peter Penz</holder>
0060 </copyright>
0061 <copyright>
0062 <year>2006</year>
0063 <holder>&Orville.Bennett;</holder>
0064 <holder>Michael Austin</holder>
0065 </copyright>
0066 <copyright>
0067 <year>2009</year>
0068 <holder>Frank Reininghaus</holder>
0069 </copyright>
0070 
0071 <legalnotice>&FDLNotice;</legalnotice>
0072 
0073 <date>2022-01-17</date>
0074 <releaseinfo>KDE Gear 22.04</releaseinfo>
0075 
0076 <abstract>
0077 <para>
0078 &dolphin; is the default file manager by &kde;, designed with usability as a primary focus.
0079 </para>
0080 </abstract>
0081 
0082 <keywordset>
0083 <keyword>KDE</keyword>
0084 <keyword>Dolphin</keyword>
0085 <keyword>Filemanager</keyword>
0086 <keyword>file</keyword>
0087 <keyword>management</keyword>
0088 </keywordset>
0089 
0090 </bookinfo>
0091 
0092 <chapter id="introduction">
0093 <title>Introduction</title>
0094 
0095 <para>
0096 &dolphin; is &plasma;'s default file manager. It aims to improve usability at the
0097 user interface level. &dolphin; focuses only on being a file manager whereas
0098 &konqueror;, which was &kde;'s default file manager in &kde; 3 and can still be
0099 used for file management, is a universal viewer for many file types.
0100 </para>
0101 
0102 <para>
0103 This design approach allows the developers to concentrate on optimizing the user
0104 interface for the specific task of file management.
0105 </para>
0106 
0107 <para>
0108 Please report any problems or feature requests to the &dolphin; author via the
0109 bug report dialog. This is accessible either from the <guibutton>Control</guibutton> 
0110 button at the right of the toolbar in the default mode without
0111 menubar; or from <menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice>
0112 menu of the application, if the menubar is shown.
0113 </para>
0114 
0115 </chapter>
0116 
0117 <chapter id="using-dolphin">
0118 <title>Using &dolphin;</title>
0119 
0120 <sect1 id="dolphin-user-interface">
0121 <title>&dolphin; User Interface</title>
0122 
0123 <para>
0124 The screenshot below shows &dolphin;'s default user interface:
0125 </para>
0126 
0127 <screenshot>
0128 <screeninfo>Screenshot of &dolphin;'s default user interface</screeninfo>
0129 <mediaobject>
0130 <imageobject>
0131 <imagedata fileref="default-ui.png" format="PNG"/>
0132 </imageobject>
0133 <textobject>
0134 <phrase>&dolphin;'s default user interface.</phrase>
0135 </textobject>
0136 <caption><para>&dolphin;'s default user interface.</para></caption>
0137 </mediaobject>
0138 </screenshot>
0139 
0140 <para>
0141 The elements of the default user interface are:
0142 
0143 <itemizedlist>
0144 
0145 <listitem><para>
0146 The toolbar, which can be used for quick access to frequently used actions. The
0147 toolbar can be customized by clicking it with the &RMB; and choosing
0148 <menuchoice><guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>
0149 from the context menu, with <guimenuitem>Configure Toolbars...</guimenuitem>
0150 from the <guibutton>Control</guibutton> button at the 
0151 right of the toolbar or via <menuchoice><guimenu>Settings</guimenu>
0152 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>
0153 from the main menu.
0154 </para>
0155 <screenshot>
0156 <screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
0157 <mediaobject>
0158 <imageobject>
0159 <imagedata fileref="toolbar.png" format="PNG"/>
0160 </imageobject>
0161 <textobject>
0162 <phrase>The default toolbar.</phrase>
0163 </textobject>
0164 <caption>
0165 <para>
0166 Toolbar items where the icon is sufficient for knowing the command do not have text
0167 alongside the icons. This can be changed by a &RMB; click and selecting the item text 
0168 below <guilabel>Show Text</guilabel>. The <guibutton>Control</guibutton> 
0169 button at the right side of the toolbar is only displayed if the menubar is hidden.
0170 </para>
0171 </caption>
0172 </mediaobject>
0173 </screenshot>
0174 </listitem>
0175 
0176 <listitem><para>
0177 The location bar, which always displays the path to the current folder. It can
0178 be switched between two different modes, see the
0179 <link linkend="location-bar">section on the location bar</link> for details.
0180 </para></listitem>
0181 
0182 <listitem><para>
0183 The <link linkend="dolphin-view">view</link>, which shows all files
0184 and folders in the current folder.
0185 </para></listitem>
0186 
0187 <listitem><para>
0188 The <link linkend="places-panel"><guilabel>Places</guilabel> panel</link>, which
0189 provides quick access to bookmarked locations and disks or other media.
0190 </para>
0191 <para>If desktop search and file indexing are enabled in the <guilabel>Desktop Search</guilabel> 
0192 module in the &systemsettings; the panel provides <guilabel>Recent</guilabel>
0193 items and allows you to search for <guilabel>Documents</guilabel>, <guilabel>Images</guilabel>,
0194 <guilabel>Audio Files</guilabel> and <guilabel>Video</guilabel>.
0195 </para></listitem>
0196 
0197 <listitem><para>
0198 The status bar. It displays the name, size and type of the file which is
0199 currently hovered over with the mouse, or the number and size of the files which are
0200 selected. At the right, there is a zoom slider that allows you to adjust the size
0201 of the icons in the view.
0202 </para></listitem>
0203 
0204 <listitem><para>
0205 The menubar (hidden by default), which provides access to all commands and configuration options.
0206 See the <link linkend="commands-menubar">Command Reference</link> for a list of
0207 all menu commands. The menubar can be toggled with 
0208 <guimenuitem>Show Menubar</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>) 
0209 from the <guimenu>Settings</guimenu> menu or the <guibutton>Control</guibutton> button.
0210 </para>
0211 <para>If the menubar is hidden, all its actions are available from the 
0212 <guibutton>Control</guibutton> button.
0213 </para></listitem>
0214 
0215 <listitem><para>
0216 The additional <guilabel>Information</guilabel>, <guilabel>Folders</guilabel> 
0217 and <guilabel>Terminal</guilabel> panels are hidden
0218 by default, for more information see <link linkend="panels"><guilabel>Panels</guilabel>.</link>
0219 </para></listitem>
0220 
0221 </itemizedlist>
0222 
0223 </para>
0224 
0225 </sect1>
0226 
0227 <sect1 id="dolphin-view">
0228 <title>The &dolphin; View</title>
0229 
0230 <sect2 id="dolphin-view-using">
0231 <title>Using the View</title>
0232 
0233 <para>
0234 The view displays all files and folders in the current folder. These items
0235 can be accessed or manipulated in different ways:
0236 </para>
0237 <itemizedlist>
0238 
0239 <listitem><para>
0240 A file or folder can be opened by clicking it with the &LMB; (or
0241 double-clicking, if <guilabel>Open by double-clicking instead</guilabel>
0242 is enabled in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
0243 <guimenuitem>General Behavior</guimenuitem></menuchoice> module).
0244 </para></listitem>
0245 
0246 <listitem><para>
0247 Clicking any item or the white area around the items with the &RMB; opens a
0248 context menu which provides access to many frequently used actions for the item
0249 or the current folder, respectively.
0250 </para></listitem>
0251 
0252 <listitem><para>
0253 If the &LMB; is pressed on an item, but not immediately released, the item can
0254 be dragged and dropped in another folder in the current view or in another
0255 &dolphin; view (in another &dolphin; window or in the same window if the
0256 view is split, see below) to move or copy it or to create a symbolic link.
0257 Items can even be dropped in another application to open them in that application.
0258 </para></listitem>
0259 
0260 </itemizedlist>
0261 <para>
0262 &dolphin; remembers the history of visited folders. To navigate backward or
0263 forward in the history, the corresponding buttons in the toolbar can be used:
0264 </para>
0265 
0266 <screenshot>
0267 <screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
0268 <mediaobject>
0269 <imageobject>
0270 <imagedata fileref="toolbar-navigation.png" format="PNG"/>
0271 </imageobject>
0272 <textobject>
0273 <phrase>The Back and Forward buttons in the toolbar.</phrase>
0274 </textobject>
0275 <caption>
0276 <para>
0277 The <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons in
0278 the toolbar can be used to navigate in the history.
0279 </para>
0280 </caption>
0281 </mediaobject>
0282 </screenshot>
0283 
0284 <para>If you click with the &MMB; the item in the history is opened in a new tab
0285 thus keeping the current tab with its content.
0286 </para>
0287 </sect2>
0288 
0289 <sect2 id="dolphin-view-appearance">
0290 <title>&dolphin; View Appearance</title>
0291 
0292 <para>
0293 The toolbar contains buttons to control the appearance of the view:
0294 </para>
0295 
0296 <screenshot>
0297 <screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
0298 <mediaobject>
0299 <imageobject>
0300 <imagedata fileref="toolbar-view-appearance.png" format="PNG"/>
0301 </imageobject>
0302 <textobject>
0303 <phrase>The buttons in the toolbar which control the appearance of the view.</phrase>
0304 </textobject>
0305 <caption><para>
0306 The buttons in the toolbar which control the appearance of the view.
0307 </para></caption>
0308 </mediaobject>
0309 </screenshot>
0310 
0311 <para>
0312 All the settings discussed below and other options concerning, &eg; the
0313 sorting of the files in the current folder, can also be modified in the
0314 <guimenu>View</guimenu> menu and in the
0315 <link linkend="view-properties-dialog">View Display Style dialog</link>. By
0316 default, these settings are remembered for each folder separately. This
0317 behavior can be changed in the
0318 <link linkend="preferences-dialog-general"><quote>General</quote></link> section of the settings.
0319 </para>
0320 
0321 <sect3 id="dolphin-view-modes">
0322 <title>View Modes</title>
0323 
0324 <para>
0325 The first three buttons in the above screenshot switch between &dolphin;'s
0326 view modes.
0327 <!-- begin copy to konqueror filemanager.docbook -->
0328 <itemizedlist>
0329 
0330 <listitem><para>
0331 In the <guibutton>Icons</guibutton> view, which is the default, files will be
0332 represented by an icon that visualizes the file type, and a folder icon will be
0333 shown for subfolders. The names of folders and files, and the items enabled in
0334 <menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice>,
0335 are displayed below the icons.
0336 </para></listitem>
0337 
0338 <listitem><para>
0339 The <guilabel>Compact</guilabel> view shows the folder contents as icons with 
0340 the name beside it and the items enabled in
0341 <menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice> 
0342 below the name. The items are grouped in columns similar to the <guilabel>Short View</guilabel> 
0343 in the &kde; file dialog.
0344 </para></listitem>
0345 
0346 <listitem><para>
0347 In the <guibutton>Details</guibutton> view, the folder contents are displayed
0348 as a detailed list which contains the name, size and last modification time of
0349 each item. Additional columns can be added by clicking a column header with the
0350 &RMB;.
0351 </para>
0352 <para>In the context menu of the header line, you can add or remove side padding
0353 by checking or unchecking the respective menu item and choose between a custom
0354 or automatic column width. Automatic width adjusts the width of all columns once to display the
0355 longest item in the column completely, except for the <guilabel>Name</guilabel> column where 
0356 the extension is replaced by <quote>...</quote> 
0357 </para>
0358 <para>The order of columns can be changed by drag and drop of column headers, except for
0359 the <guilabel>Name</guilabel> header, which is always the first column in this view.
0360 </para>
0361 <para>
0362 The details view allows you to view the current folder
0363 in a tree-like fashion if <link linkend="preferences-dialog-viewmodes-details">
0364 <guilabel>Expandable folders</guilabel></link> are enabled:
0365 Each subfolder of the current folder can be
0366 <quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>></guiicon>
0367 or <guiicon>v</guiicon> icon next to it.</para></listitem>
0368 </itemizedlist>
0369 </para>
0370 
0371 <screenshot>
0372 <screeninfo>Grouped View</screeninfo>
0373 <mediaobject>
0374 <imageobject>
0375 <imagedata fileref="grouping-view.png" format="PNG"/>
0376 </imageobject>
0377 <textobject>
0378 <phrase>Grouped View</phrase>
0379 </textobject>
0380 <caption><para>All view modes support grouping by the sort type selected 
0381 in <menuchoice><guimenu>View</guimenu><guisubmenu>Sort by</guisubmenu></menuchoice></para></caption>
0382 </mediaobject>
0383 </screenshot>
0384 <!-- end copy to konqueror filemanager.docbook -->
0385 
0386 </sect3>
0387 
0388 <sect3 id="dolphin-view-information">
0389 <title>Information in the View</title>
0390 <para>
0391 In all view modes &dolphin; shows at least an icon and a name for each item. 
0392 Using <guisubmenu>Additional Information</guisubmenu> in the <guimenu>View</guimenu> 
0393 menu or the context menu of the header in <guilabel>Details</guilabel> mode, you can select
0394 more information for each item to be shown:
0395 </para>
0396 
0397 <para>
0398 <guimenuitem>Size</guimenuitem>, <guimenuitem>Date</guimenuitem>,
0399 <guimenuitem>Type</guimenuitem>, <guimenuitem>Rating</guimenuitem>,
0400 <guimenuitem>Tags</guimenuitem> or <guimenuitem>Comment</guimenuitem>.
0401 </para>
0402 
0403 <para>Depending on the file type, additionally, sorting criteria can be selected:
0404 <simplelist>
0405   <member><guimenuitem>Document</guimenuitem>: Number of words and lines</member>
0406   <member><guimenuitem>Image</guimenuitem>: Size and orientation</member>
0407   <member><guimenuitem>Audio</guimenuitem>: Artist, album, duration and track</member>
0408 </simplelist>
0409 </para>
0410 
0411 <para>The <guisubmenu>Other</guisubmenu> submenu allows you to select
0412 <guimenuitem>Path</guimenuitem>, <guimenuitem>Link Destination</guimenuitem>, 
0413 <guimenuitem>Copied From</guimenuitem>,
0414 <guimenuitem>Permissions</guimenuitem>, <guimenuitem>Owner</guimenuitem> or 
0415 <guimenuitem>User Group</guimenuitem>.
0416 </para>
0417 
0418 </sect3>
0419 
0420 <sect3 id="preview">
0421 <title>Preview</title>
0422 
0423 <para>
0424 If <guibutton>Preview</guibutton> is enabled, the icons are based on the actual
0425 file or folder contents; &eg; for images a scaled down preview of the image is
0426 shown.
0427 </para>
0428 
0429 </sect3>
0430 
0431 <sect3 id="split-view">
0432 <title>Split</title>
0433 
0434 <para>
0435 If <guibutton>Split</guibutton> is clicked, two views are shown which can
0436 display the contents of different folders. This can be convenient for moving or
0437 copying files.
0438 </para>
0439 
0440 </sect3>
0441 
0442 </sect2>
0443 <!-- begin copy to konqueror filemanager.docbook -->
0444 <sect2 id="selection">
0445 <title>Selecting Items in the View</title>
0446 
0447 <para>
0448 There are several ways to select items in the view. Once a group of items
0449 is selected, all actions, such as
0450 <menuchoice><guimenuitem>Cut</guimenuitem></menuchoice>,
0451 <menuchoice><guimenuitem>Copy</guimenuitem></menuchoice>,
0452 <menuchoice><guimenuitem>Move to Trash</guimenuitem></menuchoice>,
0453 and drag and drop operations, affect all selected items.
0454 </para>
0455 
0456 <sect3 id="selection-mouse">
0457 <title>Selecting Items Using the Mouse</title>
0458 
0459 <itemizedlist>
0460 
0461 <listitem><para>
0462 You can press the &LMB; somewhere in the view and draw a rectangle around
0463 a group of items before releasing the button. This will select all items in the
0464 rectangle and clear the previous selection. If the &Shift; key is pressed during
0465 the selection process, the previous selection is kept.
0466 </para></listitem>
0467 
0468 <listitem><para>
0469 If the &Ctrl; key is pressed while an item is clicked with the &LMB;, the
0470 selection state of this item is toggled. If the &Ctrl; key is pressed while a
0471 rectangle is drawn around a group of items as described above, the selection
0472 state of all items in the rectangle will be toggled.
0473 </para></listitem>
0474 
0475 <listitem><para>
0476 If the &Shift; key is pressed while an item is clicked with the &LMB;, all items
0477 between the previous current item and the clicked item will be selected.
0478 </para></listitem>
0479 
0480 <listitem><para>
0481 If <guilabel>Show selection marker</guilabel> is enabled in the
0482 <link linkend="preferences-dialog-general-behavior"><quote>Behavior</quote>
0483 tab of the <guilabel>General</guilabel> section of the settings</link>, a small
0484 <guiicon>+</guiicon> or <guiicon>-</guiicon> button appears in the top
0485 left corner of the item which is currently hovered over with the mouse. Clicking
0486 this sign selects or deselects the item, respectively.
0487 </para></listitem>
0488 
0489 </itemizedlist>
0490 
0491 </sect3>
0492 
0493 <sect3 id="selection-keyboard">
0494 <title>Selecting Items Using the Keyboard</title>
0495 
0496 <itemizedlist>
0497 
0498 <listitem><para>
0499 If an arrow key, <keycap>Page Up</keycap>, <keycap>Page Down</keycap>,
0500 <keycap>Home</keycap>, or <keycap>End</keycap> is pressed, the new current item
0501 is selected, and the previous selection is cleared.
0502 </para></listitem>
0503 
0504 <listitem><para>
0505 If the &Ctrl; key is held while one of the above keys is pressed, the selection
0506 remains unchanged.
0507 </para></listitem>
0508 
0509 <listitem><para>
0510 If the &Shift; key is held while one of the above keys is pressed, all items
0511 between the previous current item and the new current item will be selected.
0512 </para></listitem>
0513 
0514 <listitem><para>
0515 If <keycombo action="simul">&Ctrl;<keysym>Space</keysym></keycombo> is pressed,
0516 the selection state of the current item is toggled.
0517 </para></listitem>
0518 
0519 <listitem><para>
0520 <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> selects all items
0521 in the view.
0522 </para></listitem>
0523 
0524 <listitem><para>
0525 <keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo> toggles the
0526 selection state of all items in the view.
0527 </para></listitem>
0528 
0529 <listitem><para>
0530 Select a file or folder by typing the first few letters of its name and the 
0531 first matching item is selected. 
0532 To clear the selection and cancel the keyboard search press &Esc; or wait longer than
0533 the timeout of 1 second.
0534 </para></listitem>
0535 </itemizedlist>
0536 <!-- END copy to konqueror filemanager.docbook -->
0537 </sect3>
0538 
0539 </sect2>
0540 
0541 </sect1>
0542 
0543 <!--FIXME replace with links to KDE Fundamentals when location bar in file dialog
0544 has all features from dolphin ?-->
0545 
0546 <sect1 id="location-bar">
0547 <title>Location Bar</title>
0548 
0549 <para>
0550 The location bar, which can be found above &dolphin;'s view, displays
0551 the path to the current folder. The location bar has two modes.
0552 </para>
0553 
0554 <sect2 id="location-bar-bread-crumb">
0555 <title>Bread Crumb Mode</title>
0556 
0557 <para>
0558 In the <quote>bread crumb</quote> mode, which is the default, each folder name in
0559 the path to the current folder is a button which can be clicked to quickly open
0560 that folder. Moreover, clicking the <quote>&gt;</quote> sign to the right of a
0561 folder opens a menu which allows you to quickly open a subfolder of that folder.
0562 </para>
0563 
0564 <screenshot>
0565 <screeninfo>Screenshot of the location bar in bread crumb mode</screeninfo>
0566 <mediaobject>
0567 <imageobject>
0568 <imagedata fileref="locationbar-breadcrumb.png" format="PNG"/>
0569 </imageobject>
0570 <textobject>
0571 <phrase>Location bar in bread crumb mode.</phrase>
0572 </textobject>
0573 <caption><para>Location bar in bread crumb mode.</para></caption>
0574 </mediaobject>
0575 </screenshot>
0576 
0577 </sect2>
0578 
0579 <sect2 id="location-bar-editable">
0580 <title>Editable Mode</title>
0581 
0582 <para>
0583 When in bread crumb mode, clicking in the gray area to the right of the path
0584 with the &LMB; switches the location bar to <quote>editable</quote> mode,
0585 in which the path can be edited using the keyboard. To switch back to bread
0586 crumb mode, click the check mark at the right of the location bar with the &LMB;.
0587 </para>
0588 
0589 <screenshot>
0590 <screeninfo>Screenshot of the location bar in editable mode</screeninfo>
0591 <mediaobject>
0592 <imageobject>
0593 <imagedata fileref="locationbar-editable.png" format="PNG"/>
0594 </imageobject>
0595 <textobject>
0596 <phrase>Location bar in editable mode.</phrase>
0597 </textobject>
0598 <caption><para>Location bar in editable mode.</para></caption>
0599 </mediaobject>
0600 </screenshot>
0601 
0602 <sect3 id="location-bar-editable-kioslaves">
0603 <title>Using Kioslaves</title>
0604 
0605 <para>If the location bar is empty in editable mode, a drop down box appears in 
0606 front of the bar listing all available kioslaves on your system. Kioslaves are 
0607 programs built into &kde; which add support for many different protocols to 
0608 &dolphin; and other &kde; applications.</para> 
0609 
0610 <para>For example with the <quote>fish</quote> kioslave &dolphin; can be 
0611 used to manage files and folders on a remote host that is accessible 
0612 via <acronym>SSH</acronym>. To do this you would type <userinput>fish://username@remotehost</userinput> 
0613 into the location bar. Similar remote file management can be done on 
0614 remote hosts accessible via the &FTP;, &NFS;, SFTP, &SMB; (&CIFS;) or webdav protocols.</para>
0615 
0616 <para>It is also possible to use the kioslaves drop down box to access 
0617 &systemsettings;, fonts, trash, other programs and devices attached to your computer. 
0618 See the drop down box for the full list of capabilities available from kioslaves on your system.
0619 </para>
0620 <screenshot>
0621 <screeninfo>Screenshot of the list of kioslaves</screeninfo>
0622 <mediaobject>
0623 <imageobject>
0624 <imagedata fileref="locationbar-kioslaves-menu.png" format="PNG"/>
0625 </imageobject>
0626 <textobject>
0627 <phrase>Location bar showing list of available kioslaves.</phrase>
0628 </textobject>
0629 <caption><para>List of available kioslaves.</para></caption>
0630 </mediaobject>
0631 </screenshot>
0632 
0633 </sect3>
0634 </sect2>
0635 
0636 <sect2 id="location-place-context">
0637 <title>Places and Context</title>
0638 <!--FIXME this is now in file dialog in 4.11-->
0639 <para>
0640 If the <guilabel>Places</guilabel> panel is hidden; in both modes an additional icon 
0641 in front of the path is displayed. This icon can be clicked with the &LMB; to open a 
0642 menu which offers quick access to <quote>places</quote> and storage media. See the 
0643 <link linkend="places-panel">section about the Places Panel</link> for details.
0644 </para>
0645 
0646 <screenshot>
0647 <screeninfo>Location bar with Places icon</screeninfo>
0648 <mediaobject>
0649 <imageobject>
0650 <imagedata fileref="locationbar-places-icon.png" format="PNG"/>
0651 </imageobject>
0652 <textobject>
0653 <phrase>Location bar with Places icon</phrase>
0654 </textobject>
0655 </mediaobject>
0656 </screenshot>
0657 
0658 <para>The context menu of the location bar offers actions to switch between the modes and
0659 to copy and paste the path using the clipboard. Check the last option in this context menu to
0660 display either the full path starting with the root folder of the file system or to display 
0661 the path starting with the current places entry.
0662 </para>
0663 
0664 <screenshot>
0665 <screeninfo>Location bar context menu</screeninfo>
0666 <mediaobject>
0667 <imageobject>
0668 <imagedata fileref="locationbar-context-menu.png" format="PNG"/>
0669 </imageobject>
0670 <textobject>
0671 <phrase>Location bar  context menu</phrase>
0672 </textobject>
0673 </mediaobject>
0674 </screenshot>
0675 
0676 </sect2>
0677 
0678 </sect1>
0679 
0680 <sect1 id="panels">
0681 <title>Panels</title>
0682 
0683 <para>
0684 &dolphin; allows a number of panels to be placed next to the view. These can
0685 be enabled in <menuchoice><guimenu>View</guimenu><guisubmenu>Show Panels</guisubmenu></menuchoice>.
0686 By unlocking the panels and clicking and dragging a panel title, the panel can be moved 
0687 to a different position, even outside the window.
0688 </para>
0689 
0690 <sect2 id="places-panel">
0691 <title>Places</title>
0692 <!--FIXME difference between places panel in dolphin + kde filedialog + konqueror:
0693 context menu Icon Size? No different entries ?-->
0694 <!--Four groups: Places = Folders, Devices, Recent and with Baloo Search For -->
0695 <para>
0696 The <guilabel>Places</guilabel> panel is located at the left of the window by
0697 default. The <guilabel>Places</guilabel> panel shows any locations you have
0698 bookmarked. It also shows any disk or media attached to the computer, recently accessed items
0699 and allows you to search for certain type of files. The order of these entries can be changed by drag and drop.
0700 </para>
0701 
0702 <para>
0703 The easiest way to add a folder to the <guilabel>Places</guilabel> panel is to
0704 drag it and drop it in the panel. Moreover, you can click inside the panel with
0705 the &RMB; and choose <menuchoice><guimenuitem>Add Entry...</guimenuitem></menuchoice>
0706 from the context menu. The first procedure creates a system wide bookmark, the second
0707 procedure can be used to add the current path of the location bar or any desired folder or device.
0708 A dialog opens where label, location and icon can be edited and the usage of this entry 
0709 can be restricted to &dolphin;. 
0710 </para>
0711 
0712 <para>A &RMB; click opens the context menu to edit, add, hide or remove entries
0713 and change the icon size to one of the predefined values or lock/unlock the panels.
0714 </para>
0715 <para>The context menu has an action to open the entry in a new tab. 
0716 Devices can be unmounted using the context menu.
0717 </para>
0718 </sect2>
0719 
0720 <sect2 id="information-panel">
0721 <title>Information</title>
0722 
0723 <para>
0724 The <guilabel>Information</guilabel> panel shows extended information about the
0725 selected items(s) or about the current folder or the file which is currently hovered
0726 over with the mouse, including size, type, and date of last modification. It also
0727 features a large preview of the selected item and allows you to assign a rating,
0728 tags, and comments to it.
0729 </para>
0730 <!--FIXME panel context menu-->
0731 </sect2>
0732 
0733 <sect2 id="folders-panel">
0734 <title>Folders</title>
0735 
0736 <para>
0737 The <guilabel>Folders</guilabel> panel shows a tree view structure of the file
0738 system. It only shows folders. Clicking a folder with the &LMB; opens this folder
0739 in the &dolphin; view.
0740 </para>
0741 <para>Use <guilabel>Limit to Home Directory</guilabel> to hide all folders from
0742 the tree view except your <guilabel>Home</guilabel>.
0743 </para>
0744 </sect2>
0745 
0746 <sect2 id="terminal-panel">
0747 <title>Terminal</title>
0748 
0749 <para>
0750 This panel contains a terminal. The terminal will open at the folder currently
0751 shown in the &dolphin; view. Changing the folder in the active &dolphin;
0752 view will update the working folder of the terminal. Changing the directory in
0753 the terminal will update the working folder in the &dolphin; view.  The
0754 terminal only works with local media.
0755 </para>
0756 
0757 </sect2>
0758 
0759 </sect1>
0760 
0761 <sect1 id="quick-tips">
0762 <title>Quick Tips</title>
0763 
0764 <para>
0765 The following are a number of tips to save time when using &dolphin;.
0766 </para>
0767 
0768 <sect2 id="quick-bookmarking">
0769 <title>Quick Bookmarking</title>
0770 
0771 <para>
0772 To quickly create a bookmark in the <guilabel>Places</guilabel> panel for the
0773 current folder, &RMB; click in the work space and click
0774 <menuchoice><guimenuitem>Add to Places</guimenuitem></menuchoice> in the context menu.
0775 </para>
0776 
0777 <note>
0778     <para>
0779         The corresponding menu item visibility can be toggled via the
0780         <link linkend="preferences-dialog-context-menu">&dolphin; context menu settings</link>.
0781     </para>
0782 </note>
0783 
0784 </sect2>
0785 
0786 <sect2 id="filter-files">
0787 <title>Filtering Files</title>
0788 
0789 <para>
0790 &dolphin; is capable of filtering files, &ie; showing only those items in the
0791 view whose name contains a given text. For example, if you wish to show
0792 only the <acronym>MP3</acronym> files within a folder, you could filter for <quote>.mp3</quote>.
0793 This would then filter out all files whose name does not contain <quote>.mp3</quote>.
0794 </para>
0795 
0796 <para>
0797 To filter files, first enable the filter bar, either by pressing <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
0798 or via the menu: <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Filter...</guimenuitem> </menuchoice>.
0799 You can then enter the text to be filtered for in the filter bar. The filter bar can
0800 be disabled either by pressing &Esc;, or with a &LMB; click on the 
0801 <guiicon>Hide Filter Bar</guiicon> icon.
0802 </para>
0803 
0804 </sect2>
0805 
0806 <sect2 id="finding-searching-in-file">
0807 <title>Finding Files and Searching in Files</title>
0808 <!-- FIXME search in hidden files + folders View -> Show Hidden Files has to be enabled ? -->
0809 <!-- https://bugs.kde.org/show_bug.cgi?id=361557 No clear way to open configuration dialog for Baloo search engine -->
0810 <para>
0811 &dolphin; is capable of searching for files and for content in files. If <keycombo action="simul">
0812 &Ctrl;<keycap>F</keycap></keycombo> is pressed or <menuchoice> <guimenu>Edit</guimenu> 
0813 <guimenuitem>Search...</guimenuitem> </menuchoice> is used, the <guilabel>Search</guilabel>
0814 bar will open already set up to search for files within the current folder and any sub-folders.
0815 Start to type into the find input box and the search starts immediately.
0816 <screenshot>
0817 <screeninfo>Search files and for content in files</screeninfo>
0818 <mediaobject>
0819 <imageobject>
0820 <imagedata fileref="baloo-search.png" format="PNG"/>
0821 </imageobject>
0822 <textobject>
0823 <phrase>Search files and for content in files</phrase>
0824 </textobject>
0825 <caption><para>&dolphin; searching files and for content in files.</para></caption>
0826 </mediaobject>
0827 </screenshot>
0828 </para>
0829 <para>The search is case insensitive, and does not require surrounding wildcards 
0830 (<userinput>*foo*</userinput> and <userinput>foo</userinput> are equivalent), 
0831 but you can use wildcards inside the search term. <userinput>*</userinput> will match 
0832 zero or more characters, <userinput>?</userinput> only one single character.</para>
0833 <para>This feature can be used with running Baloo services; without these services
0834 a KIOSlave is launched to provide the search results.</para>
0835 <para>The option from <guilabel>Everywhere</guilabel> with activated Baloo 
0836 services searches in all indexed folders, without Baloo this option  
0837 starts the search from the user's <replaceable>Home</replaceable> folder.</para>
0838 <screenshot>
0839 <screeninfo>Search with More Options</screeninfo>
0840 <mediaobject>
0841 <imageobject>
0842 <imagedata fileref="baloo-search-more-options.png" format="PNG"/>
0843 </imageobject>
0844 <textobject>
0845 <phrase>Search with More Options</phrase>
0846 </textobject>
0847 <caption><para>&dolphin; searching with More Options.</para></caption>
0848 </mediaobject>
0849 </screenshot>
0850 
0851 <para>
0852 Use the <guilabel>More Options</guilabel> button to extend the <guilabel>Search</guilabel>
0853 bar. This provides a very comfortable way for 
0854 the user to shrink the number of search results.</para>
0855 <para>To start a search select one or more file types (<guilabel>Documents</guilabel>, 
0856 <guilabel>Audio</guilabel>, <guilabel>Video</guilabel>, <guilabel>Images</guilabel>),
0857 a time period, rating, and tag, if you have defined any via
0858 <userinput>tag:<replaceable>foo</replaceable></userinput> in the input box.</para>
0859  
0860  <para>It is possible to clear selection using the <guibutton>Clear Selection</guibutton> button.</para>
0861 
0862 <para>Alternatively you can use these options in the <guilabel>Places</guilabel> panel 
0863 together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit 
0864 the search to files matching the filter expression.</para>
0865 
0866 <para>Use the Save icon to save a search to the <guilabel>Search For</guilabel>
0867 section in the <guilabel>Places</guilabel> panel to quickly access it again in the future.
0868 </para>
0869 
0870 <para>
0871 Use the <guilabel>More Search Tools</guilabel> drop-down list to select other search tools than Baloo.
0872 </para>
0873 </sect2>
0874 
0875 <sect2 id="mounting-storage-media">
0876 <title>Mounting Storage Media</title>
0877 
0878 <para>
0879 A quick way to mount Storage Media is to click on the device in the
0880 <guilabel>Places</guilabel> panel. This will mount and open the device in &dolphin;.
0881 </para>
0882 
0883 </sect2>
0884 
0885 <sect2 id="undo-actions">
0886 <title>Undo Actions</title>
0887 
0888 <para>
0889 &dolphin; is capable of undoing changes you have made to files. For example if
0890 you moved a file to the Trash, &dolphin; can undo this and move it back to its
0891 original location. To undo an action, press <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
0892 or select <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Undo: (action name)</guimenuitem> </menuchoice>
0893 in the menu, &eg; <guimenuitem>Undo: Rename</guimenuitem>.
0894 </para>
0895 
0896 </sect2>
0897 <!-- FIXME https://phabricator.kde.org/D10698-->
0898 <sect2 id="batch-rename">
0899 <title>Renaming A Batch Of Files</title>
0900 <para>
0901 &dolphin; is capable of renaming a number of files at the same time. Each file
0902 will have the file name specified, including a number, &eg;, Image1.jpg,
0903 Image2.jpg, Image3.jpg. This can be useful, &eg;, for pictures taken with a digital camera.
0904 </para>
0905 <!--double click-->
0906 <para>
0907 If you wish to rename a batch of files, first select the files to be renamed.
0908 This can be done by pressing the &LMB; and drawing a rectangle around the files
0909 to be renamed before releasing it, or by holding &Ctrl; and clicking each file
0910 to be renamed (see <link linkend="selection">Selecting Items in the View</link>
0911 for more details on item selection). Then open the batch-rename dialog by pressing
0912 <keycap>F2</keycap> or via the File menu:
0913 <menuchoice> <guimenu>File</guimenu> <guimenuitem>Rename...</guimenuitem> </menuchoice>
0914 </para>
0915 
0916 <para>
0917 Then enter the name you wish to give the files. The # character must be present
0918 within the name. The files will then be renamed, where the <userinput>#</userinput> 
0919 character is replaced by a different consecutive number for each file.
0920 </para>
0921 
0922 <para>If all file extensions in your selection are different, the name of all files 
0923 can be changed without using a <userinput>#</userinput> placeholder while preserving 
0924 the file extensions. This is &eg; useful to rename a video file and all associated 
0925 subtitle files, which have the same filename, but different extensions.
0926 </para>
0927 </sect2>
0928 
0929 <sect2 id="compare-files">
0930 <title>Comparing A Selection Of Files or Folders</title>
0931 
0932 <para>
0933 If the &kompare; application is installed, you can use it to see the differences
0934 between two files or folders.
0935 </para>
0936 
0937 <para>
0938 First select the two files or folders to be compared. Then launch the &kompare; application
0939 via the Tools menu: <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Compare Files</guimenuitem> </menuchoice>.
0940 &kompare; will then open showing the differences between the files or folders.
0941 </para>
0942 
0943 </sect2>
0944 
0945 </sect1>
0946 
0947 </chapter>
0948 
0949 <chapter id="configuring-dolphin">
0950 <title>Configuring &dolphin;</title>
0951 
0952 <para>
0953 &dolphin; distinguishes two different kinds of settings:
0954 
0955 <itemizedlist>
0956 
0957 <listitem><para>
0958 Settings which affect the general behavior of &dolphin;. These can be configured
0959 using the <link linkend="preferences-dialog">Preferences Dialog</link>.
0960 </para></listitem>
0961 
0962 <listitem><para>
0963 Settings which determine how the contents of a folder are displayed in &dolphin;.
0964 These settings are called <link linkend="view-properties">View Display Styles</link>
0965 and can be controlled with toolbar buttons, via the <guimenu>View</guimenu> menu,
0966 and with the <link linkend="view-properties-dialog">View Display Style dialog</link>.
0967 In the default configuration, all folders use the same display style,
0968 but &dolphin; can also be configured to remember each folder's display style separately
0969 in the <link linkend="preferences-dialog-general-behavior"><quote>General</quote>
0970 section of the settings</link>.
0971 </para></listitem>
0972 
0973 </itemizedlist>
0974 
0975 </para>
0976 
0977 <sect1 id="preferences-dialog">
0978 <title>The &dolphin; Preferences Dialog</title>
0979 <para>
0980 The Preferences Dialog is opened via <menuchoice><guimenu>Settings</guimenu>
0981 <guimenuitem>Configure &dolphin;...</guimenuitem></menuchoice> in the menu in
0982 &dolphin;'s main window. The settings are divided into several groups which can
0983 be accessed by clicking the corresponding icon on the left of the dialog.
0984 </para>
0985 
0986 <para>All settings except for the <guilabel>Startup</guilabel> page and the <guilabel>Status Bar</guilabel>
0987 tab on the <guilabel>General</guilabel> page are shared with &konqueror; in filemanager mode.
0988 </para>
0989 
0990 <sect2 id="preferences-dialog-general">
0991 <title>General</title>
0992 
0993 <para>
0994 This group contains settings which control the general behavior of &dolphin;.
0995 The group is divided further into four subgroups which can be accessed using the
0996 tab bar at the top.
0997 
0998 <screenshot>
0999 <screeninfo>Screenshot of the General settings in &dolphin;'s preferences dialog</screeninfo>
1000 <mediaobject>
1001 <imageobject>
1002 <imagedata fileref="preferences-general-behavior.png" format="PNG"/>
1003 </imageobject>
1004 <textobject>
1005 <phrase>General Settings.</phrase>
1006 </textobject>
1007 <caption><para>General Settings in &dolphin;'s Preferences Dialog.</para></caption>
1008 </mediaobject>
1009 </screenshot>
1010 
1011 </para>
1012 
1013 <sect3 id="preferences-dialog-general-behavior">
1014 <title>Behavior Tab</title>
1015 
1016 <para>
1017 
1018 <itemizedlist>
1019 
1020 <listitem><para>
1021 In the <guilabel>View</guilabel> section, you can configure whether the same
1022 <link linkend="view-properties">view display style</link> is shared among all folders
1023 or folders remember their own individual view display styles.
1024 </para></listitem>
1025 
1026 <listitem><para>
1027 <guilabel>Sorting Mode</guilabel> controls how items are sorted in
1028 the view. If <guilabel>Natural sorting</guilabel> is enabled, the sort order of three example files
1029 will be
1030 <orderedlist>
1031 <listitem><para>File1,</para></listitem>
1032 <listitem><para>File2,</para></listitem>
1033 <listitem><para>File10.</para></listitem>
1034 </orderedlist>
1035 If this option is disabled, the normal alphabetical sorting case sensitive or case insensitive
1036 will be used, which leads to the sort order
1037 <orderedlist>
1038 <listitem><para>File1,</para></listitem>
1039 <listitem><para>File10,</para></listitem>
1040 <listitem><para>File2.</para></listitem>
1041 </orderedlist>
1042 </para></listitem>
1043 
1044 <listitem><para>
1045 When hovering over a file or folder with the mouse, a small window with relevant
1046 information is shown if <guilabel>Show tooltips</guilabel> is enabled.
1047 </para></listitem>
1048 
1049 <listitem><para>
1050 <guilabel>Show selection marker</guilabel> shows a small <guibutton>+</guibutton>
1051 or <guibutton>-</guibutton> button above an item's icon if the item is hovered over
1052 with the mouse. These can be used to select or deselect the item.
1053 </para></listitem>
1054 
1055 <listitem><para>
1056 Enable <guilabel>Rename inline</guilabel> to use this mode if only one item is currently selected.
1057 If this option is disabled or several items are selected, a dialog will be displayed for renaming.
1058 </para></listitem>
1059 
1060 <listitem><para>Enabling <guilabel>Switch between split panes with tab key</guilabel>
1061 allows to switch split views with the &Tab; key.
1062 </para></listitem>
1063 
1064 <listitem><para>Disable <guilabel>Turning off split view closes active pane</guilabel>
1065 to close the inactive pane when you are turning off the split view mode, &eg; pressing <keycap>F3</keycap>.
1066 </para></listitem>
1067 
1068 </itemizedlist>
1069 
1070 </para>
1071 
1072 </sect3>
1073 
1074 <sect3 id="preferences-dialog-general-previews">
1075 <title>Previews Tab</title>
1076 
1077 <para>
1078 In this tab, you can configure for which file types previews are shown.
1079 Moreover, the maximum size of local and remote files for which previews are generated can be chosen.
1080 </para>
1081 <para>
1082 If previews are enabled for folders, previews of some files in the folder will
1083 be shown inside a folder's icon.
1084 </para>
1085 </sect3>
1086 
1087 <sect3 id="preferences-dialog-general-confirmations">
1088 <title>Confirmations Tab</title>
1089 <para>
1090 In the ask for confirmation section, you can enable warning dialogs that
1091 are shown before potentially harmful actions.
1092 </para>
1093 <para>
1094 It is also possible to choose the default action <guilabel>When opening an executable file</guilabel>. There are three options, namely <guimenuitem>Always ask</guimenuitem>, <guimenuitem>Open in application</guimenuitem>, and <guimenuitem>Run script</guimenuitem>.
1095 </para>
1096 <warning><para>The confirmation settings for <guilabel>Moving files or folders to trash</guilabel> and
1097 <guilabel>Deleting files or folders</guilabel> affect file operations in &dolphin;, &konqueror;, 
1098 &gwenview; and all &kde; applications using the default &kde; file dialog, 
1099 whereas <guilabel>Closing Dolphin windows
1100 with multiple tabs</guilabel> is a &dolphin; specific setting.</para></warning>
1101 </sect3>
1102 
1103 <sect3 id="preferences-dialog-general-statusbar">
1104 <title>Status Bar Tab</title>
1105 
1106 <para>
1107 In this tab, some additional items can be enabled for the status bar, provided
1108 the status bar is wide enough:
1109 
1110 <itemizedlist>
1111 
1112 <listitem><para>
1113 The <guilabel>Show status bar</guilabel> item can be used for toggling status bar visibility.
1114 </para></listitem>
1115 
1116 <listitem><para>
1117 The <guilabel>Show zoom slider</guilabel> item allows switching visibility of the icon size widget.
1118 </para></listitem>
1119 
1120 <listitem><para>
1121 The <guilabel>Show space information</guilabel> item can be used to switch on and off a bar that shows how much space is free on the current drive.
1122 </para></listitem>
1123 
1124 </itemizedlist>
1125 
1126 </para>
1127 
1128 </sect3>
1129 
1130 </sect2>
1131 
1132 <sect2 id="preferences-dialog-startup">
1133 <title>Startup</title>
1134 
1135 <para>
1136 This group contains settings which control the appearance of &dolphin; on startup.
1137 
1138 <screenshot>
1139 <screeninfo>Screenshot of the Startup settings in &dolphin;'s preferences dialog</screeninfo>
1140 <mediaobject>
1141 <imageobject>
1142 <imagedata fileref="preferences-startup.png" format="PNG"/>
1143 </imageobject>
1144 <textobject>
1145 <phrase>Startup Settings.</phrase>
1146 </textobject>
1147 <caption><para>Startup Settings in &dolphin;'s Preferences Dialog.</para></caption>
1148 </mediaobject>
1149 </screenshot>
1150 
1151 <itemizedlist>
1152 
1153 <listitem><para>
1154 The <guilabel>Show on startup</guilabel> option allows choosing the folder which is opened on startup.
1155 </para>
1156 <para>
1157     If the <guimenuitem>Folders, tabs, and window state from last time</guimenuitem> item is selected then
1158 </para>
1159 <itemizedlist>
1160     <listitem>
1161         <para>When launched from the &GUI; or CLI without any &URL;s, &dolphin; restores session</para>
1162     </listitem>
1163     <listitem>
1164         <para>When rebooting with &dolphin; open, it restores session normally after the system comes back</para>
1165     </listitem>
1166     <listitem>
1167         <para>When launched with &URL;s, &dolphin; window is opened showing those &URL;s instead of restoring session</para>
1168     </listitem>
1169     <listitem>
1170         <para>When &dolphin; is already running and a new window is opened, that new window shows a single tab with the same &URL; as was visible in the previously-open &dolphin; instance</para>
1171     </listitem>
1172 </itemizedlist>
1173 <para>
1174 The location of the folder can also be entered directly or chosen in a dialog which can
1175 be opened by clicking the button showing a <quote>folder</quote> icon. Moreover,
1176 the current location or the default location (which is the user's home folder)
1177 can be used as the startup folder by clicking the corresponding button.
1178 </para></listitem>
1179 
1180 <listitem><para>
1181 <guilabel>Begin in split view mode</guilabel> controls if the
1182 <link linkend="dolphin-view">&dolphin; view</link> is split on startup
1183 or not for new windows.
1184 </para></listitem>
1185 
1186 <listitem><para>
1187 <guilabel>Show filter bar</guilabel> controls if the filter bar is shown on
1188 startup or not. See the <link linkend="filter-files">section on the filter bar</link>
1189 for details.
1190 </para></listitem>
1191 
1192 <listitem><para>
1193 <guilabel>Make location bar editable</guilabel> controls if the location bar is in
1194 editable mode on startup. The bread crumb mode of the location bar is used
1195 otherwise. See the <link linkend="location-bar">section about the location bar</link>
1196 for details about the two modes.
1197 </para></listitem>
1198 
1199 <listitem><para>
1200 <guilabel>Open new folders in tabs</guilabel> controls whether &dolphin; should open a new folder in a new tab of the current instance when called externally. If not enabled, the new folders will be opened in new instances of &dolphin;. By default this option is enabled.
1201 </para></listitem>
1202 
1203 <listitem><para>
1204 If <guilabel>Show full path inside location bar</guilabel> is enabled, the full
1205 path of the current location is shown in the bread crumb mode of the location bar.
1206 Otherwise, a shortened version of the path is shown if it begins with the path of
1207 one of the places in the <guilabel>Places</guilabel> panel.
1208 </para></listitem>
1209 
1210 <listitem><para>
1211 <guilabel>Show full path in title bar</guilabel> makes it easy to distinguish
1212 between files or folders with the same name in different folders.
1213 </para></listitem>
1214 
1215 </itemizedlist>
1216 
1217 </para>
1218 
1219 </sect2>
1220 
1221 <sect2 id="preferences-dialog-viewmodes">
1222 <title>View Modes</title>
1223 
1224 <para>
1225 This group contains settings which control the behavior of &dolphin;'s view
1226 modes. The three view modes (Icons, Compact, and Details) are accessible via the
1227 tab bar at the top.
1228 
1229 <screenshot>
1230 <screeninfo>Screenshot of the Icons View settings in &dolphin;'s preferences dialog</screeninfo>
1231 <mediaobject>
1232 <imageobject>
1233 <imagedata fileref="preferences-viewmodes-icons.png" format="PNG"/>
1234 </imageobject>
1235 <textobject>
1236 <phrase>View Modes Settings.</phrase>
1237 </textobject>
1238 <caption><para>View Modes Settings in &dolphin;'s Preferences Dialog.</para></caption>
1239 </mediaobject>
1240 </screenshot>
1241 
1242 </para>
1243 
1244 <sect3 id="preferences-dialog-viewmodes-common">
1245 <title>Common settings for all view modes</title>
1246 
1247 <para>
1248 All three view modes have some common settings:
1249 </para>
1250 <itemizedlist>
1251 
1252 <listitem><para>
1253 Sliders which control the size of the icons. The <guilabel>Default</guilabel> or
1254 <guilabel>Preview</guilabel> sizes are used if previews are disabled or enabled,
1255 respectively. Note that the icon size can be changed easily with the zoom slider
1256 in the status bar if the corresponding option is enabled in the
1257 <link linkend="preferences-dialog-general-statusbar"><quote>General</quote>
1258 section of the settings</link>.
1259 </para></listitem>
1260 
1261 <listitem><para>
1262 A setting for the font used in the view mode: either the system font or a
1263 custom font can be chosen.
1264 </para></listitem>
1265 
1266 </itemizedlist>
1267 <para>
1268 The other settings in the <guilabel>Text</guilabel> section which apply to only 
1269 one of the view modes are discussed below.
1270 </para>
1271 
1272 </sect3>
1273 
1274 <sect3 id="preferences-dialog-viewmodes-icons">
1275 <title>Icons</title>
1276 <para>
1277 <itemizedlist>
1278 <listitem><para>
1279 <guilabel>Width</guilabel> controls the minimum width that is reserved for
1280 the text of a file item.
1281 </para></listitem>
1282 <listitem><para>
1283   <guilabel>Maximum lines</guilabel> means maximum number of text lines below the icon.
1284 </para></listitem>
1285 </itemizedlist>
1286 </para>
1287 </sect3>
1288 
1289 <sect3 id="preferences-dialog-viewmodes-compact">
1290 <title>Compact</title>
1291 <para>
1292 <itemizedlist>
1293 <listitem><para>
1294 <guilabel>Maximum width</guilabel> controls the maximum width that is reserved for
1295 the text of a file item.
1296 </para></listitem>
1297 </itemizedlist>
1298 </para>
1299 </sect3>
1300 
1301 <sect3 id="preferences-dialog-viewmodes-details">
1302 <title>Details</title>
1303 <para>
1304 <itemizedlist>
1305 <listitem><para>
1306 <guilabel>Expandable folders</guilabel> determines whether any folders that have subfolders
1307 are displayed in a tree view, where the sub items can be expanded by &LMB; clicking the
1308 <guiicon>&gt;</guiicon> icon and collapsed by clicking the <guiicon>v</guiicon> icon.
1309 </para>
1310 <para>
1311 <guilabel>Folder size displays</guilabel> allows defining the property to use then sorting folders by their size. It is possible to sort folders by <guilabel>Number of items</guilabel> or <guilabel>Size of contents</guilabel> and choose a limit to the recursive level (can be useful to constrain unneeded iterations in the deep folder structures or on the slow file systems).
1312 </para>
1313 <para>
1314 The <guilabel>Date style</guilabel> option can be used to configure the mode to display dates in &dolphin;. It is possible to choose between <guilabel>Relative</guilabel> (&eg;, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (&eg;, <quote>2020-12-23 15:00</quote>).
1315 </para>
1316 </listitem>
1317 </itemizedlist>
1318 </para>
1319 </sect3>
1320 
1321 </sect2>
1322 
1323 <sect2 id="preferences-dialog-navigation">
1324 <title>Navigation</title>
1325 
1326 <para>
1327 This group contains settings which control how navigation in the folder
1328 structure and in archives works.
1329 
1330 <screenshot>
1331 <screeninfo>Screenshot of the Navigation settings in &dolphin;'s preferences dialog</screeninfo>
1332 <mediaobject>
1333 <imageobject>
1334 <imagedata fileref="preferences-navigation.png" format="PNG"/>
1335 </imageobject>
1336 <textobject>
1337 <phrase>Navigation Settings.</phrase>
1338 </textobject>
1339 <caption><para>Navigation Settings in &dolphin;'s Preferences Dialog.</para></caption>
1340 </mediaobject>
1341 </screenshot>
1342 
1343 <itemizedlist>
1344 
1345 <listitem><para>
1346 The option to open items with a single or double mouse click is a system wide setting and can be
1347 changed in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
1348 <guimenuitem>General Behavior</guimenuitem></menuchoice> module.</para>
1349 </listitem>
1350 
1351 <listitem><para>
1352 Archives will be opened inside &dolphin;, and not in an external application, if
1353 <guilabel>Open Archives as folder</guilabel> is enabled.
1354 </para></listitem>
1355 
1356 <listitem><para>
1357 If <guilabel>Open folders during drag operations</guilabel> is enabled, dragging
1358 an item with the mouse and hovering over a folder with it for a short time will open
1359 that folder. This allows you to move or copy items quickly to folders which are
1360 several levels deeper in the folder hierarchy.
1361 </para></listitem>
1362 
1363 </itemizedlist>
1364 
1365 </para>
1366 
1367 </sect2>
1368 
1369 <sect2 id="preferences-dialog-context-menu">
1370 <title>Services</title>
1371 
1372 <para>
1373 This group offers a selection of services that can be shown in the
1374 <guisubmenu>Actions</guisubmenu> submenu of &dolphin;'s context menu which
1375 appears when clicking a file or folder with the &RMB;.
1376 </para>
1377 
1378 <screenshot>
1379 <screeninfo>Screenshot of the Services Menu settings in &dolphin;'s preferences dialog</screeninfo>
1380 <mediaobject>
1381 <imageobject>
1382 <imagedata fileref="preferences-context-menu.png" format="PNG"/>
1383 </imageobject>
1384 <textobject>
1385 <phrase>Services Settings.</phrase>
1386 </textobject>
1387 <caption><para>Services Settings in &dolphin;'s Preferences Dialog.</para></caption>
1388 </mediaobject>
1389 </screenshot>
1390 
1391 <para>
1392 Using the <guibutton>Download New Services</guibutton> you can fetch additional 
1393 services for the context menu.
1394 </para>
1395 <para>
1396 If you have installed &dolphin;'s plugins for <guilabel>Bazaar</guilabel>, 
1397 <guilabel>Mercurial</guilabel>, <guilabel>Git</guilabel> or 
1398 <guilabel>Subversion</guilabel> from the kdesdk module these services are shown in the list.
1399 If these plugins are enabled and you enter a folder which is under version control, 
1400 the version state (locally changed, up to date &etc;) is indicated by icons 
1401 and you have additional entries in the 
1402 context menu like commit, update, add, remove &etc;
1403 </para>
1404 <para>
1405 In the service list you can also choose if the <guimenuitem>Copy To</guimenuitem>,
1406 <guimenuitem>Move To</guimenuitem>, <guimenuitem>Add to Places</guimenuitem>,
1407 <guimenuitem>Sort By</guimenuitem>, <guimenuitem>View Mode</guimenuitem>,
1408 <guimenuitem>Open in New Tab</guimenuitem>, <guimenuitem>Open in New Window</guimenuitem>,
1409 <guimenuitem>Copy Location</guimenuitem>, and <guimenuitem>Duplicate Here</guimenuitem>
1410 commands are shown in the context menu.
1411 </para>
1412 <para>
1413 &dolphin; has to be restarted to activate the changes for some of these settings.
1414 </para>
1415 
1416 </sect2>
1417 
1418 <sect2 id="preferences-dialog-trash">
1419 <title>Trash</title>
1420 
1421 <para>
1422 This group contains settings which control the behavior of the trash.
1423 
1424 <screenshot>
1425 <screeninfo>Screenshot of the Trash settings in &dolphin;'s preferences dialog</screeninfo>
1426 <mediaobject>
1427 <imageobject>
1428 <imagedata fileref="preferences-trash.png" format="PNG"/>
1429 </imageobject>
1430 <textobject>
1431 <phrase>Trash Settings.</phrase>
1432 </textobject>
1433 <caption><para>Trash Settings in &dolphin;'s Preferences Dialog.</para></caption>
1434 </mediaobject>
1435 </screenshot>
1436 
1437 <itemizedlist>
1438 
1439 <listitem><para>
1440 Files which are older than a configurable number of days can be deleted automatically.
1441 </para></listitem>
1442 
1443 <listitem><para>
1444 The size of the trash can be limited to a configurable percentage of the disk
1445 size. If this limit is reached, a warning can be issued, or the oldest or
1446 largest files can be deleted automatically.
1447 </para></listitem>
1448 
1449 </itemizedlist>
1450 
1451 </para>
1452 
1453 </sect2>
1454 
1455 <sect2 id="preferences-user-feedback">
1456 <title>User Feedback</title>
1457 
1458 <para>
1459 This group contains settings which control your contributing information on the &dolphin; usage to its developers.
1460 
1461 <screenshot>
1462 <screeninfo>Screenshot of the User Feedback settings in &dolphin;'s preferences dialog</screeninfo>
1463 <mediaobject>
1464 <imageobject>
1465 <imagedata fileref="preferences-user-feedback.png" format="PNG"/>
1466 </imageobject>
1467 <textobject>
1468 <phrase>User Feedback Settings.</phrase>
1469 </textobject>
1470 <caption><para>User Feedback Settings in &dolphin;'s Preferences Dialog.</para></caption>
1471 </mediaobject>
1472 </screenshot>
1473 
1474 <itemizedlist>
1475 
1476 <listitem><para>
1477 You can contribute some feedback on &dolphin; if you wish. Use sliders to configure your level of participation.
1478 </para></listitem>
1479 
1480 </itemizedlist>
1481 
1482 </para>
1483 
1484 </sect2>
1485 
1486 </sect1>
1487 <!-- begin copy to konqueror filemanager.docbook -->
1488 <sect1 id="view-properties">
1489 <title>Folder View Display Style</title>
1490 
1491 <para>
1492 The following settings control how the contents of a folder are displayed in the
1493 &dolphin; view, and are stored on a per-folder basis by default:
1494 </para>
1495 <itemizedlist>
1496 
1497 <listitem><para>
1498 The view mode (Icons, Compact, Details)
1499 </para></listitem>
1500 
1501 <listitem><para>
1502 The sorting of items, which is determined by the sort order (ascending,
1503 descending) and the attribute (such as name, size,...) that the items are
1504 sorted by
1505 </para></listitem>
1506 
1507 <listitem><para>
1508 Sorting of folders and files &ndash; are folders shown first or not?
1509 </para></listitem>
1510 
1511 <listitem><para>
1512 Previews &ndash; are they shown instead of icons (based on the settings made in
1513 <link linkend="preferences-dialog-general-previews"><guilabel>Previews</guilabel>
1514 tab of &dolphin;'s General settings</link>) or not?
1515 </para></listitem>
1516 
1517 <listitem><para>
1518 Are items shown in groups in the views?
1519 </para></listitem>
1520 
1521 <listitem><para>
1522 Are hidden files shown?
1523 </para></listitem>
1524 
1525 <listitem><para>
1526 What additional information (besides the name) is shown in the Icons or Details view?
1527 </para></listitem>
1528 
1529 </itemizedlist>
1530 <para>
1531 The view display style can be configured in the
1532 <menuchoice><guimenu>View</guimenu></menuchoice> menu, some (such as the view
1533 mode) can also be changed using toolbar buttons.
1534 </para>
1535 
1536 <sect2 id="view-properties-dialog">
1537 <title>The View Display Style dialog</title>
1538 
1539 <para>
1540 
1541 <screenshot>
1542 <screeninfo>Screenshot of the View Display Style dialog</screeninfo>
1543 <mediaobject>
1544 <imageobject>
1545 <imagedata fileref="viewproperties-dialog.png" format="PNG"/>
1546 </imageobject>
1547 <textobject>
1548 <phrase>The View Display Style dialog.</phrase>
1549 </textobject>
1550 <caption><para>The View Display Style Dialog.</para></caption>
1551 </mediaobject>
1552 </screenshot>
1553 
1554 The <guilabel>View Display Style</guilabel> dialog can be used to quickly modify
1555 the view display styles for many folders at once. This is done for the current folder, for the
1556 current folder including all subfolders, or even for all folders, depending on
1557 the choice made in the <guilabel>Apply to</guilabel> section.
1558 </para>
1559 
1560 <para>
1561 If <guilabel>Use as default view settings</guilabel> is enabled, the chosen view
1562 properties will also be used for all folders which do not have customized view
1563 properties yet.
1564 </para>
1565 
1566 </sect2>
1567 
1568 </sect1>
1569 <!-- end copy to konqueror filemanager.docbook -->
1570 </chapter>
1571 
1572 <chapter id="command-reference">
1573 <title>Command Reference</title>
1574 <para>By default the menubar is not shown. All actions described here either can 
1575 be accessed with toolbar buttons or with items in the menu of the 
1576 <guibutton>Control</guibutton> toolbar button.</para>
1577 
1578 <sect1 id="commands-menubar">
1579 <title>The Menubar in &dolphin;'s Main Window</title>
1580 
1581 <sect2>
1582 <title>The File Menu</title>
1583 <para>
1584 <variablelist>
1585 
1586 <varlistentry>
1587 <term><menuchoice>
1588 <guimenu>File</guimenu>
1589 <guisubmenu>Create New</guisubmenu>
1590 </menuchoice></term>
1591 <listitem><para><action>Creates a new object (such as a folder or a text file) in the current
1592 folder.</action></para>
1593 <para>You will find an explanation of all available objects in &konqueror;'s handbook in the chapter
1594 <ulink url="help:/konqueror/making.html">Create New</ulink>.</para>
1595 <note>
1596     <para>
1597         It is possible to create your own <guisubmenu>Create New...</guisubmenu> submenu items. Use files from <ulink url="https://invent.kde.org/frameworks/kio/-/tree/master/src/new_file_templates">KIO source repository</ulink> as a reference and put the resulting <filename role="extension">.desktop</filename> file into the <filename role="directory">.local/share/templates</filename> in your home directory (the address can be determined using the <userinput>kf5-config --path templates</userinput> command in &konsole;), then restart &dolphin;.
1598     </para>
1599 </note>
1600 </listitem>
1601 </varlistentry>
1602 
1603 <varlistentry>
1604 <term><menuchoice>
1605 <shortcut>
1606 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
1607 </shortcut>
1608 <guimenu>File</guimenu>
1609 <guimenuitem>New Window</guimenuitem>
1610 </menuchoice></term>
1611 <listitem><para><action>Opens a new &dolphin; window.</action></para></listitem>
1612 </varlistentry>
1613 
1614 <varlistentry>
1615 <term><menuchoice>
1616 <shortcut>
1617 <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
1618 </shortcut>
1619 <guimenu>File</guimenu>
1620 <guimenuitem>New Tab</guimenuitem>
1621 </menuchoice></term>
1622 <listitem><para><action>Opens a new tab.</action></para></listitem>
1623 </varlistentry>
1624 
1625 <varlistentry>
1626 <term><menuchoice>
1627 <shortcut>
1628 <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
1629 </shortcut>
1630 <guimenu>File</guimenu>
1631 <guimenuitem>Close Tab</guimenuitem>
1632 </menuchoice></term>
1633 <listitem><para><action>Closes the current tab.</action></para></listitem>
1634 </varlistentry>
1635 
1636 <varlistentry>
1637 <term><menuchoice>
1638 <shortcut>
1639 <keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo>
1640 </shortcut>
1641 <guimenu>File</guimenu>
1642 <guimenuitem>Undo close tab</guimenuitem>
1643 </menuchoice></term>
1644 <listitem><para><action>Reopens the last closed tab.</action></para></listitem>
1645 </varlistentry>
1646 
1647 <varlistentry>
1648 <term><menuchoice>
1649 <shortcut>
1650 <keycombo action="simul"><keycap>F2</keycap></keycombo>
1651 </shortcut>
1652 <guimenu>File</guimenu>
1653 <guimenuitem>Rename</guimenuitem>
1654 </menuchoice></term>
1655 <listitem><para><action>Renames one currently selected item inline.
1656 Opens the <link linkend="batch-rename">batch rename dialog</link> if several 
1657 items are selected.</action></para></listitem>
1658 </varlistentry>
1659 
1660 <varlistentry>
1661 <term><menuchoice>
1662 <shortcut>
1663 <keycombo action="simul"><keycap>Del</keycap></keycombo>
1664 </shortcut>
1665 <guimenu>File</guimenu>
1666 <guimenuitem>Move to Trash</guimenuitem>
1667 </menuchoice></term>
1668 <listitem><para><action>Moves the currently selected item(s) to the
1669 trash.</action></para></listitem>
1670 </varlistentry>
1671 
1672 <varlistentry>
1673 <term><menuchoice>
1674 <shortcut>
1675 <keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
1676 </shortcut>
1677 <guimenu>File</guimenu>
1678 <guimenuitem>Delete</guimenuitem>
1679 </menuchoice></term>
1680 <listitem><para><action>Permanently deletes the currently selected item(s). The items are not moved
1681 to the trash and cannot be restored.</action></para></listitem>
1682 </varlistentry>
1683 
1684 <varlistentry>
1685 <term><menuchoice>
1686 <guimenu>File</guimenu>
1687 <guimenuitem>Show Target</guimenuitem>
1688 </menuchoice></term>
1689 <listitem><para>This action highlights a link target in a new &dolphin; window.
1690 </para></listitem>
1691 </varlistentry>
1692 
1693 <varlistentry>
1694 <term><menuchoice>
1695 <shortcut>
1696 <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
1697 </shortcut>
1698 <guimenu>File</guimenu>
1699 <guimenuitem>Duplicate Here</guimenuitem>
1700 </menuchoice></term>
1701 <listitem><para><action>Creates duplicates of selected items appending <replaceable> copy</replaceable> to the end of their names.</action></para></listitem>
1702 </varlistentry>
1703 
1704 <varlistentry>
1705 <term><menuchoice>
1706 <shortcut>
1707 <keycombo action="simul">&Alt;<keycap>Return</keycap></keycombo>
1708 </shortcut>
1709 <guimenu>File</guimenu>
1710 <guimenuitem>Properties</guimenuitem>
1711 </menuchoice></term>
1712 <listitem><para><action>Shows the properties dialog for the currently selected
1713 item(s).</action></para></listitem>
1714 </varlistentry>
1715 <!--FIXME http://www.aelog.org/checksums-made-easy in fundamentals? -->
1716 <varlistentry>
1717 <term><menuchoice>
1718 <shortcut>
1719 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
1720 </shortcut>
1721 <guimenu>File</guimenu>
1722 <guimenuitem>Quit</guimenuitem>
1723 </menuchoice></term>
1724 <listitem><para><action>Exits &dolphin;.</action></para></listitem>
1725 </varlistentry>
1726 </variablelist>
1727 
1728 </para>
1729 </sect2>
1730 
1731 <sect2>
1732 <title>The Edit Menu</title>
1733 <para>
1734 
1735 <variablelist>
1736 <varlistentry>
1737 <term><menuchoice>
1738 <shortcut>
1739 <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
1740 </shortcut>
1741 <guimenu>Edit</guimenu>
1742 <guimenuitem>Undo</guimenuitem>
1743 </menuchoice></term>
1744 <listitem><para><action>Undoes the last action performed by &dolphin;.</action></para></listitem>
1745 </varlistentry>
1746 
1747 <varlistentry>
1748 <term><menuchoice>
1749 <shortcut>
1750 <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
1751 </shortcut>
1752 <guimenu>Edit</guimenu>
1753 <guimenuitem>Cut</guimenuitem>
1754 </menuchoice></term>
1755 <listitem><para><action>Cuts the currently selected item(s).</action></para></listitem>
1756 </varlistentry>
1757 
1758 <varlistentry>
1759 <term><menuchoice>
1760 <shortcut>
1761 <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
1762 </shortcut>
1763 <guimenu>Edit</guimenu>
1764 <guimenuitem>Copy</guimenuitem>
1765 </menuchoice></term>
1766 <listitem><para><action>Copies the currently selected item(s).</action></para></listitem>
1767 </varlistentry>
1768 
1769 <varlistentry>
1770 <term><menuchoice>
1771 <shortcut>
1772 <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
1773 </shortcut>
1774 <guimenu>Edit</guimenu>
1775 <guimenuitem>Paste Clipboard Contents...</guimenuitem></menuchoice> or
1776 <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one File</guimenuitem></menuchoice> or
1777 <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one Folder</guimenuitem></menuchoice> or
1778 <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste x Items</guimenuitem>
1779 </menuchoice></term>
1780 <listitem><para><action>Pastes the currently copied/cut items to the current
1781 folder. If the clipboard does not contain files or folders, the clipboard
1782 contents (such as text or image data) will be pasted into a new file.
1783 The name of this file has to be entered in a dialog.
1784 </action></para></listitem>
1785 </varlistentry>
1786 
1787 <varlistentry>
1788 <term><menuchoice>
1789 <shortcut>
1790 <keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
1791 </shortcut>
1792 <guimenu>Edit</guimenu>
1793 <guimenuitem>Copy to inactive split view</guimenuitem>
1794 </menuchoice></term>
1795 <listitem><para><action>Copies the currently selected item(s) from the active split view to the inactive split view.</action></para></listitem>
1796 </varlistentry>
1797 
1798 <varlistentry>
1799 <term><menuchoice>
1800 <shortcut>
1801 <keycombo action="simul">&Ctrl;<keycap>F6</keycap></keycombo>
1802 </shortcut>
1803 <guimenu>Edit</guimenu>
1804 <guimenuitem>Move to inactive split view</guimenuitem>
1805 </menuchoice></term>
1806 <listitem><para><action>Moves the currently selected item(s) from the active split view to the inactive split view.
1807 Is disabled if the current user does not have write permission on the selected item(s).</action></para></listitem>
1808 </varlistentry>
1809 
1810 <varlistentry>
1811 <term><menuchoice>
1812 <shortcut>
1813 <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
1814 </shortcut>
1815 <guimenu>Edit</guimenu>
1816 <guimenuitem>Filter...</guimenuitem>
1817 </menuchoice></term>
1818 <listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action>
1819 You can also use the alternate shortcut <keycombo action="simul">&Shift;<keycap>/</keycap></keycombo>
1820 for this action.</para></listitem>
1821 </varlistentry>
1822 
1823 <varlistentry>
1824 <term><menuchoice>
1825 <shortcut>
1826 <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
1827 </shortcut>
1828 <guimenu>Edit</guimenu>
1829 <guimenuitem>Search...</guimenuitem>
1830 </menuchoice></term>
1831 <listitem><para><action>Opens the find bar. Enter a search term into the edit box and select to search for filename
1832 or in contents of files starting from the current folder or everywhere.</action></para></listitem>
1833 </varlistentry>
1834 
1835 <varlistentry>
1836 <term><menuchoice>
1837 <shortcut>
1838 <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
1839 </shortcut>
1840 <guimenu>Edit</guimenu>
1841 <guimenuitem>Select All</guimenuitem>
1842 </menuchoice></term>
1843 <listitem><para><action>Selects all files and folders in the current
1844 folder.</action></para></listitem>
1845 </varlistentry>
1846 
1847 <varlistentry>
1848 <term><menuchoice>
1849 <shortcut>
1850 <keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>
1851 </shortcut>
1852 <guimenu>Edit</guimenu>
1853 <guimenuitem>Invert Selection</guimenuitem>
1854 </menuchoice></term>
1855 <listitem><para><action>
1856 Selects all unselected items and deselects all selected items in the current folder.
1857 </action></para></listitem>
1858 </varlistentry>
1859 </variablelist>
1860 </para>
1861 </sect2>
1862 
1863 <sect2>
1864 <title>The View Menu</title>
1865 <para>
1866 
1867 <variablelist>
1868 <varlistentry>
1869 <term><menuchoice>
1870 <shortcut>
1871 <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
1872 </shortcut>
1873 <guimenu>View</guimenu>
1874 <guimenuitem>Zoom In</guimenuitem>
1875 </menuchoice></term>
1876 <listitem><para><action>Increases the size of icons in the view.</action></para></listitem>
1877 </varlistentry>
1878 
1879 <varlistentry>
1880 <term><menuchoice>
1881 <shortcut>
1882 <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
1883 </shortcut>
1884 <guimenu>View</guimenu>
1885 <guimenuitem>Zoom Out</guimenuitem>
1886 </menuchoice></term>
1887 <listitem><para><action>Decreases the size of icons in the view.</action></para></listitem>
1888 </varlistentry>
1889 
1890 <varlistentry>
1891 <term><menuchoice>
1892 <shortcut>
1893 <keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo>
1894 </shortcut>
1895 <guimenu>View</guimenu>
1896 <guimenuitem>Zoom Reset</guimenuitem>
1897 </menuchoice></term>
1898 <listitem><para><action>Resets the size of icons in the view to default.</action></para></listitem>
1899 </varlistentry>
1900 
1901 <varlistentry>
1902 <term><menuchoice>
1903 <guimenu>View</guimenu>
1904 <guisubmenu>View Mode</guisubmenu>
1905 </menuchoice></term>
1906 <listitem><para><action>Changes the view mode to <guimenuitem>Icons</guimenuitem>
1907 (<keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo>), <guimenuitem>Compact</guimenuitem>
1908 (<keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo>) or <guimenuitem>Details</guimenuitem>
1909 (<keycombo action="simul">&Ctrl;<keycap>3</keycap></keycombo>).</action></para></listitem>
1910 </varlistentry>
1911 
1912 <varlistentry>
1913 <term><menuchoice>
1914 <guimenu>View</guimenu>
1915 <guisubmenu>Sort By</guisubmenu>
1916 </menuchoice></term>
1917 <listitem><para><action>Changes whether items are sorted</action> by <guimenuitem>Name</guimenuitem>
1918 or other criteria described in <link linkend="dolphin-view-information">Information in the View</link>.</para>
1919 <para><guimenuitem>Descending</guimenuitem> reverses the sort order.
1920 <guimenuitem>Folders First</guimenuitem> sorts folders before files.
1921 </para></listitem>
1922 </varlistentry>
1923 
1924 <varlistentry>
1925 <term><menuchoice>
1926 <guimenu>View</guimenu>
1927 <guisubmenu>Show Additional Information</guisubmenu>
1928 </menuchoice></term>
1929 <listitem><para><action>Displays additional information</action> 
1930 described in <link linkend="dolphin-view-information">Information in the View</link>.
1931 </para></listitem>
1932 </varlistentry>
1933 
1934 <varlistentry>
1935 <term><menuchoice>
1936 <guimenu>View</guimenu>
1937 <guimenuitem>Show Previews</guimenuitem>
1938 </menuchoice></term>
1939 <listitem><para><action>Displays a symbolic preview of the file contents </action> in the different
1940 view modes.</para></listitem>
1941 </varlistentry>
1942 
1943 <varlistentry>
1944 <term><menuchoice>
1945 <guimenu>View</guimenu>
1946 <guimenuitem>Show in Groups</guimenuitem>
1947 </menuchoice></term>
1948 <listitem><para><action>Displays</action> the content of the
1949 current folder grouped by the option selected in <guimenuitem>Sort By</guimenuitem>.
1950 </para></listitem>
1951 </varlistentry>
1952 
1953 <varlistentry>
1954 <term><menuchoice>
1955 <shortcut>
1956 <keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
1957 </shortcut>
1958 <guimenu>View</guimenu>
1959 <guimenuitem>Show Hidden Files</guimenuitem>
1960 </menuchoice></term>
1961 <listitem><para><action>Shows all the hidden files and sub-folders within the current
1962 folder.</action>There is an alternate shortcut <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
1963 for this action.</para></listitem>
1964 </varlistentry>
1965 
1966 <varlistentry>
1967 <term><menuchoice>
1968 <shortcut>
1969 <keycombo action="simul"><keycap>F3</keycap></keycombo>
1970 </shortcut>
1971 <guimenu>View</guimenu>
1972 <guimenuitem>Split</guimenuitem>
1973 </menuchoice></term>
1974 <listitem><para><action>Enables and disables the split view mode.</action></para></listitem>
1975 </varlistentry>
1976 
1977 <varlistentry>
1978 <term><menuchoice>
1979 <shortcut>
1980 <keycombo action="simul"><keycap>F5</keycap></keycombo>
1981 </shortcut>
1982 <guimenu>View</guimenu>
1983 <guimenuitem>Reload</guimenuitem>
1984 </menuchoice></term>
1985 <listitem><para><action>Reloads the current folder.</action></para></listitem>
1986 </varlistentry>
1987 
1988 <varlistentry>
1989 <term><menuchoice>
1990 <guimenu>View</guimenu>
1991 <guimenuitem>Stop</guimenuitem>
1992 </menuchoice></term>
1993 <listitem><para><action>Stops loading/reading the contents of the current
1994 folder.</action></para></listitem>
1995 </varlistentry>
1996 
1997 <varlistentry>
1998 <term><menuchoice>
1999 <guimenu>View</guimenu>
2000 <guisubmenu>Show Panels</guisubmenu>
2001 </menuchoice></term>
2002 <listitem><para><action>Enables and disables</action> the different <link linkend="panels">panels</link>:
2003 <guimenuitem>Places</guimenuitem> (<keycap>F9</keycap>), <guimenuitem>Information</guimenuitem>
2004 (<keycap>F11</keycap>), <guimenuitem>Folders</guimenuitem> (<keycap>F7</keycap>), 
2005 <guimenuitem>Terminal</guimenuitem> (<keycap>F4</keycap>).
2006 With <guimenuitem>Lock Panels</guimenuitem> the panel header with caption and two buttons is  
2007 hidden to save space and the panels are immutable, with <guimenuitem>Unlock Panels</guimenuitem>
2008 the header is visible and the panel can be moved to the right or left  or even
2009 outside the main window.
2010 <!-- FIXME Places header always visible ?-->
2011 </para></listitem>
2012 </varlistentry>
2013 
2014 <varlistentry>
2015 <term><menuchoice>
2016 <shortcut>
2017 <keycap>F6</keycap>
2018 </shortcut>
2019 <guimenu>View</guimenu>
2020 <guisubmenu>Location Bar</guisubmenu>
2021 <guimenuitem>Editable Location</guimenuitem>
2022 </menuchoice></term>
2023 <listitem><para><action>Changes the location bar between the two modes; the
2024 <link linkend="location-bar-bread-crumb">bread crumb mode</link> and the
2025 <link linkend="location-bar-editable">editable mode</link>.
2026 </action></para></listitem>
2027 </varlistentry>
2028 
2029 <varlistentry>
2030 <term><menuchoice>
2031 <shortcut>
2032 <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
2033 </shortcut>
2034 <guimenu>View</guimenu>
2035 <guisubmenu>Location Bar</guisubmenu>
2036 <guimenuitem>Replace Location</guimenuitem>
2037 </menuchoice></term>
2038 <listitem><para><action>Switches the location bar to <link linkend="location-bar-editable">editable mode</link>,
2039 if necessary, and selects the location such that it can be replaced quickly.
2040 </action></para></listitem>
2041 </varlistentry>
2042 
2043 <varlistentry>
2044 <term><menuchoice>
2045 <guimenu>View</guimenu>
2046 <guimenuitem>Adjust View Display Style...</guimenuitem>
2047 </menuchoice></term>
2048 <listitem><para><action>Opens the <link linkend="view-properties-dialog">View Display Style
2049 Dialog</link>.</action></para></listitem>
2050 </varlistentry>
2051 </variablelist>
2052 
2053 </para>
2054 </sect2>
2055 
2056 <sect2>
2057 <title>The Go Menu</title>
2058 <para>
2059 
2060 <variablelist>
2061 <varlistentry>
2062 <term><menuchoice>
2063 <shortcut>
2064 <keycombo action="simul">&Alt;<keycap>Up</keycap></keycombo>
2065 </shortcut>
2066 <guimenu>Go</guimenu>
2067 <guimenuitem>Up</guimenuitem>
2068 </menuchoice></term>
2069 <listitem><para><action>Changes to the folder above the current folder.</action></para></listitem>
2070 </varlistentry>
2071 
2072 <varlistentry>
2073 <term><menuchoice>
2074 <shortcut>
2075 <keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo>
2076 </shortcut>
2077 <guimenu>Go</guimenu>
2078 <guimenuitem>Back</guimenuitem>
2079 </menuchoice></term>
2080 <listitem><para><action>Changes to the previously viewed folder.</action></para></listitem>
2081 </varlistentry>
2082 
2083 <varlistentry>
2084 <term><menuchoice>
2085 <shortcut>
2086 <keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo>
2087 </shortcut>
2088 <guimenu>Go</guimenu>
2089 <guimenuitem>Forward</guimenuitem>
2090 </menuchoice></term>
2091 <listitem><para><action>Undoes</action> a <quote>Go Back</quote> action.</para></listitem>
2092 </varlistentry>
2093 
2094 <varlistentry>
2095 <term><menuchoice>
2096 <shortcut>
2097 <keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
2098 </shortcut>
2099 <guimenu>Go</guimenu>
2100 <guimenuitem>Home</guimenuitem>
2101 </menuchoice></term>
2102 <listitem><para><action>Changes to the users home folder, &eg;
2103 /home/Peter/.</action></para></listitem>
2104 </varlistentry>
2105 
2106 <varlistentry>
2107 <term><menuchoice>
2108 <guimenu>Go</guimenu>
2109 <guisubmenu>Recently Closed Tabs</guisubmenu>
2110 </menuchoice></term>
2111 <listitem><para><action>Shows a list of recently closed tabs which can
2112 be reopened.</action></para></listitem>
2113 </varlistentry>
2114 </variablelist>
2115 </para>
2116 </sect2>
2117 
2118 <sect2>
2119 <title>The Tools Menu</title>
2120 <para>
2121 
2122 <variablelist>
2123 <varlistentry>
2124 <term><menuchoice>
2125 <shortcut>
2126 <keycombo action="simul">&Shift;<keycap>F4</keycap></keycombo>
2127 </shortcut>
2128 <guimenu>Tools</guimenu>
2129 <guimenuitem>Open Terminal</guimenuitem>
2130 </menuchoice></term>
2131 <listitem><para><action>Opens &konsole; within the current folder.</action></para></listitem>
2132 </varlistentry>
2133 
2134 <varlistentry>
2135 <term><menuchoice>
2136 <shortcut>
2137 <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
2138 </shortcut>
2139 <guimenu>Tools</guimenu>
2140 <guimenuitem>Open Preferred Search Tool</guimenuitem>
2141 </menuchoice></term>
2142 <listitem><para><action>Opens preferred search tool in the current folder.</action></para></listitem>
2143 </varlistentry>
2144 
2145 <varlistentry>
2146 <term><menuchoice>
2147 <guimenu>Tools</guimenu>
2148 <guimenuitem>Compare Files</guimenuitem>
2149 </menuchoice></term>
2150 <listitem><para><action>Compare the currently selected files or folders with
2151 &kompare;. This action is only enabled if two files or folders are selected.</action></para></listitem>
2152 </varlistentry>
2153 
2154 <varlistentry>
2155 <term><menuchoice>
2156 <guimenu>Tools</guimenu>
2157 <guisubmenu>Select Remote Charset</guisubmenu>
2158 </menuchoice></term>
2159 <listitem><para><action>Allows you to choose the charset used by a remote
2160 connection manually.</action></para></listitem>
2161 </varlistentry>
2162 </variablelist>
2163 </para>
2164 </sect2>
2165 
2166 <sect2>
2167 <title>The Settings and Help Menu</title> 
2168 <para>
2169 &dolphin; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
2170 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
2171 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
2172 of the &kde; Fundamentals.
2173 </para>
2174 </sect2>
2175 
2176 </sect1>
2177 </chapter>
2178 
2179 <chapter id="misc-questions">
2180 <title>Miscellaneous Questions</title>
2181 
2182 <qandaset id="misclist">
2183 <qandaentry>
2184 <question>
2185 <para>Has &dolphin; replaced &konqueror;?</para>
2186 </question>
2187 <answer>
2188 <para>
2189 &dolphin; is not intended to be a competitor to &konqueror;: &konqueror; acts as
2190 a universal viewer being able to show &HTML; pages, text documents, folders and a
2191 lot more, whereas &dolphin; focuses on being only a file manager. This approach
2192 allows the optimization of the user interface for the task of file management.
2193 </para>
2194 </answer>
2195 </qandaentry>
2196 
2197 <qandaentry>
2198 <question>
2199 <para>How can I get involved with the development of &dolphin;?</para>
2200 </question>
2201 <answer>
2202 <para>
2203 The easiest way to get involved with &dolphin; is to subscribe to the developer 
2204 mailing list <ulink url="https://mail.kde.org/mailman/listinfo/kfm-devel">kfm-devel</ulink>
2205 and drop an email to the developer mailing list. Email what you can do, how much time
2206 you can devote &etc;, the developers will let you know what you can do in the
2207 project. If you wish to contribute to the documentation please email the
2208 <ulink url="mailto:kde-doc-english@kde.org">&kde; Documentation Team</ulink> list.
2209 </para>
2210 </answer>
2211 </qandaentry>
2212 
2213 <qandaentry>
2214 <question>
2215 <para>How can I submit bug reports?</para>
2216 </question>
2217 <answer>
2218 <para>
2219 The official channel for submitting bug reports is via the &kde; bug tracking
2220 system. The &kde; bug tracker can be found at
2221 <ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
2222 </para>
2223 </answer>
2224 </qandaentry>
2225 
2226 <qandaentry>
2227 <question>
2228 <para>How can I submit feature requests?</para>
2229 </question>
2230 <answer>
2231 <para>
2232 The official channel for submitting feature requests is via the &kde; bug
2233 tracking system. The &kde; bug tracker can be found at
2234 <ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
2235 </para>
2236 
2237 </answer>
2238 
2239 </qandaentry>
2240 </qandaset>
2241 </chapter>
2242 
2243 <chapter id="credits">
2244 
2245 <title>Credits and License</title>
2246 
2247 <para>
2248 &dolphin;
2249 </para>
2250 <para>
2251 Program copyright 2006&ndash;2014 Peter Penz <email>peter.penz@gmx.at</email>, 
2252 Frank Reininghaus <email>frank78ac@googlemail.com</email> and Emmanuel Pescosta 
2253 <email>emmanuelpescosta099@gmail.com</email> </para>
2254 <para>
2255 Contributors:
2256 <itemizedlist>
2257 <listitem><para>Cvetoslav Ludmiloff <email>ludmiloff@gmail.com</email></para></listitem>
2258 <listitem><para>Stefan Monov <email>logixoul@gmail.com</email></para></listitem>
2259 <listitem><para>Michael Austin <email>tuxedup@users.sourceforge.net</email></para></listitem>
2260 <listitem><para>&Orville.Bennett; &Orville.Bennett.mail;</para></listitem>
2261 </itemizedlist>
2262 </para>
2263 
2264 <para>
2265 Documentation copyright 2005 Peter Penz <email>peter.penz@gmx.at</email>
2266 </para>
2267 <para>
2268 Documentation copyright 2006 &Orville.Bennett; &Orville.Bennett.mail;
2269 </para>
2270 <para>
2271 Documentation copyright 2006 Michael Austin <email>tuxedup@users.sourceforge.net</email>
2272 </para>
2273 <para>
2274 Documentation copyright 2009 Frank Reininghaus <email>frank78ac@googlemail.com</email>
2275 </para>
2276 
2277 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
2278 
2279 &underFDL;               <!-- FDL: do not remove -->
2280 &underGPL;               <!-- GPL License -->
2281 
2282 </chapter>
2283 
2284 &documentation.index;
2285 </book>
2286 
2287 <!--
2288 Local Variables:
2289 mode: sgml
2290 sgml-minimize-attributes:nil
2291 sgml-general-insert-case:lower
2292 sgml-indent-step:0
2293 sgml-indent-data:nil
2294 End:
2295 
2296 vim:tabstop=2:shiftwidth=2:expandtab 
2297 -->