X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/080498368502bfbdc4e13427ba3a9a21cefcafdf..1b16673250509be0308ebcf0e7d0736801c5063c:/doc/index.docbook diff --git a/doc/index.docbook b/doc/index.docbook index 0d1a35f58..43ee0db44 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -70,8 +70,8 @@ &FDLNotice; -2019-09-30 -Applications 19.12 +2022-01-17 +KDE Gear 22.04 @@ -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). @@ -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 @@ -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. + + @@ -789,7 +817,7 @@ 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 @@ -826,7 +854,10 @@ 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. - - - - @@ -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 @@ -1085,7 +1095,7 @@ It is also possible to choose the default action When opening an execu 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. @@ -1100,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. @@ -1137,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. -Editable location bar controls if the location bar is in +Show filter bar controls if the filter bar is shown on +startup or not. See the section on the filter bar +for details. + + + +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. @@ -1164,20 +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. - -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. - @@ -1272,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). + + @@ -1303,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. @@ -1325,7 +1369,7 @@ several levels deeper in the folder hierarchy. - + Services @@ -1335,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. @@ -1361,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. - @@ -1409,6 +1455,37 @@ 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. + + + + + + + + @@ -1518,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;. + + @@ -1611,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. + + @@ -1694,6 +1787,42 @@ 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. + + @@ -1994,19 +2123,6 @@ be reopened. - - - -&Ctrl;I - -Tools -Show Filter Bar - -Enables and disables the filter bar. -You can also use the alternate shortcut &Shift;/ -for this action. - - @@ -2105,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. @@ -2118,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.