X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/4ae68e844502a64d2cfcce1ea349803f6313fd27..9706fbe6fedfa01f38a01b7dbe8d111e6745928d:/doc/index.docbook diff --git a/doc/index.docbook b/doc/index.docbook index 4a38a157a..43ee0db44 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -70,8 +70,8 @@ &FDLNotice; -2019-02-17 -Applications 19.04 +2022-01-17 +KDE Gear 22.04 @@ -189,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. @@ -238,9 +238,9 @@ 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 &systemsettings; in the Input Devices -Mouse module. +double-clicking, if Open by double-clicking instead +is enabled in the &systemsettings; in the Workspace +General Behavior module). @@ -312,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. @@ -349,9 +349,10 @@ as a detailed list which contains the name, size and last modification time of each item. Additional columns can be added by clicking a column header with the &RMB;. -In the context menu of the header line you can choose between custom or automatic -column width. Automatic width adjusts the width of all columns once to display the longest -item in the column completely, except for the Name column where +In the context menu of the header line, you can add or remove side padding +by checking or unchecking the respective menu item and choose between a custom +or automatic column width. Automatic width adjusts the width of all columns once to display the +longest item in the column completely, except for the Name column where the extension is replaced by ... The order of columns can be changed by drag and drop of column headers, except for @@ -610,11 +611,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 @@ -681,7 +682,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. @@ -690,7 +691,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 @@ -773,6 +774,33 @@ current folder, &RMB; click in the work space and click Add to Places in the context menu. + + + The corresponding menu item visibility can be toggled via the + &dolphin; context menu settings. + + + + + + +Filtering Files + + +&dolphin; is capable of filtering files, &ie; showing only those items in the +view whose name contains a given text. For example, if you wish to show +only the MP3 files within a folder, you could filter for .mp3. +This would then filter out all files whose name does not contain .mp3. + + + +To filter files, first enable the filter bar, either by pressing &Ctrl;I +or via the menu: Edit Filter... . +You can then enter the text to be filtered for in the filter bar. The filter bar can +be disabled either by pressing &Esc;, or with a &LMB; click on the +Hide Filter Bar icon. + + @@ -782,14 +810,14 @@ current folder, &RMB; click in the work space and click &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. Search files and for content in files - + Search files and for content in files @@ -811,7 +839,7 @@ starts the search from the user's Home folder. Search with More Options - + Search with More Options @@ -821,12 +849,15 @@ 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, Audio, Video, Images), - a time period and rating +a time period, rating, and tag, if you have defined any via +tag:foo in the input box. + + It is possible to clear selection using the Clear Selection button. Alternatively you can use these options in the Places panel together with the Filter bar to find files using Baloo or limit @@ -835,11 +866,10 @@ 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. - + +Use the More Search Tools drop-down list to select other search tools than Baloo. + @@ -912,26 +942,6 @@ via the Tools menu: Tools Compare F - -Filtering Files - - -&dolphin; is capable of filtering files, &ie; showing only those items in the -view whose name contains a given text. For example, if you wish to show -only the MP3 files within a folder, you could filter for .mp3. -This would then filter out all files whose name does not contain .mp3. - - - -To filter files, first enable the filter bar, either by pressing &Ctrl;I -or via the menu: Tools Show Filter Bar . -You can then enter the text to be filtered for in the filter bar. The filter bar can -be disabled either by pressing &Esc;, or with a &LMB; click on the -Hide Filter Bar icon. - - - - @@ -951,11 +961,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. @@ -1008,9 +1018,9 @@ tab bar at the top. -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. +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. @@ -1066,7 +1076,7 @@ to close the inactive pane when you are turning off the split view mode, ⪚ pr 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. +Moreover, the maximum size of local and remote files for which previews are generated can be chosen. If previews are enabled for folders, previews of some files in the folder will @@ -1078,11 +1088,14 @@ 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 . +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, +&gwenview; and all &kde; applications using the default &kde; file dialog, whereas Closing Dolphin windows with multiple tabs is a &dolphin; specific setting. @@ -1097,11 +1110,15 @@ the status bar is wide enough: -A zoom slider which can be used to change the icon size quickly. +The Show status bar item can be used for toggling status bar visibility. -A bar that shows how much space is free on the current drive. +The Show zoom slider item allows switching visibility of the icon size widget. + + + +The Show space information item can be used to switch on and off a bar that shows how much space is free on the current drive. @@ -1134,26 +1151,55 @@ This group contains settings which control the appearance of &dolphin; on startu -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 +The Show on startup option allows choosing the folder which is opened on startup. + + + If the Folders, tabs, and window state from last time item is selected then + + + + When launched from the &GUI; or CLI without any &URL;s, &dolphin; restores session + + + When rebooting with &dolphin; open, it restores session normally after the system comes back + + + When launched with &URL;s, &dolphin; window is opened showing those &URL;s instead of restoring session + + + 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 + + + +The location of the folder can also 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 startup folder by clicking the corresponding button. -Split view mode controls if the +Begin in split view mode controls if the &dolphin; view is split on startup -or not. +or not for new windows. + + + +Show filter bar controls if the filter bar is shown on +startup or not. See the section on the filter bar +for details. -Editable location bar controls if the location bar is in +Make location bar editable controls if the location bar is in editable mode on startup. The bread crumb mode of the location bar is used otherwise. See the section about the location bar for details about the two modes. + +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. + + If Show full path inside location bar is enabled, the full path of the current location is shown in the bread crumb mode of the location bar. @@ -1161,16 +1207,11 @@ Otherwise, a shortened version of the path is shown if it begins with the path o one of the places in the Places panel. - -Show filter bar controls if the filter bar is shown on -startup or not. See the section on the filter bar -for details. - - Show full path in title bar makes it easy to distinguish between files or folders with the same name in different folders. + @@ -1265,7 +1306,17 @@ the text of a file item. Expandable folders determines whether any folders that have subfolders are displayed in a tree view, where the sub items can be expanded by &LMB; clicking the > icon and collapsed by clicking the v icon. - + + +Folder size allows defining the property to use for sorting folders by their size. +It is possible to sort folders by number of items by choosing Show number of items or by the size of the contents by choosing Show size of contents. +The recursion level can be limited, which can be useful to constrain unneeded iterations in deep folder structures or on slow file systems. +It is also possible to disable displaying folder size by choosing Show no size (which might improve performance in rare cases, however impacts other features like sorting). + + +The Date style option can be used to configure the mode to display dates in &dolphin;. It is possible to choose between Relative (⪚, Yesterday, 3:00pm) or Absolute (⪚, 2020-12-23 15:00). + + @@ -1296,8 +1347,8 @@ structure and in archives works. 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. +changed in the &systemsettings; in the Workspace +General Behavior module. @@ -1318,7 +1369,7 @@ several levels deeper in the folder hierarchy. - + Services @@ -1328,10 +1379,10 @@ appears when clicking a file or folder with the &RMB;. -Screenshot of the Services settings in &dolphin;'s preferences dialog +Screenshot of the Services Menu settings in &dolphin;'s preferences dialog - + Services Settings. @@ -1354,13 +1405,15 @@ and you have additional entries in the context menu like commit, update, add, remove &etc; -In the service list you can also choose if the Delete, -Copy To, and Move To +In the service list you can also choose if the Copy To, +Move To, Add to Places, +Sort By, View Mode, +Open in New Tab, Open in New Window, +Copy Location, and Duplicate Here commands are shown in the context menu. &dolphin; has to be restarted to activate the changes for some of these settings. - @@ -1402,10 +1455,41 @@ largest files can be deleted automatically. + +User Feedback + + +This group contains settings which control your contributing information on the &dolphin; usage to its developers. + + +Screenshot of the User Feedback settings in &dolphin;'s preferences dialog + + + + + +User Feedback Settings. + +User Feedback Settings in &dolphin;'s Preferences Dialog. + + + + + + +You can contribute some feedback on &dolphin; if you wish. Use sliders to configure your level of participation. + + + + + + + + -Folder View Properties +Folder View Display Style The following settings control how the contents of a folder are displayed in the @@ -1447,31 +1531,31 @@ 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 to section. @@ -1511,6 +1595,11 @@ be accessed with toolbar buttons or with items in the menu of the folder. You will find an explanation of all available objects in &konqueror;'s handbook in the chapter Create New. + + + It is possible to create your own Create New... submenu items. Use files from KIO source repository as a reference and put the resulting .desktop file into the .local/share/templates in your home directory (the address can be determined using the kf5-config --path templates command in &konsole;), then restart &dolphin;. + + @@ -1604,6 +1693,17 @@ to the trash and cannot be restored. + + + +&Ctrl;D + +File +Duplicate Here + +Creates duplicates of selected items appending copy to the end of their names. + + @@ -1687,13 +1787,49 @@ The name of this file has to be entered in a dialog. + + + +&Ctrl;F5 + +Edit +Copy to inactive split view + +Copies the currently selected item(s) from the active split view to the inactive split view. + + + + + +&Ctrl;F6 + +Edit +Move to inactive split view + +Moves the currently selected item(s) from the active split view to the inactive split view. +Is disabled if the current user does not have write permission on the selected item(s). + + + + + +&Ctrl;I + +Edit +Filter... + +Enables and disables the filter bar. +You can also use the alternate shortcut &Shift;/ +for this action. + + &Ctrl;F Edit -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. @@ -1754,6 +1890,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 @@ -1780,7 +1927,7 @@ or other criteria described in Informat View -Additional Information +Show Additional Information Displays additional information described in Information in the View. @@ -1790,7 +1937,7 @@ described in Information in the View View -Preview +Show Previews Displays a symbolic preview of the file contents in the different view modes. @@ -1812,7 +1959,7 @@ current folder grouped by the option selected in Sort By&Alt;. View -Hidden Files +Show Hidden Files Shows all the hidden files and sub-folders within the current folder.There is an alternate shortcut &Ctrl;H @@ -1853,7 +2000,7 @@ folder. View -Panels +Show Panels Enables and disables the different panels: Places (F9), Information @@ -1899,9 +2046,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. @@ -1979,25 +2126,23 @@ be reopened. -&Ctrl;I +&Shift;F4 Tools -Show Filter Bar +Open Terminal -Enables and disables the filter bar. -You can also use the alternate shortcut &Shift;/ -for this action. +Opens &konsole; within the current folder. -&Shift;F4 +&Ctrl;&Shift;F Tools -Open Terminal +Open Preferred Search Tool -Opens &konsole; within the current folder. +Opens preferred search tool in the current folder. @@ -2025,8 +2170,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. @@ -2076,7 +2221,7 @@ project. If you wish to contribute to the documentation please email the The official channel for submitting bug reports is via the &kde; bug tracking system. The &kde; bug tracker can be found at -http://bugs.kde.org. +https://bugs.kde.org. @@ -2089,7 +2234,7 @@ system. The &kde; bug tracker can be found at The official channel for submitting feature requests is via the &kde; bug tracking system. The &kde; bug tracker can be found at -http://bugs.kde.org. +https://bugs.kde.org.