diff --git a/doc/basic-functions.docbook b/doc/basic-functions.docbook index 1d00830c..3f2c8124 100644 --- a/doc/basic-functions.docbook +++ b/doc/basic-functions.docbook @@ -1,434 +1,447 @@ Basic Functions Controls General This is a rather short but important section that will go into the details of controlling &krusader;. This section does not try to cover all the various key combinations for two reasons: there are just too many of them most of &krusader; actions are configurable in the Konfigurator Panel page We will only mention the most important keyboard shortcuts with the default configuration, but keep in mind that most of the Key-Bindings are configurable. If you find that you use a certain command a lot and want to know the shortcut for this command, or you want to change this command shortcut, then check out the Configure Shortcuts window (Settings Configure Shortcuts...). Moving Around By Moving Around we mean the transfer of the keyboard and mouse focus between the different parts of the &krusader; main window. The focus can be in one of five places: the Left or Right Panel, the Menu Bar, the Command Line or the Terminal Emulator. The panel that has the focus is called the Active Panel. An Active Panel will remain active until the other panel receives the focus (&ie;: if the Left Panel was active and you clicked on the Command Line - then the Left Panel remains the Active Panel). You must deliberately change which panel is active. The most common way to transfer the focus to a specific panel is to use the mouse to click on that panel. But you should be aware of the following: Clicking on the Toolbar, the FN keys bar or the Status Bar does not change the focus. Pushing the Run in Terminal Mode button in the Command Line will not transfer the focus, so you have to click inside the Input Line. When you choose a menu, the Menu Bar will become focused. It remains focused until you choose a command - the focus returns to the previous owner. There are, of course, ways to use the keyboard to change the focus: The Key will switch panels, if one of the panels has the focus or rotate between all the commands in a menu, if the Menu Bar is active. The &Ctrl; Down Arrow will take you from the Active Panel to the Command Line or Terminal Emulator, and the &Ctrl; Up Arrow will take you back from the Command Line to the Active Panel. The &Esc; Key will make the Menu Bar return the focus, if it has it, to the previous Active Panel. If you happen to be inside the Terminal Emulator, you can use the Key, or the mouse, to navigate to an Active Panel. Pressing &Alt; Underlined Letter from the Menu Bar will open that menu (unless this key combination is a "Reserved Key", used by one of &krusader;'s actions). Selecting &krusader; offers 4 Selection Modes, only &krusader;'s Selection Mode is explained here. Selecting is a skill you need to master in order to get the most out of &krusader;. Since the Tree Panel allows select only one directory at a time, this paragraph mainly explains how to select files in the List Panel. Moving the cursor is easy. Left-clicking on a file or directory (referred to herein as "elements" meaning files and directories) will select it. Here are some useful pointers that will make &krusader; even easier to use (assuming you are using &krusader;'s Mouse Selection Mode): The Space and Insert keys will toggle the selection of the file under the cursor without affecting the selection of other files/directories, the cursor will go one position down. Pressing the Space on a directory under the cursor will calculate occupied space without affecting the selection of other files/directories. Left Clicking on a file will select, or unselect, all previously selected files. &Ctrl; Left Clicking will toggle the selection of the file under the cursor without affecting the selection of other files/directories. &Shift; Left Clicking will select all the elements between the previous cursor location and the new one. &Shift; Home selects everything above the cursor (and deselects everything below the cursor, if selected). &Shift; End selects everything below the cursor (and unselects everything above the cursor, if selected). The ".." entry is not selectable. The Edit menu can offer more ways to select your files. Executing Commands There is not a lot to say here, all you need to do is select some files (if you do not, &krusader; will operate on the file(s) or directory(s) that have the focus), choose a Command from the Menu Bar or use a Keyboard Shortcut (or the Right Click Menu) and the selected Command executes. See also Executing Files. Quick search This feature will do a quick search for the file name in the Active List Panel. Type foo(one character) to do a quick search in the Active List Panel for a file beginning with "foo". A small quick search dialog box will open below the Active List Panel. Type the first few characters of the desired file name (more than one character allowed), the cursor will jump to that filename (if it exists), ⪚ type "ab" to search for a file which begins with "ab". The Up/Down Arrow will jump to the next or previous match. &Esc; will close the quick search line. The cursor will stay on the last file found. The Quicksearch supports regular expressions for searching files. If you press &Alt; foo, the key binding shortcut will be executed. If there is no configured key binding, the remaining letter foo will be used for the quick search. Use Configure Shortcuts window (Settings Configure Shortcuts...). Quick filter This feature will do a quick filter for the file list in the Active Panel. Press &Ctrl;I to open Quickfilter bar. Type foo (one character) to filter out from the Active Panel all the files that do not have "foo" in names. You can use wildcards for the filtering. ⪚ use "a*b" to filter files which have "a" and "b" in their names. The Quickfilter follows the case-sensitivity setting of Quicksearch. Pressing &Enter; in Quickfilter mode sets focus to panel, when panel or Quickfilter is focused &Esc; closes Quickfilter. To change the default shortcut of Quickfilter use Configure Shortcuts window (Settings Configure Shortcuts...). Context Menu &krusader; has many Context menus that allow you to do fast operations with the mouse, usually a right-click will open the Context menu (depending on your Selection Modes settings). This list gives an overview of the most important context menus. Use them to discover the available commands. Main Toolbar (orientation, text position, icon size) List Panel on a file or directory Command Line (undo, paste, text completion...) Terminal emulator (send signal, font, history...) Folder tabs (new, duplicate, close) KruSearcher Search results file list (F3 View, F4 Edit) MountMan (unmount, format...) Synchronize Directories File List (disabled at the compilation time by default) UserActions &konqueror; Right-Click actions are shown in &krusader; Show/hide Column Headers Bookmarks enable/disable permanent bookmarks ... Basic File Management Executing Files You can only execute files in the Active List Panel. To execute a file just (double-)click on it or press &Enter; when it is under the list cursor. &krusader; will open it in the default application for this file type (picture, text file...) or the file will be executed (script, binary...). If you want to use another application to open the file, click with the &RMB; on the file and go to the Open with sub-menu which will offer more options. &krusader; is compatible with the &kde; default file manager for all file types except archives that are opened inside the &krusader; panel and not in an external application. See the archives page in Konfigurator for details. Copying and Moving To copy or move files/directories just select them and press F5 to copy or F6 to move them. &krusader; tries to preserve the time of modification. When copying a directory owner is changed to the user which copies the directory, group is changed to the default group of the user. When copying a file owner is changed to the user which copies the file, group is changed to default group of the user, and permissions are preserved. The owner, the group and the permissions are preserved when moving file or directory. When copying or moving files/directories a dialog appears and allows you to choose the operation destination. The default destination is the other-panel browsed directory. If you enter a partial &URL;, &krusader; will use the current panel directory as the &URL; base. +
+ Copy dialog + + + + + + Copy dialog + + +
Queue manager The copy, move, pack and unpack operations can be queued. After selecting copy or move, hit F2 to use it. After selecting pack or unpack, hit F2 to use it. Or the direct shortcuts: copy by queue &Shift;F5 , move by queue &Shift;F6 . Queue manager performs actions one-by-one. For example, if you have a pen drive (which is slow), and you want to copy 40 files onto it, it is much better copying them one-by-one instead of starting to copy 40 files in parallel. That is why enqueuing is important. If you pack/unpack 40 files in parallel, you overload your computer, but adding them to a queue, is much more useful. + It is possible to switch the Queue Manager mode by the Settings Job Queue Mode menu item. + Deleting - move to &kde;'s Trash Deleting files/directories is done by selecting them and pressing F8 or Delete. By default it will be moved to &kde;'s Trash. You can open the &kde; Trash with the Trash icon in the Main Toolbar or with the trash:/ KIO slave. Physically &kde; Trash is located in ~/.local/share/Trash/ or Trash in the subdirectory in user home directory which can be determined using the qtpaths --paths GenericDataLocation command. &Shift; Delete will delete the file permanently. A dialog will ask for your confirmation and will warn you when deleting non-empty directories. Of course only operations that are permitted to do by the Operating System will be performed - you will be notified otherwise. If you do not wish to see the confirmation dialogs, you can disable them in the Konfigurator advanced page. Shred Files Shred was removed from &kde; 4 (and as consequence &krusader;-2 for &kde; 4). The main reason is probably that shredding is filesystem dependent and even if you overwrite the file 100 times, it is not sure, that it will be deleted from the disk finally. Quote from the kgpg posts: The shred feature has been removed from the KDE library. Kgpg will not support this feature anymore. Moderns file systems use journalisation. So the shred feature should be implemented in the file system. Not in kgpg. But you might use a proper shred UserAction for your filesystem. But keep in mind that if you want to be 100% sure that it is impossible that someone can read a deleted file, you need to destroy your harddrive hardware... Renaming Files, Creating Directories and Link Handling Rename the file under the cursor with the F9 key or with two single mouse clicks. If only the file name needs to be renamed and not the extension, you can configure this in the Konfigurator General page. Create a new directory with the F7 key. Right-clicking on a regular file will give you the option Link Handling New Symlink. A dialog will prompt you to enter a symlink name. That symlink will point to the file/directory you right-clicked on. If the file you right-clicked on is a symlink, you will also be presented with the Link Handling Redirect Link option that will allow you to change the link target. Viewing and Editing files KrViewer has a chapter of its own. &archives; diff --git a/doc/copyjob.png b/doc/copyjob.png new file mode 100644 index 00000000..a07f842e Binary files /dev/null and b/doc/copyjob.png differ diff --git a/doc/features.docbook b/doc/features.docbook index 83f2d534..17cf4e71 100644 --- a/doc/features.docbook +++ b/doc/features.docbook @@ -1,468 +1,486 @@ Features Features The most important features and improvements are highlighted here, it would make this list too long if we were to include all the features and improvements. You will discover even more features in this documentation and in the ChangeLog file. <ulink url="http://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink> features Two powerful and easy to use OFM panels. Command Line and optional Terminal emulator below. Strong keyboard orientation and the ability to perform all functions without the mouse. Context-dependent invocation of scripts and programs ⪚ mouse click/&Enter; (execute or open with the associated application), F3 (view) and F4 (edit). User Menu, create your own customized menu. History ⪚ Folder History, Popular &URL;s, &etc; Virtual file systems (VFS) ⪚ for Remote Connections, archives, search results, synchronizer (disabled at the compilation time by default). Powerful internal viewer and editor via kparts supporting almost every file format. Advanced Search module: searching in archives and search content on remote file systems. Several Panel view modes via the PopUp Panel. &krusader; tools Remote Connections: &FTP;/SAMBA with SFTP/SCP support via KIO Slaves Locate &GUI; frontend Synchronize Directories (disabled at the compilation time by default) Mount-Manager Disk Usage Root mode &krusader; features Archive Handling: browsing, unpack, pack, testing. Supported archives: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip. Checksum Creation and Verification mechanism that supports md5, sha1, sha256, sha224, sha256, sha384, sha512, tiger, whirlpool, cfv, and crc. Calculate occupied space of files and folders, archives and remote filesystems. Directory comparison and filtering. Compare files by content via external diff programs like &kompare;, KDiff3 or xxdiff. Rename files and folders via KRename Completely supports drag'n'drop: drag from &konqueror; straight into a .tar.gz file, from &krusader;'s panel into the trash bin, the desktop or into &konqueror; Preserve date for local targets at copy/move operations. F2 opens a Terminal Window in the current directory. Easy editing of file permissions and ownership and Numeric Permissions. Selection filters used in ⪚ Synchronizer (disabled at the compilation time by default) and KruSearcher. Jump-Back MIME type-aware. Tabbed panels and Tabbed Editor/Viewer. Quick search, select and filter File splitter Mouse Gestures Quick Navigation in the Location Toolbar. WhatsThis Help function in favour of tooltips where reasonable. Sync-browsing Customize &krusader; to your own needs Konfigurator &krusader;'s configuration center. Main Toolbar, Actions Toolbar for user actions and bookmarks. Key-bindings Colors Panel profiles Bookmark-Manager Selection Modes Many more features can be configured the way you like. &krusader; Extensions UserActions Color Profiles Key-binding Profiles Download and upload your favourite &krusader; extensions at store.kde.org. New features in the &krusader;-1.80.0 "Final 3rd Stone" release Archive improvements Password support for: arj, ace, rar and zip. Passwords can be stored in Kwallet 7-zip support, by external applications 7z and 7za. Auto-detection support, allowing you to open "hidden archives" (⪚ OpenOffice documents). Packing/unpacking is now in the background. Brief View Many improvements of the UserAction system. Countless usability enhancements, especially in Konfigurator and the heavily reordered menubar. Media button Copy/Move: preserve all attributes (time, owner, group). Dim the colors of the inactive panel. Renaming a filename without extension, single instance mode, start to system tray, check this out in Konfigurator Configurable Atomic extensions, so that extensions like .tar.gz are shown as one part in the Ext Column. Context menu for bookmarks and enable/disable special bookmarks. Restyled MenuBar Terminal emulator enhancements bringing new functions, new usages and new look. Synchronizer enhancements and parallel threads for slow &FTP; servers (now disabled at the compilation time by default). Single instance mode, start to system tray Context menu for permanent bookmarks. Full support for ACL permissions, like properties, preserve attributes, synchronizer and other. Searcher-results, Locate-results, Synchronizer-results: support for dragging items and copy to clipboard (&Ctrl;C). Many bug fixes. New features in the &krusader;-1.90.0 "Power Stone" release Last release for &kde; 3.x with a big collection of Useractions. New features in the &krusader;-2.0.0 "Mars Pathfinder" release The first release for the &kde; 4.x series &krusader; works on &Windows;! (But not so useful and powerful yet as under &Linux;) Queue manager! Five methods in the panel! New features in the &krusader;-2.1.0-beta1 "Rusty Clutch" release Fast text/hex viewer for huge filesizes. Locked tabs. Queued packing / unpacking. Better trash integration. The quick search, select and filter bar supports regular expressions for matching files. For more features, please read the ChangeLog and SVNNEWS. + + + New features in the &krusader;-2.5.x "Clear Skies" + release + + Ported to &kf5-full;. + + + + The new Quickfilter bar with three different modes to operate: select, search and filter. + + + + Reworked Queue Manager (JobMan) and the new Job Toolbar. + + + + If you are using a development or Git version, it is possible that the latest new features are not yet in the "The &krusader; Handbook". Please read the Changelog file online or in the &krusader; sources to find out more about the new features. For a brief description, please read the SVNNEWS file online or in the &krusader; sources. User feedback and Bug reports are always welcome! diff --git a/doc/menu-commands.docbook b/doc/menu-commands.docbook index caebed51..96b99772 100644 --- a/doc/menu-commands.docbook +++ b/doc/menu-commands.docbook @@ -1,1866 +1,1879 @@ Menu Commands Commands Menu File Menu &Shift; F4 File New Text File Creates a new text file in the current directory, unless another directory is specified. The new file is opened for editing after it is created. F7 File New Directory Creates a new directory in the current directory. &Alt;&Ctrl; S File New Symlink Creates a symbolic link to the currently selected file. F3 File View File Opens the currently selected file for viewing. F4 File Edit File Opens the currently selected file for editing. F5 File Copy to other panel Copy the currently selected files or directories to the other panel. F6 File Move Opens a dialog to move the currently selected files or directories to a specified location. &Alt;&Shift; P File Pack Creates a new archive of all the selected files and directories in the active panel. &Alt;&Shift; U File Unpack Unpacks all the selected files in the active panel. &Alt;&Shift; E File Test Archive Tests archive for corruption. File Compare by Content Compares two current files by content - one from each panel via an external graphical diff utility. By default &kompare; is used, but you can also use ⪚ xxdiff or KDiff3 , change it in the Konfigurator Dependencies page. &Shift; F9 File Multi Rename This menu option starts Krename, a very powerful external batch renamer for &kde; 3.x or newer. Krename Features Renaming a list of files based on a set of expressions Copying/moving a list of files to another directory Convert filenames to upper/lower case Adding numbers to filenames Finding and replacing parts of the filename Renaming MP3/OGG Vorbis files based on their ID3 tags Setting access and modification dates Changing permissions and file ownership A plugin API which allows you to extend KRename's features Renaming directories recursively Support for KFilePlugins Undo renaming And many more.... File Create Checksum Checksum creation on file(s) and/or folder(s). File Verify Checksum Verify Checksum &Ctrl; P File Split File The Split file function splits a file up into multiple smaller files so that it can be stored on several smaller media (like diskettes, zip-drives, ...) or sent by e-mail. &Ctrl; B File Combine Files The Combine files function combines multiple files into one file after the Split file function was used. &Ctrl; Q File Quit Closes &krusader; and cleans up the temporary directory, the same as pressing F10 key. Edit Menu &Ctrl; X Edit Cut Cuts the selected file(s) to the clipboard to be moved to another location. &Ctrl; C Edit Copy Copies the selected file(s) to the clipboard to be moved to another location. &Ctrl; V Edit Paste Pastes previously cut or copied items from the clipboard to the current directory. F9 Edit Rename Renames the currently selected file. F8 Edit Delete Deletes the currently selected file(s). &Ctrl; + Edit Select Group Opens a dialog which allows you to select files in the active panel. In the Search for dialog place the main search criteria. Enter a filename, a wildcard ( *.o.*, *.c &etc;) or both - separated by a space. When using 'text', the results are the same as '*text*'. You can exclude files from the search with '|' (⪚ '*.cpp *.h | *.moc.cpp'). With the profile handler you can manage your selections for future usage. A double-click on a profile is the same as entering the selection and pressing the OK button. More options for Select Group dialog are explained in the Search dialog, which are basically almost the same dialogs. &Ctrl; - Edit Unselect Group The opposite of Select Group. The files that match the pattern in the active panel will be deselected. &Alt; + Edit Select All Selects all files in the active panel. You can also select all directories by activating the Autoselect directories option in the Konfigurator Panel page. &Alt; - Edit Unselect All Unselects all the files in the active panel. &Alt; * Edit Invert Selection Inverts the selection status of all the files in the active panel (&ie; selected files will become unselected and deselected files will become selected). Edit Restore Selection Restore the selection status of previously unselected items. &Ctrl;&Shift; F Edit Find in folder Toggles &krusader; quick search function. &Alt;&Shift; C Edit Compare Directories Toggles &krusader; Compare Directories function. Edit Compare Setup Configures the Compare Directories function. Select Newer and Single (default) Select Single Select Newer Select Different and Single Select Different Edit Calculate Occupied Space Calculates occupied space of files and folders, archives and remote filesystems. &Alt; Return Edit Properties Opens the properties dialog for the currently selected file. (KP refers to Key Pad.) Go Menu &Alt; Up Go Up Navigates to the parent directory of the active panel. &Alt; Left Go Back Navigates to the previously viewed directory in the active panel. &Alt; Right Go Forward Navigates to the next viewed directory in the active panel. Becomes available only if Go Back was used beforehand. &Alt; Home Go Home Navigates to the home directory of the current user. &Ctrl; &Backspace; Go Root Navigates to the root directory of the system. &Ctrl; Z Go Popular URLs Displays a listing of frequently viewed directories from which you may navigate to one by double-clicking on it. &Ctrl;&Shift; J Go Set Jump Back Point Sets the current directory as a "jump back" point. To navigate to this directory quickly, select the Jump Back command from the Go menu. &Ctrl; J Go Jump Back Returns to a previous "jump back" point. View Menu The action in this submenu usually affects the current &krusader; session. If you want to make permanent changes use Konfigurator Startup page. View Zoom In Increase the view scale. View Zoom Out Decrease the view scale. View Default Zoom Reset the view scale. &Alt;&Shift; D View Detailed View Shows the file names, file size, creation date and time and their attributes. &Alt;&Shift; B View Brief View Shows only the file names. &Ctrl; . View Show Hidden Files Toggles the option to display the hidden files in the &krusader; panels. &Shift; F10 View All Files Turns off all filters and display all files. &Shift; F12 View Custom Allows you to install a custom filter on the &krusader; panel. Only files that match the filter pattern(s) and directories will be displayed. Do not forget to deactivate the custom filter after use, or some files may not be visible. View Show Previews If checked, show the previews for all files and folders on the active panel. View Select Remote Charset Selects the remote charset for Remote Connections. &Ctrl; R View Reload Refreshes the contents of the active panel. View Save settings as default Allows you to save the view settings of the current tab for new instances of this view type. View Apply settings to other tabs Allows you to apply the view settings of the current tab to the other tabs. Useractions Menu Useractions Manage User Actions... Opens the UserActions manager. Meta A UseractionsMultimedia Enqueue in Amarok Appends selected item(s) to &amarok; playlist. &Ctrl;&Alt; UseractionsSamples Equal panel-size Sets the ratio between the two panels to 50/50. &Ctrl;E UseractionsSamples Edit as root Allows you to edit a file with kwrite using root permissions. &Ctrl;&Alt;M UseractionsSamples Mount Mounts a new filesystem. &Ctrl;&Alt;C UseractionsSamples Copy current item to clipboard Copies selected item(s) to the clipboard. MetaF5 UseractionsSystem Backup current Backups current file in current directory and asks the user for a new filename. By default .old is appended to the original filename. Meta 1 UseractionsUser Interface Sort By Name When this action is turned on, the main sorting key in the &krusader; panel becomes the file name. Meta 2 UseractionsUser Interface Sort By Extension When this action is turned on, the main sorting key in the &krusader; panel becomes the file extension (the part of the filename after the last '.'). This is useful for grouping files of the same type closer together. Meta 3 UseractionsUser Interface Sort By Size When this action is turned on, the main sorting key in the &krusader; panel becomes the file size. This is useful for determining the largest files in a particular directory. Meta 4 UseractionsUser Interface Sort By Modified When this action is turned on, the main sorting key in the &krusader; panel becomes the last modified date for each file. This is useful for finding files you recently worked on. Useractions Your own Useractions Opens the user actions created by the user. Tools Menu &Ctrl; S Tools Search Opens KruSearcher - the &krusader; search module. &Ctrl;&Shift; L Tools Locate Opens the Locate &GUI; frontend for fast file searching. &Ctrl; Y Tools Synchronize Directories The Synchronize Directories function compares the left and right panels and shows the differences between them. After the compare function, you can move files/directories so that they can be synchronized. This feature is disabled at the compilation time by default. See the link above for the instructions on how to enable it. &Alt; / Tools MountMan Opens MountMan - the Mount-Manager. &Alt;&Shift; S Tools Disk Usage Opens Disk Usage. &Alt;&Shift; Q Tools Queue Manager Opens Queue Manager. &Ctrl; N Tools New Net Connection Opens the New Network Connection dialog to start a &FTP;, SMB, FISH or SFTP connection to a remote host. If you leave the user name and password fields empty, you will login as anonymous. You can Bookmark these remote sessions. &Shift;&Ctrl; F Tools Disconnect From Net Ends the remote connection in the active panel and returns to the start-up path. Tools Start Terminal Opens a terminal window in the default directory (usually your home directory). You can choose your favorite terminal application in the Konfigurator General page. F2 Tools Start Terminal Here Opens a terminal window in the currently browsed directory of the active panel. You can choose your favorite terminal application in the Konfigurator General page. &Alt;&Shift; K Tools Start Root Mode Krusader Starts &krusader; in Root mode at the same location. Root mode &krusader; requires kdesu by default, if kdesu is not available or if you prefer ⪚ gksu when using GNOME you can change this behaviour in the Konfigurator Dependencies page. Be careful when using &krusader; with ROOT PRIVILEGES. Tools Empty Trash Empties the trash bin. Window Menu &Ctrl;&Alt; N Window New Tab Opens a new tab in the active panel. Window Lock Tab/Unlock Tab Locks then unlocks current tab in the active panel. &Ctrl;&Alt;&Shift; N Window Duplicate Current Tab Opens a new tab that is a duplicate of the active tab in the active panel. &Ctrl;&Shift; O Window Move Current Tab to Other Side Moves current tab to the other side of &krusader; window. &Ctrl; W Window Close Current Tab Closes the current tab in the active panel. This command is only available if there is more than one tab in the active panel. Window Close Inactive Tabs Closes all the tabs in the active panel except for the active. Window Close Duplicated Tabs Closes the duplicated tabs in the active panel. &Shift; Right Window Next Tab Navigates to the next tab in the active panel. This command is only available if there is more than one tab in the active panel. &Shift; Left Window Previous Tab Navigates to the previous tab in the active panel. This command is only available if there is more than one tab in the active panel. &Alt;&Shift; L Window Profiles Opens a menu where Panel profiles can be saved and restored. &Ctrl; U Window Swap Panels The left panel will become the right panel and vice versa, only the current tabs will be swapped. &Ctrl;&Shift; U Window Swap Sides The complete left panel will become the right panel and vice versa, and all tabs will be swapped. &Ctrl;&Alt; R Window Vertical Mode Toggles the List Panel between horizontal and vertical mode. &Ctrl; F Window Toggle Fullscreen Terminal Emulator Toggles full screen mode of the terminal emulator. This option is only available when Show Terminal Emulator is activated. Window Save Position Saves the current size and position of the &krusader; main window. This action can be automated with Save last position, size and panel settings in Konfigurator Startup page Settings Menu Settings Show Main Toolbar Shows the Main Toolbar if checked. Settings Show Actions Toolbar Shows the Actions Toolbar if checked. Settings Show Statusbar Shows the Statusbar if chosen. Settings Show FN Keys Bar Shows the FN Keys Bar if checked. &Ctrl;&Alt; T Settings Show Terminal Emulator Show the Terminal Emulator if checked. Settings Show Command Line Shows the Command Line if checked. Settings Command Execution Mode Setup Allows you to choose command execution mode. You can choose one of the following options. Start and Forget: start execution and do not wait for the results. Display Separated Standard and Error Output: show the output to stdout and stderr on the separate panels. Display Mixed Standard and Error Output: show the output to stdout and stderr on the single panel (default). Start in New Terminal: execute the command in the new terminal window. Send to Embedded Terminal Emulator: send the command to the embedded terminal emulator. + + + + Settings + Job Queue Mode + + + + + Toggles the Queue Manager mode. If checked then pressing F2 or the corresponding button in the copy/move dialog immediately starts the job even if there are running jobs in queue. If unchecked then the job will be put into the queue if the queue is not empty. Otherwise the job will be started immediately. + + + Settings Configure Shortcuts Configure Shortcuts Opens a dialog which allows you to configure the &krusader; key bindings. With the Import shortcuts and Export shortcuts buttons you can load and save a Key-binding profile. This allows &krusader; to have the Total Commander, Midnight Commander, foo-commander, or your custom Key-bindings. The only limitation is that global &kde; key-bindings and some &krusader; key-bindings can not be changed yet, as well as some features in foo-commander that we either do not have or need. The Key-bindings are stored in $KDEDIR/share/krusader, foo.keymap.info contains a description, foo.keymap is an ini file that holds the Key-bindings. Until &krusader;-1.70.1 this was a binary file, &krusader; is backwards compatible for importing this legacy binary format. If a *.keymap.info text file exists, &krusader; will display it, showing additional information regarding the loaded Key-bindings file. Here you have a chance to exit without importing the proposed Key-bindings file. A Total Commander Key-bindings file is provided. Please upload your favorite Key-bindings schemes so that they become available for the &krusader; community. Thanks! Settings Configure Toolbars Opens a dialog which allows you to configure the Main Toolbar or the Actions Toolbar. You can add action buttons of your favourite UserActions to the desired toolbar. Settings Configure &krusader; Opens Konfigurator - the &krusader; configuration center. Help Menu Additionally, &krusader; has the common &kde; Help menu items, for more information read the sections about the Help Menu of the &kde; Fundamentals. diff --git a/doc/toolbar.png b/doc/toolbar.png index 71f7cf14..c74e3746 100644 Binary files a/doc/toolbar.png and b/doc/toolbar.png differ diff --git a/doc/user-interface.docbook b/doc/user-interface.docbook index 02f23f43..3205a52f 100644 --- a/doc/user-interface.docbook +++ b/doc/user-interface.docbook @@ -1,861 +1,849 @@ User Interface User Interface OFM User Interface The OFM file manager concept contains many features that make them powerful enough to belong among the best file managers today. The interface is simple: left panel, right panel and a command line below. Because of interaction between these three items the file managing will become more efficient. If you would like to know how &krusader; works you can try it yourself, just install it on your computer. To accept an Orthodox File Manager (OFM) like &krusader;, the user needs to get used to new ideas that are actually already 20 years old. If you prefer to waste time and lose a lot of productivity, you can always continue to use one panel file managers that are based on &Windows; Explorer. &krusader; Main Window -
&krusader; Main Window &krusader; Main Window
The User Interface is based on Orthodox File Manager (OFM) paradigm, a 20- year old principle that has proven its bones. It is known as simple, easy and powerful. In the following sections we will cover the basic functions of each part with the exception of: The Menu Bar which has a chapter of its own. The Bookmarks which has a chapter of its own. The Status Bar shows the properties of the current file (that is being) in focus. Toolbars &krusader; comes with several Toolbars. Main Toolbar Toolbar Main Toolbar -
Main Toolbar Main Toolbar
- The &krusader; Main Toolbar, is a standard + The &krusader; Main Toolbar is a standard &kde; toolbar that can be dragged around the - application or configured via a + application (please unlock it first by unchecking the Lock + Toolbar Positions item in the right-click menu) + or configured via a Right-Click menu. You can decide whether or not you want to display it each time you start &krusader; in the Konfigurator Startup page, and you can toggle its use in the current session in the Settings menu. The Main Toolbar contents can be configured from the Configure Toolbars in the Settings menu. Since various commands and options in &krusader; are context-dependent, some commands are not always available. The icon of an inappropriate or inactive action will be deactivated (grayed-out) disabling its use. Bookmarks can be placed into the Main Toolbar and the Actions Toolbar with the mouse using "drag and drop". + + Job Toolbar + By default, the &krusader; Job Toolbar (Queue + Manager or simply the JobMan) is located at the right part of the + Main Toolbar. This toolbar allows you to view the job progress, to pause + and resume the job list execution and to undo the last executed job. + Actions Toolbar Toolbar Actions Toolbar UserActions and Bookmarks can be "plugged" into the Actions Toolbar. To show it, use Settings Show Actions Toolbar . To add user actions, use Settings Configure Toolbars and select Actions Toolbar. You can, for example, drag the Actions Toolbar to the right side using the mouse. Location Toolbar Toolbar Location Toolbar Below the Main Toolbar there is a Location Toolbar for each panel. It shows the path the panel is currently pointing to. When entering archives the path will be displayed in the following format: "archive type:/directory/archive_filename/the directory inside the archive". This format makes the paths uniform and easy to read. The Location Toolbar supports also KIO Slaves but not all of them, some can only be used with the viewer and some can not be used. The user can enter a desired path by clicking on it. /mnt/cdrom/ settings:/ will browse and open entries of the System Settings. trash:/ opens &kde;'s trash. ipod:/ uses the KIOipod-slave to access, upload and organize the music stored on Apple ipod. And last but not least Remote Connections . You can copy-paste a &URL; in the Location Toolbar or use a middle click. With the Right-Click menu you can configure the auto-complete function. An optional Clear Location Toolbar button is also available. Quick Navigation: &Ctrl; point with mouse in the middle of &URL; of the Location Toolbar. A pop-up window shows the next &URL; location. Pressing &Ctrl; + Left Mouse Button shows the location where the mouse was pointing to. This feature allows faster navigation in a big directory tree. Panel Toolbar Toolbar Panel Toolbar Each panel has a configurable Panel Toolbar. The complete Panel Toolbar or specific buttons can be made visible or be hidden. OpenDir Button: opens the directory browser. Equals Button (=): changes the panel directory to the other panel directory. Up Button (..): changes the panel directory to the parent directory. Home Button (~): changes the panel directory to the home directory. Root Button (/): changes the panel directory to the root directory. Sync-browsing Button: when active, each directory change in the specific panel is performed in the other panel as well. Panels The &krusader; panels are where most of the action takes place. Currently, there are two types of panels: List Panel: shows the files and directories. PopUp Panel: has several display modes: Preview, Tree, Quickselect, View and Disk Usage for the file or directory that has the focus. The PopUp Panel may be left open or closed, as desired. &krusader; is a "twin-panel" file manager so there are two panels: the "Left" panel and the "Right" panel, or a more important logical distinction, the *Active* panel and the *Inactive* panel. The active panel is the one that will accept your mouse and keyboard input. If you choose a command from the Menu-Bar or Toolbar the command will act upon the selected files/directories in the active panel. You can switch between panels using the key or by clicking on the Information or Totals labels, or by selecting any file in a panel with the mouse. As always, default startup settings can be modified with the Konfigurator Startup page, and you control the current session with the Settings menu.
List Panel List Panel
List Panel Panel List Panel This is the default panel and the one you will probably use most of the time. This panel shows the contents of one directory which can be local (part of your mounted file systems, either a native file or the files inside an archive) or remote files (accessed via &FTP;, NFS or Samba). There are two modes: Detailed View that shows the file names, file size, creation date and time and their attributes. And Brief View that shows only the file names, the number of brief columns can be changed, by right clicking on the Name header. File copy/paste/cut via clipboard between &konqueror; and &krusader; &Ctrl; C, &Ctrl; V, &Ctrl; X is supported. &Alt;&Ctrl; R toggles the List Panel between horizontal and vertical mode. The following items are available: Information Label : shows how much free space is physically available on the file system, the file system capacity and where the filesystem is mounted. If the information is not available (most often in the case of remote file system) a message will be displayed with the reason for unavailability instead of the information. The Media button on the left of the Information Label displays a list of all available media, where you can select the desired media (HDD partition, DVD, USB stick, &etc;). Pressing &Ctrl;Return when the Media menu is opened mounts the highlighted media when it is unmounted, and unmounts it when it is mounted. The context menu of a medium gives several options like Mount, Open in a new tab, &etc; The Media menu is configurable. Column Headers : here you can change the sort order of the files and directories as desired. The default sort order is by Name. The sort order can be instantly changed by clicking on one of the Column Headers. To reverse the sort order, click a second time on the Column Header. An arrow will appear on the right of the Column Header text, showing the sort direction (Up arrow = A to Z sorting, Down arrow = Z to A sorting). Default UserActions set a keybinding for the Column Headers. The default Column Headers are: Name, Ext, Size, Modified, rwx. Predefined Atomic extensions like .tar.gz are shown as one part in the Ext Column. More optional Column Headers are available with the &RMB;. The width Column Headers can be changed with the mouse by single clicking and moving the divider line to the desired width (keep the mouse button pressed). Both List Panels remember the sort order and column width. The Column Headers can be changed and saved individually to each panel. File List : displays the files and directories in the browsed directory. The search bar allows you to search for files by typing their names, or the first few characters of a file name. Pressing &Enter; or double clicking on a file will open/execute that file. You can select/unselect files using the mouse, with the Insert key or the Edit menu. Totals Label : selecting or deselecting files will change the Totals Label : selecting or deselecting files will change the Totals Label at the bottom of the panel, which displays how many files you have selected (and how much total disk space they use) as well as the total file and disk usage of the current directory (as opposed to the information label that displays information for the whole file system). If a directory contains a lot of subdirectories, it may not be possible to drop the &URL; onto the panel (on which only directories are visible), but the &URL; can be dropped onto the "Information Label" or "Totals Label" instead. When a custom filter is set, it will show the setting, example: [*.cpp]. When using the "&kde; default colors", then the selected files are shown in blue and the current file is surrounded by a fine-lined rectangle. By default an icon is shown according to the file type. Use Konfigurator Panel page to change the default configuration to meet your individual needs. Some useful List panel Key-Bindings: &Ctrl; R will refresh the panel. Focus a file or directory on the left panel, press &Ctrl; Right arrow and the right panel changes: On a file: the right panel gets the same path as the left panel. On a directory: right panel opens the directory focused on the left panel. For the right panel: press &Ctrl; Left arrow and the left panel will change. PopUp Panel Panel PopUp Panel (3rd Panel) This is "&krusader; is 3rd Hand" or the 3rd Panel, click on the arrow-up button on the right of the Totals Label or &Alt; Down-Arrow to open the PopUp Panel. This panel has several display modes which can be activated by clicking on the appropriate button. Preview Panel : gives a preview of the file that has the focus (currently selected file). Tree Panel : is used to quickly browse the local directory tree. This panel behaves like the list panel but only one directory may be selected at a time and double clicking or pressing &Enter; on a directory will open that directory in the active panel. The panels fully support drag and drop (copy, move, link) mouse actions. Quick Panel : is used to quickly select files, ⪚ enter *.png and click on the Go button. The "floppy" button stores the current selection. The "select group dialog" is also available. Viewer Panel : views a text file, views an image, &etc; A thumbnail view is generated whenever you open the Viewer Panel. Disk Usage Panel : views the Disk Usage of a directory. It is possible to change the popup panel placement using the rotation button which is located to the left of the arrow down button at the bottom part of the &krusader; tab. Each click on this button moves the popup panel on one position in the loop "bottom-left-top-right". If needed you can resize the window ⪚ to better display a picture or view a file contents. Click on the arrow down button to close the 3rd Hand Panel. Folder History Both panels remember recently visited folders. Click on the Folder history button ("watch" symbol) to open the folder history list. Here you can quickly change to previously visited folders. The currently focused folder is checked. On every new start of &krusader;, the history list is populated by the items from previous run (history is saved). Command Line / Terminal Emulator This part of the GUI can have four modes: Command Line, Terminal Emulator, show both and show none. You can choose your mode of operation either on start-up with the Konfigurator Startup page, or for the current session with the Settings menu . Command Line
Command Line Command line
The traditional command line mode offers a single line of input to enter commands, it also features three buttons: command history (down arrow) to quick open previous used commands Useraction expander (green plus button) to add easy Useraction placeholders run in terminal mode (console icon) button with the next options: Start and Forget Display Separated Standard and Error Output Display Mixed Standard and Error Output Start in New Terminal Send to Embedded Terminal Emulator When you start typing your commands, the command line auto-completion feature will make its offers according to what you choose in the &systemsettings;. If you want to change the way auto-complete behaves in the current &krusader; session, right click on the command line and change it. To the left of the input line you can find the local path that the active panel is currently pointing to. This path is where your command will be executed. Typing cd <directory> in the command line will also cause the active panel to point to this directory. Click here to view the command line keybindings. Terminal Emulator
Terminal Emulator Terminal emulator
The terminal emulator mode is in fact a small console and acts like one. You can change the active directory in the terminal by using the cd command. The terminal emulator will follow the active panel directory. You can drag a file from the List Panel and name of file will pasted into Terminal Emulator. If you drag multiple files, the names will pasted into Terminal Emulator. A full-screen terminal emulator can be used when configured or &Ctrl; F toggles between normal and full screen mode. If the command line is hidden, press &Ctrl; Arrow down to focus the terminal emulator. &Ctrl; Arrow up brings you back down. &Ctrl;&Enter; and &Ctrl; &Shift; &Enter; paste the filename. You can close the emulator by typing exit . Click here to view the Terminal emulator keybindings. Function (FN) Keys Bar
Function (FN) Keys Bar Function (FN) Keys Bar
This bar gets its name from the function (FN) keys it represents. For each button on this bar there is a corresponding function key that performs the same action. This bar is derived from the design of the first twin-panel file managers and the FN keys usually act the same way with two changes: the F2 key will open a terminal at the last local path that the active panel pointed to, and the F9 key is used to rename files. Mkdir F7 can create whole directory trees on the fly ⪚ foo/bar/test. You can choose to display or not the FN keys bar when starting up &krusader; via the Konfigurator Startup page, and you can toggle its use in the current session with the Settings menu. The actions and Key-Bindings performed by the function keys are configurable since version 1.51, they will remain active with or without the FN keys bar displayed. Folder Tabs
Folder Tabs Folder Tabs
With Folder Tabs you can quickly change to multiple folders; each panel has its own Folder Tabs. The Folder Tabs positions are saved when closing &krusader;. To switch between Folder Tabs, click them with the mouse. Squeezed Folder Tabs have tooltips to display the full path. The following Folder Tabs operations are available: To open a new tab and keep the current tab opened: Right-click on a directory and select Open in New Tab, or use &Ctrl;&Alt;N. To lock a tab, Right-click and select Lock Tab. To duplicate a tab: Right-click on the folder tab and select Duplicate Current Tab, or use &Ctrl;&Alt;&Shift; N. To close a tab (except for the last tab): Right-click on the tab and select Close Current Tab, or use the &MMB;, or use the Folder tab red cross button, or use &Ctrl; W. To create a "home" tab: click on the Home button. To change tabs: &Shift; Left Arrow or &Shift; Right Arrow. To open the current folder in a new tab: use &Ctrl;&Alt;&Enter;. To close all other tabs, Right-click and select Close Inactive Tabs. To close duplicated tabs, Right-click and select Close Duplicated Tabs. To move tab on the other panel, drag it to the area of the other panel with the &LMB; (the mouse cursor will become an arrow pointing left or right) and drop it. Buttons Several buttons for fast operations are available: Main Toolbar, Actions Toolbar, Panel Toolbar, Location Toolbar, Media, Folder history, Bookmarks, Tab, Commandline, Function keys.