X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/8a56637663a6c5305b9ec244588e50eb8399e95b..496c6b9e39cb36e945ddc1c7f2ac9eca45ddacf8:/doc/index.docbook
diff --git a/doc/index.docbook b/doc/index.docbook
index 3749831ab..d1342d0d4 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,7 +1,5 @@
Dolphin">
-
]>
@@ -72,12 +70,12 @@
&FDLNotice;
-2015-08-02
-Applications 15.08
+2020-03-17
+Applications 20.04
-&dolphin; is the default file manager for &kde;, designed with usability as a primary focus.
+&dolphin; is the default file manager by &kde;, designed with usability as a primary focus.
@@ -95,7 +93,7 @@
Introduction
-&dolphin; is &kde;'s default file manager. It aims to improve usability at the
+&dolphin; is &plasma;'s default file manager. It aims to improve usability at the
user interface level. &dolphin; focuses only on being a file manager whereas
&konqueror;, which was &kde;'s default file manager in &kde; 3 and can still be
used for file management, is a universal viewer for many file types.
@@ -191,7 +189,7 @@ The Places panel, which
provides quick access to bookmarked locations and disks or other media.
If desktop search and file indexing are enabled in the Desktop Search
-module in the &systemsettings; the panel provides Recently Saved
+module in the &systemsettings; the panel provides Recent
items and allows you to search for Documents, Images,
Audio Files and Video.
@@ -241,8 +239,8 @@ can be accessed or manipulated in different ways:
A file or folder can be opened by clicking it with the &LMB; (or
double-clicking, if Double-click to open files and folders
-is enabled in the Navigation
-section of the settings).
+is enabled in the &systemsettings; in the Input Devices
+Mouse module.
@@ -283,6 +281,9 @@ the toolbar can be used to navigate in the history.
+If you click with the &MMB; the item in the history is opened in a new tab
+thus keeping the current tab with its content.
+
@@ -311,7 +312,7 @@ The buttons in the toolbar which control the appearance of the view.
All the settings discussed below and other options concerning, ⪚ the
sorting of the files in the current folder, can also be modified in the
View menu and in the
-View Properties dialog. By
+View Display Style dialog. By
default, these settings are remembered for each folder separately. This
behavior can be changed in the
General section of the settings.
@@ -357,11 +358,11 @@ the extension is replaced by ...
the Name header, which is always the first column in this view.
-The details view allows you to view the current directory
+The details view allows you to view the current folder
in a tree-like fashion if
-Expandable folders are enabled:
+Expandable folders are enabled:
Each subfolder of the current folder can be
-expanded or collapsed by clicking on the >
+expanded or collapsed by clicking on the >
or v icon next to it.
@@ -386,7 +387,7 @@ in ViewSort byInformation in the View
-In all view modes &kappname; shows at least an icon and a name for each item.
+In all view modes &dolphin; shows at least an icon and a name for each item.
Using Additional Information in the View
menu or the context menu of the header in Details mode, you can select
more information for each item to be shown:
@@ -609,11 +610,11 @@ programs built into &kde; which add support for many different protocols to
used to manage files and folders on a remote host that is accessible
via SSH. To do this you would type fish://username@remotehost
into the location bar. Similar remote file management can be done on
-remote hosts accessible via the &FTP;, NFS, SFTP, SMB (CIFS) or webdav protocols.
+remote hosts accessible via the &FTP;, &NFS;, SFTP, &SMB; (&CIFS;) or webdav protocols.
-It is also possible to use the kioslaves drop down list to access
+It is also possible to use the kioslaves drop down box to access
&systemsettings;, fonts, trash, other programs and devices attached to your computer.
-See the drop down list for the full list of capabilities available from kioslaves on your system.
+See the drop down box for the full list of capabilities available from kioslaves on your system.
Screenshot of the list of kioslaves
@@ -680,7 +681,7 @@ the path starting with the current places entry.
&dolphin; allows a number of panels to be placed next to the view. These can
-be enabled in ViewPanels.
+be enabled in ViewShow Panels.
By unlocking the panels and clicking and dragging a panel title, the panel can be moved
to a different position, even outside the window.
@@ -689,7 +690,7 @@ to a different position, even outside the window.
Places
-
+
The Places panel is located at the left of the window by
default. The Places panel shows any locations you have
@@ -725,7 +726,7 @@ over with the mouse, including size, type, and date of last modification. It als
features a large preview of the selected item and allows you to assign a rating,
tags, and comments to it.
-
+
@@ -735,9 +736,10 @@ tags, and comments to it.
The Folders panel shows a tree view structure of the file
system. It only shows folders. Clicking a folder with the &LMB; opens this folder
in the &dolphin; view.
-
-
+Use Limit to Home Directory to hide all folders from
+the tree view except your Home.
+
@@ -776,10 +778,11 @@ current folder, &RMB; click in the work space and click
Finding Files and Searching in Files
+
&dolphin; is capable of searching for files and for content in files. If
&Ctrl;F is pressed or Edit
-Find... is used, the Find
+Search... is used, the Search
bar will open already set up to search for files within the current folder and any sub-folders.
Start to type into the find input box and the search starts immediately.
@@ -804,7 +807,6 @@ a KIOSlave is launched to provide the search results.
The option from Everywhere with activated Baloo
services searches in all indexed folders, without Baloo this option
starts the search from the user's Home folder.
-
Search with More Options
@@ -819,7 +821,7 @@ starts the search from the user's Home folder.
-Use the More Options button to extend the Find
+Use the More Options button to extend the Search
bar. This provides a very comfortable way for
the user to shrink the number of search results.To start a search select one or more file types (Documents,
@@ -830,6 +832,14 @@ the user to shrink the number of search results.
together with the Filter bar to find files using Baloo or limit
the search to files matching the filter expression.
+Use the Save icon to save a search to the Search For
+section in the Places panel to quickly access it again in the future.
+
+
+
@@ -854,7 +864,7 @@ in the menu, ⪚ Undo: Rename.
-
+
Renaming A Batch Of Files
@@ -862,7 +872,7 @@ in the menu, ⪚ Undo: Rename.
will have the file name specified, including a number, ⪚, Image1.jpg,
Image2.jpg, Image3.jpg. This can be useful, ⪚, for pictures taken with a digital camera.
-
+
If you wish to rename a batch of files, first select the files to be renamed.
This can be done by pressing the &LMB; and drawing a rectangle around the files
@@ -941,11 +951,11 @@ using the Preferences Dialog.
Settings which determine how the contents of a folder are displayed in &dolphin;.
-These settings are called View Properties
+These settings are called View Display Styles
and can be controlled with toolbar buttons, via the View menu,
-and with the View Properties Dialog.
-In the default configuration, the view properties are remembered for each folder,
-but &dolphin; can also be configured to use common view properties for all folders
+and with the View Display Style dialog.
+In the default configuration, all folders use the same display style,
+but &dolphin; can also be configured to remember each folder's display style separately
in the General
section of the settings.
@@ -967,6 +977,144 @@ be accessed by clicking the corresponding icon on the left of the dialog.
tab on the General page are shared with &konqueror; in filemanager mode.
+
+General
+
+
+This group contains settings which control the general behavior of &dolphin;.
+The group is divided further into four subgroups which can be accessed using the
+tab bar at the top.
+
+
+Screenshot of the General settings in &dolphin;'s preferences dialog
+
+
+
+
+
+General Settings.
+
+
General Settings in &dolphin;'s Preferences Dialog.
+
+
+
+
+
+
+Behavior Tab
+
+
+
+
+
+
+In the View section, you can configure whether the same
+view display style is shared among all folders
+or folders remember their own individual view display styles.
+
+
+
+Sorting Mode controls how items are sorted in
+the view. If Natural sorting is enabled, the sort order of three example files
+will be
+
+File1,
+File2,
+File10.
+
+If this option is disabled, the normal alphabetical sorting case sensitive or case insensitive
+will be used, which leads to the sort order
+
+File1,
+File10,
+File2.
+
+
+
+
+When hovering over a file or folder with the mouse, a small window with relevant
+information is shown if Show tooltips is enabled.
+
+
+
+Show selection marker shows a small +
+or - button above an item's icon if the item is hovered over
+with the mouse. These can be used to select or deselect the item.
+
+
+
+Enable Rename inline to use this mode if only one item is currently selected.
+If this option is disabled or several items are selected, a dialog will be displayed for renaming.
+
+
+Enabling Switch between split panes with tab key
+allows to switch split views with the key.
+
+
+Disable Turning off split view closes active pane
+to close the inactive pane when you are turning off the split view mode, ⪚ pressing F3.
+
+
+
+
+
+
+
+
+
+Previews Tab
+
+
+In this tab, you can configure for which file types previews are shown.
+Moreover, the maximum size of remote files for which previews are generated can be chosen.
+
+
+If previews are enabled for folders, previews of some files in the folder will
+be shown inside a folder's icon.
+
+
+
+
+Confirmations Tab
+
+In the ask for confirmation section, you can enable warning dialogs that
+are shown before potentially harmful actions.
+
+
+It is also possible to choose the default action When opening an executable file. There are three options, namely Always ask, Open in application, and Run script.
+
+The confirmation settings for Moving files or folders to trash and
+Deleting files or folders affect file operations in &dolphin;, &konqueror;,
+&gwenview; and all &kde; applications using the default &kde; file dialog,
+whereas Closing Dolphin windows
+with multiple tabs is a &dolphin; specific setting.
+
+
+
+Status Bar Tab
+
+
+In this tab, some additional items can be enabled for the status bar, provided
+the status bar is wide enough:
+
+
+
+
+A zoom slider which can be used to change the icon size quickly.
+
+
+
+A bar that shows how much space is free on the current drive.
+
+
+
+
+
+
+
+
+
+
Startup
@@ -989,15 +1137,15 @@ This group contains settings which control the appearance of &dolphin; on startu
-The Home Folder is the folder which is opened on startup. The
+The Start in folder is the folder which is opened on startup. The
location of the folder can be entered directly or chosen in a dialog which can
be opened by clicking the button showing a folder icon. Moreover,
the current location or the default location (which is the user's home folder)
-can be used as the Home Folder by clicking the corresponding button.
+can be used as the startup folder by clicking the corresponding button.
-Split View Mode controls if the
+Split view mode controls if the
&dolphin; view is split on startup
or not.
@@ -1022,6 +1170,14 @@ startup or not. See the section on the filter bar
+
+Show full path in title bar makes it easy to distinguish
+between files or folders with the same name in different folders.
+
+
+
+Open new folders in tabs 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.
+
@@ -1146,16 +1302,9 @@ structure and in archives works.
-&dolphin; can be configured to open items with a single mouse click
-(Single-click to open files and folders) or a double mouse
-click (Double-click to open files and folders). In the
-latter case, a single mouse click will select the file or folder.
-
-
-This is a system wide setting and can be changed in the &systemsettings; in the
-Input DevicesMouse
-module as well.
-
+The option to open items with a single or double mouse click is a system wide setting and can be
+changed in the &systemsettings; in the Input Devices
+Mouse module.
@@ -1260,145 +1409,14 @@ largest files can be deleted automatically.
-
-General
-
-
-This group contains settings which control the general behavior of &dolphin;.
-The group is divided further into four subgroups which can be accessed using the
-tab bar at the top.
-
-
-Screenshot of the General settings in &dolphin;'s preferences dialog
-
-
-
-
-
-General Settings.
-
-
General Settings in &dolphin;'s Preferences Dialog.
-
-
-
-
-
-
-Behavior Tab
-
-
-
-
-
-
-In the View section, you can configure whether the
- view properties are stored for each
-folder or if common view properties are to be used for all folders.
-
-
-When hovering over a file or folder with the mouse, a small window with relevant
-information is shown if Show tooltips is enabled.
-
-
-
-Show selection marker shows a small +
-or - button above an item's icon if the item is hovered over
-with the mouse. These can be used to select or deselect the item.
-
-
-
-Natural sorting of items controls how items are sorted in
-the view. If this option is enabled, the sort order of three example files
-will be
-
-File1,
-File2,
-File10.
-
-If this option is disabled, the normal alphabetical sorting will be used, which
-leads to the sort order
-
-File1,
-File10,
-File2.
-
-
-
-
-Enable Rename inline to use this mode if only one item is currently selected.
-If this option is disabled or several items are selected, a dialog will be displayed for renaming.
-
-
-
-
-
-
-
-
-
-Previews Tab
-
-
-In this tab, you can configure for which file types previews are shown.
-Moreover, the maximum size of remote files for which previews are generated can be chosen.
-
-
-If previews are enabled for folders, previews of some files in the folder will
-be shown inside a folder's icon.
-
-
-
-
-Confirmations Tab
-
-In the ask for confirmation section, you can enable warning dialogs that
-are shown before potentially harmful actions .
-
-The confirmation settings for Moving files or folders to trash and
-Deleting files or folders affect file operations in &dolphin;, &konqueror;,
-Gwenview and all &kde; applications using the default &kde; file dialog,
-whereas Closing Dolphin windows
- with multiple tabs is a &dolphin; specific setting.
-
-
-
-Status Bar Tab
-
-
-In this tab, some additional items can be enabled for the status bar, provided
-the status bar is wide enough:
-
-
-
-
-A zoom slider which can be used to change the icon size quickly.
-
-
-
-A bar that shows how much space is free on the current drive.
-
-
-
-
-
-
-Since &dolphin; 4.9 the Delete,
-Copy To, and Move To
-commands of the context menu have to be enabled on the Services page.
-
-
-
-
-
-
-Folder View Properties
+Folder View Display Style
The following settings control how the contents of a folder are displayed in the
-&kappname; view, and are stored on a per-folder basis by default:
+&dolphin; view, and are stored on a per-folder basis by default:
@@ -1419,7 +1437,7 @@ Sorting of folders and files – are folders shown first or not?
Previews – are they shown instead of icons (based on the settings made in
Previews
-tab of &kappname;'s General settings) or not?
+tab of &dolphin;'s General settings) or not?
@@ -1436,37 +1454,37 @@ What additional information (besides the name) is shown in the Icons or Details
-The view properties can be configured in the
+The view display style can be configured in the
View menu, some (such as the view
mode) can also be changed using toolbar buttons.
-The View Properties Dialog
+The View Display Style dialog
-Screenshot of the View Properties dialog
+Screenshot of the View Display Style dialog
-The View Properties dialog.
+The View Display Style dialog.
-
The View Properties Dialog.
+
The View Display Style Dialog.
-The View Properties dialog can be used to quickly modify
-several view properties at once. This is done for the current folder, for the
+The View Display Style dialog can be used to quickly modify
+the view display styles for many folders at once. This is done for the current folder, for the
current folder including all subfolders, or even for all folders, depending on
-the choice made in the Apply View Properties To section.
+the choice made in the Apply to section.
-If Use these view properties as default is enabled, the chosen view
+If Use as default view settings is enabled, the chosen view
properties will also be used for all folders which do not have customized view
properties yet.
@@ -1536,6 +1554,17 @@ folder.
Closes the current tab.
+
+
+
+&Ctrl;&Shift;T
+
+File
+Undo close tab
+
+Reopens the last closed tab.
+
+
@@ -1573,6 +1602,26 @@ trash.
to the trash and cannot be restored.
+
+
+File
+Show Target
+
+This action highlights a link target in a new &dolphin; window.
+
+
+
+
+
+
+&Ctrl;D
+
+File
+Duplicate Here
+
+Creates duplicates of selected items appending copy to the end of their names.
+
+
@@ -1584,7 +1633,7 @@ to the trash and cannot be restored.
Shows the properties dialog for the currently selected
item(s).
-
+
@@ -1644,7 +1693,10 @@ item(s).
&Ctrl;VEdit
-Paste Clipboard Contents...
+Paste Clipboard Contents... or
+EditPaste one File or
+EditPaste one Folder or
+EditPaste x ItemsPastes the currently copied/cut items to the current
folder. If the clipboard does not contain files or folders, the clipboard
@@ -1659,7 +1711,7 @@ The name of this file has to be entered in a dialog.
&Ctrl;FEdit
-Find...
+Search...Opens the find bar. Enter a search term into the edit box and select to search for filename
or in contents of files starting from the current folder or everywhere.
@@ -1720,6 +1772,17 @@ Selects all unselected items and deselects all selected items in the current fol
Decreases the size of icons in the view.
+
+
+
+&Ctrl;0
+
+View
+Zoom Reset
+
+Resets the size of icons in the view to default.
+
+
View
@@ -1746,7 +1809,7 @@ or other criteria described in Informat
View
-Additional Information
+Show Additional InformationDisplays additional information
described in Information in the View.
@@ -1756,7 +1819,7 @@ described in Information in the View
View
-Preview
+Show PreviewsDisplays a symbolic preview of the file contents in the different
view modes.
@@ -1781,7 +1844,8 @@ current folder grouped by the option selected in Sort ByShow Hidden FilesShows all the hidden files and sub-folders within the current
-folder.
+folder.There is an alternate shortcut &Ctrl;H
+for this action.
@@ -1818,7 +1882,7 @@ folder.
View
-Panels
+Show PanelsEnables and disables the different panels:
Places (F9), Information
@@ -1864,9 +1928,9 @@ if necessary, and selects the location such that it can be replaced quickly.
View
-Adjust View Properties...
+Adjust View Display Style...
-Opens the View Properties
+Opens the View Display Style
Dialog.
@@ -1949,7 +2013,9 @@ be reopened.ToolsShow Filter Bar
-Enables and disables the filter bar.
+Enables and disables the filter bar.
+You can also use the alternate shortcut &Shift;/
+for this action.
@@ -1963,6 +2029,17 @@ be reopened.
Opens &konsole; within the current folder.
+
+
+
+&Ctrl;&Shift;F
+
+Tools
+Open Preferred Search Tool
+
+Opens preferred search tool in the current folder.
+
+
Tools
@@ -1988,8 +2065,8 @@ connection manually.
The Settings and Help Menu
&dolphin; has the common &kde; Settings and Help
-menu items, for more information read the sections about the Settings Menu and Help Menu
+menu items, for more information read the sections about the Settings Menu and Help Menu
of the &kde; Fundamentals.
@@ -2102,21 +2179,6 @@ Documentation copyright 2009 Frank Reininghaus frank78ac@googlemail.com
-
-How to get &dolphin;
-
-&install.intro.documentation;
-
-For instructions on acquiring &kde; please see http://www.kde.org or read the chapter
-Installing &kde;
-in the &kde; Fundamentals.
-
-For further information about &dolphin; you might want to visit
-http://userbase.kde.org/Dolphin.
-
-
-
&documentation.index;