diff --git a/doc/diskusage.docbook b/doc/diskusage.docbook index 831aac64..44e40ca6 100644 --- a/doc/diskusage.docbook +++ b/doc/diskusage.docbook @@ -1,138 +1,118 @@ Disk Usage Disk Usage The Disk Usage is based on the code of Filelight. The Disk Usage shows you how your disk space is being used by a graphical representation of your file system. The following presentations are possible: Line view Detailed view Filelight view: as a set of concentric segmented-rings Choose Tools Disk Usage or &Alt;&Shift; S to start this feature in a separate window, or open it inside the Sidebar. Disk Usage Keybindings, right click menu. Del: Delete &Ctrl; E: Exclude &Shift; Arrow Up: Up one directory &Ctrl; N: new search &Ctrl; R: refresh &Ctrl; I: include all &Shift; Arrow Down: step into View menu: &Ctrl; L: Line view &Ctrl; D: Detailed view &Ctrl; F: Filelight view &Shift; Arrow Right: Next view &Shift; Arrow Left: Previous view - - diff --git a/doc/introduction.docbook b/doc/introduction.docbook index 7df076e5..2002764c 100644 --- a/doc/introduction.docbook +++ b/doc/introduction.docbook @@ -1,162 +1,151 @@ Introduction Introduction Package description &krusader; is a simple, easy, powerful, twin-panel file manager (commander-style) for &plasma; and other *nix desktops, similar to Midnight Commander or Total Commander. It provides all the file management features you could possibly want. Krusader also includes extensive archive handling, mounted file system support, &FTP;, advanced search module, viewer/editor, directory synchronization, file content comparisons, powerful batch renaming and much, much more. &krusader; supports archive formats: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip and handles other KIO Slaves such as smb:// or fish://. &krusader; is almost completely customizable and therefore very user-friendly. Try &krusader;. -
&krusader; screenshot &krusader; screen shot
More &krusader; Screenshots can be viewed on our website. Welcome to &krusader;! Our aim is to give you a simple, intuitive tool that easily handles the most important tasks you perform on your computer each and every day: manage and process your files the way you want. Whether you are a &Linux; expert or a novice, &krusader; makes routine file management tasks quick and accurate, allowing you to focus on the big picture, not command line syntax. This is especially helpful if you are new to xxNIX operating systems. To do just that, &krusader; uses a good-looking &GUI; and supports drag and drop as well as MIME types, making it easy to use. &krusader; has many useful features. It is fast, and handles archives transparently. In addition, &krusader; streamlines many complex file management tasks, reducing fatigue, errors, and distraction. Basically, &krusader; provides all the helpful features you have come to expect from other quality file management tools like Midnight Commander and Total Commander. &krusader; is designed to integrate seamlessly with the &plasma;, the desktop of choice for many programmers, network engineers, and other power users of &Linux;. With &krusader; even novice users can quickly access the power, convenience, and feature rich capabilities of the &plasma;. &krusader; is a free open-source project, and it is released under the &GNU; General Public License (GPL), although the developers still retain the copyright for the project and its name, and manage the project's continuing evolution. The &krusader; Project mission is to create an "all-in-one" file manager, which will do all the ordinary things you would expect of it, and more. Since the principle behind &krusader; is based on the Orthodox File Manager (OFM), dual-pane filemanagers (Midnight Commander, Norton Commander, &etc;), it is certain that &krusader; is able to handle all the standard Copy, Move, Delete, &etc; file operations. From the start, virtual file systems became the main focus. Virtual file systems (VFS) are an abstracted layer over all kinds of archived information (ZIP files, &FTP; servers, TAR archives, NFS filesystems, SAMBA shares, ISO CD/DVD images, RPM catalogs, &etc;), which allow the user to access all the information in these divergent types of file systems transparently - just like entering an ordinary sub-directory. Files can then be copied or moved around (except ISO, rpm, tar.gz) between these data sources/containers effortlessly. &krusader; currently supports VFSs for all popular and some specialized types of archives (ace, arj, bzip2, gzip, iso, lha, rar, tar, zip and 7-zip), configuration packages (rpm, deb), and traditional remote file system types (&FTP;, NFS, Samba, FISH, SFTP). &krusader; also includes a built-in Mount-Manager MountMan, which enables you to mount or unmount file systems of all types with a click of a mouse. The user is able to obtain usage and other property information easily, in a consistent and understandable format in seconds. Ease and consistency is the goal. A Bookmark-Manager for local files/remote &URL;s and an Advanced Search module is also included to speed the locating of needed files. &krusader; also allows the user to configure Toolbars in order to provide a wide variety of additional functionality, such as File Comparison (several user selectable methods available), Multiple File Rename, and standard Terminal windows. Advanced users benefit greatly from being able to carry out clerical tasks effortlessly, without distraction from the real task at hand. Convenient shortcut keys enable the user to navigate directory trees with ease, create multiple tabbed directory views simultaneously, and access fully functional history lists. Due to efficient programming and low system overhead, &krusader; is perhaps the most responsive all around system management tool used to access the full potential of a computer using &plasma;, or any other standards compliant &X-Window; window manager. Although designed specifically for - and tightly integrated with - &plasma;, &krusader; works equally well with GNOME, MATE, Enlightenment, &windowmaker;, IceWM, XFCE, &etc;, as long as the &kf5; libraries are installed. New extensibility is provided by the flexible UserActions, a &krusader; innovation that allows unlimited additional custom functionality to be added to suit the specific needs of users. We are planning to develop more modules in the near future, thereby enhancing &krusader;. Information on what is proposed, approved, or remains to be completed can be found in the &krusader; Phabricator page. No other program we know of, offers so many useful, easily accessible features in such an intuitive and simple format. Best of all, we listen, and implement good suggestions that are consonant with the &krusader; Project's goal: making &krusader; the very best File Manager available. We hope you will enjoy it - we do! diff --git a/doc/keyboard-commands.docbook b/doc/keyboard-commands.docbook index 889592cc..16d25192 100644 --- a/doc/keyboard-commands.docbook +++ b/doc/keyboard-commands.docbook @@ -1,2039 +1,2031 @@ Keyboard Commands Commands Keyboard Keyboard Usage In this chapter you will learn how to use the keyboard effectively, because most operations can be done more quickly by keyboard than with the mouse. It will take some time to learn the Key-Bindings, but mastering them saves you a lot of time. Please note that &krusader; can use Key-binding Profiles to swap easily to other Key-binding setups, ⪚ of other commanders, or you can create your own key-bindings. After starting &krusader;, the keyboard action can begin. Use &Ctrl;L to jump to the Location Toolbar where you can type the desired directory. After &Ctrl;Down arrow you are in the Terminal emulator and you can type any command you desire. Use &Ctrl;Up arrow to jump back to the active panel. If you want to jump to a file or directory that starts with f, then simply press f on the keyboard to use the search bar. Use the &Enter; key to execute the file or to open a directory that has the focus. Be sure to remember the Function Keys - F3 to View, F4 to Edit, F5 to Copy, &Alt;&Shift;U to Unpack, &etc; You can also perform several operations with the Folder tabs, including several selection operations. And at the end you can close &krusader; with F10. Key-Bindings Key-Bindings Commands Keyboard Most of the key-bindings (shortcuts) are configurable in the Settings Configure Shortcuts menu, if you like to use other key-bindings then the default ones. You can even configure more actions to a Key-Binding (for the actions that do not have a key-binding set by default). Please note that some key-bindings are not &krusader; key-bindings (⪚ &plasma; key-bindings). The key-bindings that &krusader; uses by default are listed below. Function (FN) Keys These are the Key-Bindings of the FN Keys Bar. These Key-Bindings are configurable since version 1.51. F1 Help F2 Rename files. F3 View files. F4 Edit files. F5 Copy files. F6 Move files F7 Create a new directory. F8 Delete (or move to Trash) files. F9 Terminal. F10 Quit &krusader; &Shift; keys &Shift; F1 What's this? &Shift; F2 Multi-rename (Krename). &Shift; F3 Enter an &URL; to view. &Shift; F4 Edit new file. &Shift; F5 Copy by queue. &Shift; F6 Move by queue. &Shift; F10 View all files. &Shift; F12 Custom view files. &Shift; Left Arrow Change to left folder tab. &Shift; Right Arrow Change to right folder tab. &Alt; keys &Alt; + Select All. &Alt; - Unselect All. &Alt; * Invert Selection. &Alt; . Show/Hide hidden (dot) files. &Alt; / MountMan. &Alt; ` User Menu &Alt; Home Home &Alt; &Enter; Properties. &Alt; Left Arrow Left bookmarks. &Alt; Right Arrow Right bookmarks. &Alt; Down Arrow Sidebar. &Alt; F1..F12 Standard (&plasma;) key-bindings. &Alt;+&Shift; keys &Alt;&Shift; B Brief View &Alt;&Shift; C Compare Directories &Alt;&Shift; D Detailed View &Alt;&Shift; E Test Archive. &Alt;&Shift; K Start Root mode &krusader;. &Alt;&Shift; L Panel profiles. &Alt;&Shift; O Sync panels aka "Equals Button (=)". &Alt;&Shift; P Pack files. &Alt;&Shift; Q Queue Manager &Alt;&Shift; S Disk Usage. &Alt;&Shift; U Unpack files. &Ctrl; keys &Ctrl; B Add bookmark for the current item. &Ctrl; D Open Bookmarksin the active panel. &Ctrl; E Edit file as root (Default Useraction). &Ctrl; F Open Quicksearch bar. &Ctrl; H Open History list in the active panel. &Ctrl; I Open QuickFilter bar. &Ctrl; J A Safari-like Jump-Back. &Ctrl; L Go to the Location Toolbar (origin) as in Firefox and &konqueror;. &Ctrl; M Open media list. &Ctrl; N New Network Connection dialog. - &Ctrl; O Select directory dialog to open this directory in the panel. &Ctrl; P Split file. &Ctrl; Q Quit &krusader;. &Ctrl; R Reload (Refresh) panel. &Ctrl; S Search. &Ctrl; U Swap panels (do not swap all folder tabs). &Ctrl; W Close Current tab. &Ctrl; Y Synchronize Directories. &Ctrl; Z Popular URLs. &Ctrl; + Select group. &Ctrl; - Unselect group. &Ctrl; / Open command line history list. &Ctrl; Down arrow Go from the active panel to the command line/terminal emulator. &Ctrl; Up arrow Go from the command line/terminal emulator to the active panel. &Ctrl; Up arrow Go from the active panel to the Location Toolbar. &Ctrl; Home Jump to the Home directory. &Ctrl; Left or Right arrow Focus a file or directory on the left panel, press &Ctrl; Left arrow and the right panel changes: on a file: the right panel gets the same path as the left panel. on a directory: refreshes the right panel with the contents of the directory. For the right panel: press &Ctrl; Right arrow and the left panel will change. &Ctrl;&Backspace; Jump to the Root directory. &Ctrl; PageUp Up one directory. &Ctrl; = Go to the directory from other panel. &Ctrl; Return When media menu is open (un)mounts the highlighted device. &Ctrl;+&Shift; keys &Ctrl;&Shift; D Disconnect remote connection. &Ctrl;&Shift; F Activate search bar to find entries in the active tab. &Ctrl;&Shift; J Set jump back point. &Ctrl;&Shift; L Locate &GUI; frontend. &Ctrl;&Shift; O Move current tab to other side of the window. &Ctrl;&Shift; S Open Quickselect bar. &Ctrl;&Shift; U Swap Sides (also swap all folder tabs). &Ctrl;&Shift; Left arrow Open left media list. &Ctrl;&Shift; Right arrow Open right media list.. &Ctrl;&Shift; Up arrow Open terminal emulator, independently, whether the command line is shown or not. &Ctrl;&Shift; Down arrow Close terminal emulator, independently, whether the command line is shown or not. &Ctrl;&Shift; PageUp Move current tab to the left. &Ctrl;&Shift; PageDown Move current tab to the right. &Ctrl;+&Alt; keys &Ctrl;&Alt; M Mount (Default Useraction). &Ctrl;&Alt; N New tab. &Ctrl;&Alt; R Toggle the List Panel between horizontal and vertical mode. &Ctrl;&Alt; S Create a new symlink. &Ctrl;&Alt; T Show/hide the embedded terminal. &Ctrl;&Alt; Left Arrow Left History list. &Ctrl;&Alt; Right Arrow Right History list. &Ctrl;&Alt; = Equal Panel Size (Default Useraction). &Ctrl;&Alt;&Shift; N Duplicate a tab. &Ctrl;&Alt;&Enter; Open current folder in a new tab. General &Ctrl; keys &Ctrl; A Select all. &Ctrl; PageDown Move to the lower part in the current directory. &Ctrl; F1..F12 Standard (&plasma;) key-bindings. &Ctrl;&Shift; F1..F12 Standard (&plasma;) key-bindings. Other keys foo Quick search, quick select or quick filter. See this configuration page on how to configure the default mode. Switch between the panels &Enter; On a file: open/execute that file On an archive file: browse the archive as if it was a directory. &Esc; Will make the menu bar lose the focus if it has it. Delete Delete (or move to Trash). &Shift; Delete Delete permanently. Space On a file: toggle the selection of the file down one position without affecting the selection of other files/directories. &Backspace; One directory up. Insert Does the same as the Space key and goes down one position to toggle the next file. Menu Right-click menu. Home Cursor jumps to the top of the list. End Cursor jumps to the last file in the list. Command Line Command Line keybindings. Up arrow and Down arrow Scroll through previously typed commands. &Ctrl; / Open the command line history list. &Ctrl; Up arrow Jump from the command line to the active panel. &Ctrl; Down arrow Jump from the active panel to the command line. &Ctrl;&Enter; Insert current file / directory name without path to current command line position. &Ctrl;&Shift;&Enter; Insert current file / directory with full path name to current command line position. - Terminal emulator Terminal emulator keybindings. &Ctrl; F Toggle between normal and full screen Terminal emulator. &Ctrl; V Insert from clipboard. &Ctrl; Up arrow Jump from the Terminal Emulator to the active panel if the Command line is hidden. &Ctrl; Down arrow Jump from the active panel to the Terminal Emulator if the Command line is hidden. &Ctrl;&Shift; Up/Down arrow Always focus/unfocus the Terminal Emulator independently whether the Command Line is shown or not. &Shift; Insert Insert from clipboard. - - Synchronizer Synchronizer keybindings. &Ctrl; W Reverse direction &Alt; Down arrow Exclude &Alt; Up arrow Restore original task &Alt; Left arrow Copy to left &Alt; Right arrow Copy to right &Alt; Delete Mark for delete Default Useractions Default UserActions keybindings provided by &krusader;. &Ctrl; E Edit a file as root. &Ctrl;&Alt; C Copy current item to clipboard. &Ctrl;&Alt; M Mount a new file system. &Ctrl;&Alt; = Equal panel-size. Meta A Enqueue in &amarok;. Meta 1 Sort by Name. Meta 2 Sort by extension. Meta 3 Sort the active panel by size. Meta 4 Sort by modified. Meta F5 Backup current file (Default Useraction). Other Key-bindings Selecting files KrViewer Disk Usage Locate &GUI; frontend &systemsettings; -> Common Appearance and Behavior -> Shortcuts and Gestures UserActions configurable key-bindings diff --git a/doc/search.docbook b/doc/search.docbook index d9ae3924..633099dc 100644 --- a/doc/search.docbook +++ b/doc/search.docbook @@ -1,364 +1,342 @@ KruSearcher: find what you are looking for Search Welcome to &krusader;'s powerful search module - nicknamed KruSearcher. It is the most able tool (that we know of) for &Linux;, since it allows so many different ways to quickly find the file you are looking for. The search function is also available on remote file systems. It is divided into two levels, the general and the advanced. Let's take a look at the general page. -
General Search General Search
The page is divided into four parts: top (search for) part, bottom part - titled Containing text, left part - titled Search in and right part which is called Do not search in. Obviously, each part handles different aspects of the search. Let's look at them closely. Top Part: Search for: here you enter the main search criteria. You can enter a file name, a wildcard ( *.o.*, *.c &etc;) or both - separated by a space. If you type 'text' the results is the same as '*text*'. You can exclude files from the search with '|' (⪚ '*.cpp *.h | *.moc.cpp') . You can use quotation marks for names that contain spaces. Filter "Program Files" searches out those files/directories the name of which is Program Files. Case sensitive: unchecking it will allow lower and upper case search (&ie;: *.c interprets as *.c AND *.C). Of type: this box lets you search for a file not only by its name, but also by its MIME type. For example, you can search for all the audio files whose name begins with B. Usually this option defaults to 'all files', but you can choose to search for archives, directories, images, text files, videos and audio files. Left and Right Part: Search in and Do not search in: Using those two parts, you can specify a search exactly the way you want it. For example, you might want to search for a file in the whole file system (beginning with /), but do not want to search inside /mnt. All you need to do is write / in the Search in box, and write /mnt in the Do not search in box. If you want to enter more than one directory in one of the list boxes, just type the first name and press &Enter;. The directory name will be copied to the bigger list box and you will be able to enter another name. The input line has an auto-completion feature, corresponding to &plasma; global settings. If you wish, you can click on the folder icon, and browse to the directory you wish to add. It is possible to define files and directories which will be filtered out from the search results using the Exclude Folder Names input field at the bottom of the Do not search in box. Items in the filtering list should be space-separated. Spaces in the filtering list items can be escaped or quoted. Example: .git "target build" build\ krusader Bottom Part: Text: entering text here makes &krusader; search for it inside the files ( grep). This way you can search for all header files ( *.h) which include the word 'testing 123'. RegExp switch: toggle the regular expressions mode. A drop-down list that is shown after clicking down arrow on the right allows you to enter special symbols of regular expressions. Encoding: allows you to choose the text encoding. Match whole word only: allows you to specify that a complete match (letters and length) must be found. Case sensitive: refers to your text being searched for in upper and lower case or the exact phrase you entered. Search in sub folders: perform a recursive search and dive into every directory on the way. Search in archives: &krusader; will search for your files inside every supported archive. This, however, takes longer to perform. If you check this checkbox, you will notice you cannot grep inside files anymore. This is done, since looking inside archived files forces &krusader; to extract them, which results in an extremely time-consuming search. Follow links: if checked, &krusader; will follow soft-links during the search. Profiles: if you have to regularly perform the same search operation, you can save the search settings ⪚ include files, exclude files, &etc;... Press the 'profile' button, and you can add/load/save/remove search profiles. Query to clipboard: if checked, &krusader; will place search text to clipboard when a found file is opened. The above screen shot shows a search for all the files which end with c, cpp or h and include the string 'testing 123'. &krusader; will search in /root, /opt, /bin and /usr, but not in /usr/lib and /usr/share. Clicking the Search button starts the search and displays the results page. During the search, you may press the Stop button to stop the search. The Close button is not operational during a search, so you must first stop the search and then Close the window. When a result is found, double-clicking on it will take &krusader;'s active panel point to the found files - but will not close the search window, so you will be able to click on a different result. Sometimes, you need to narrow your search even more. Krusearcher allows a much finer search, and for that, let's look at the Advanced Page... -
Advanced Search Advanced Search
This screen shot shows a search for files whose size is between 10KiB and 150KiB, which were modified between October 10th and November 1st, which belong to any user in the 'nobody' group, and are readable and writable by anyone in the 'nobody' group, but only readable to the rest of the world. The advanced page is divided into three parts: size, date and ownership. Size Allows you to choose the size range of the file you are looking for. By checking the check boxes, you can search for a file which is bigger than XXX bytes (or KB, MB), smaller than XXX bytes or, by checking both search for a file which size is bigger than XXX but smaller than YYY. Date This part offers three different ways of defining a date criteria: Modified between: allows you to enter two dates. &krusader; will search for files with a modification date between the first date and the second one, inclusive. You can click on the date icon (near the input boxes) to open a standard date window - which allows you to easily browse through the calendar and search for the desired date. Clicking on a date will close the window and the date will appear in the input box. Not modified after: choosing this option makes &krusader; search for files that were NOT modified after a given date, which is the same as searching for files older than that date. Modified in the last/not modified in the last: in these input boxes, you do not enter a date but a number. This number represents days/weeks/months (as chosen in the near drop box). Entering the number 5 in the upper input box, makes &krusader; search for files that were modified in the last 5 days. Entering the number 2 in the lower input box makes &krusader; search for files that did NOT change in the last 2 days. The combination of both results in a search for files that were changed in the last 5 days, but NOT in the last 2 days. Ownership Belongs to user/group: by checking each of the corresponding check boxes, you can search for files which belong to a certain user and/or group. The drop box lists all the user names and group names in the system, just choose one and go ahead. Permissions: divided into owner, group and all - it allows you to choose certain permissions for the file. You can choose to specify permissions for the owner, group, all or any combination. The question mark (?) is a wildcard - which means that any permission is valid. To clarify, the screen shot above (the ownership part) describes a search for files that belong to any user in group 'users', are readable, writable but not executable to any user in the group, are readable but not writable or executable to the rest of the world and have unknown permissions to its owner. Results Clicking on the Search button to start the search and open the Results window. Here you can see the progress and the results of the search action. If you want you can stop the current search action with the Stop button. In the result list select the file and use F3/ F4 to view/edit or use the right-click menu. When you click on a found item, the directory of the active panel will change if the selected item is not in the current panel directory. The results window supports dragging items to other windows and copy to clipboard (&Ctrl;C). When you close the Krusearcher window, the selected item is selected in the active panel. Feed to listbox When you click the Feed to listbox button after the results are displayed, then &krusader; ask for a Query Name, this name will be used in the Results-Tab in the List Panel that holds the search results. You can do whatever you want on the files in the new tab. The location toolbar will display ⪚ virt:/Search results 1. The files in the Results-Tab are actually the original files. if you delete a file - it is removed!