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, ⪚ 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; ⪚ 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>></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, ⪚ <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, ⪚, Image1.jpg, 0903 Image2.jpg, Image3.jpg. This can be useful, ⪚, 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 ⪚ 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 	 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, ⪚ 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>></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> (⪚, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (⪚, <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 – are folders shown first or not? 1509 </para></listitem> 1510 1511 <listitem><para> 1512 Previews – 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, ⪚ 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–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 -->