Editing Quickstart Tutorial
Jump to navigation
Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
+ | '''TODO:''' This should cover all of the most basic Tasks | ||
+ | |||
+ | '''TODO:''' I'll keep updating this with my biggest bumps in the learning curve as well. | ||
+ | |||
This first part should give just enough information to allow the new user to | This first part should give just enough information to allow the new user to | ||
navigate through the tree to any file/dir, open the file, and pass commands to the shell. | navigate through the tree to any file/dir, open the file, and pass commands to the shell. | ||
− | = The | + | == The Bare Essentials == |
− | == Launching | + | === Launching Vifm === |
− | === Run Vifm from a | + | ==== Run Vifm from a Terminal ==== |
''Without arguments'', like in | ''Without arguments'', like in | ||
Line 15: | Line 19: | ||
Vifm with no configuration starts with both panes in current directory of a | Vifm with no configuration starts with both panes in current directory of a | ||
− | shell | + | shell. |
− | |||
− | |||
− | |||
− | ''With single argument'', like in | + | ''With single argument''', like in |
<source lang="bash"> | <source lang="bash"> | ||
Line 40: | Line 41: | ||
See also [[Starting Vifm]]. | See also [[Starting Vifm]]. | ||
− | === Quitting === | + | ==== Quitting ==== |
Using normal mode (main mode, in which Vifm starts) shortcut <kbd>ZZ</kbd>. | Using normal mode (main mode, in which Vifm starts) shortcut <kbd>ZZ</kbd>. | ||
Line 46: | Line 47: | ||
Or with the help of command-line mode (the one entered after <kbd>:</kbd> is | Or with the help of command-line mode (the one entered after <kbd>:</kbd> is | ||
pressed) command <code>:q</code>, which should be followed by the | pressed) command <code>:q</code>, which should be followed by the | ||
− | <kbd>Enter</ | + | <kbd>Enter</kdb> key to be executed. |
See also [[Quitting Vifm]]. | See also [[Quitting Vifm]]. | ||
− | == Navigation == | + | === Navigation === |
Movements are very much Vim-like. The main four keys are the same: <kbd>h</kbd>, | Movements are very much Vim-like. The main four keys are the same: <kbd>h</kbd>, | ||
Line 70: | Line 71: | ||
Navigation between panes: <kbd>space</kbd> or <kbd>tab</kbd> (same as <kbd>Ctrl-I</kbd>) - switch active pane. | Navigation between panes: <kbd>space</kbd> or <kbd>tab</kbd> (same as <kbd>Ctrl-I</kbd>) - switch active pane. | ||
− | == Modes == | + | === Opening files === |
+ | |||
+ | '''TODO: cover following topics''' | ||
+ | |||
+ | * If a launcher is already defined by default and installed [Enter] -- i think | ||
+ | * if run an unknown filetype without [[Defining a Filetype Association]], you must use the commandline. | ||
+ | **if the program runs within the terminal as text only, such as ls, type without the quotes, ':!!ls -al %c' and then press [Enter]. Explain that that is a commandline mode command and what each part of it does. link to a list of available command line commands. | ||
+ | **if you would like to continue using Vifm while the program runs, which is most likely the case if it runs in its own window, run the task in the background using '&'. For example, if you wanted to launch the terminal emulator xterm in the current directory use '!xterm &'. If xterm didn't work try gnome-terminal, urxvt, konsol, [https://en.wikipedia.org/wiki/List_of_terminal_emulators etc]. Did you noticed that you didn't need to specify the current directory? This is because Vifm launches '!' commands in the current directory. | ||
+ | ** Press the [Enter] key (carriage return) to edit a file (or open a folder). (Change <code>set norunexec</code> to <code>set runexec</code> in <code>~/.vifm/vifmrc</code> to run executable files rather then open them for editing.) (Not sure if this this bullet should be included in the very basic tutorial???) | ||
+ | |||
+ | *by now you should be able to do anything from with Vifm, if just might not be much fast then just using the command line. | ||
+ | |||
+ | === Modes === | ||
The effect of key presses in Vifm depends on current mode. A ''mode'' defines | The effect of key presses in Vifm depends on current mode. A ''mode'' defines | ||
Line 109: | Line 122: | ||
gives commands to an application in it more often than in other modes. | gives commands to an application in it more often than in other modes. | ||
− | === | + | == Do Common Tasks Faster == |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | === Shell-like navigation via command-line === | |
− | |||
− | |||
− | = | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == Shell-like navigation via command-line == | ||
Vifm provides a subset of shell builtin commands: | Vifm provides a subset of shell builtin commands: | ||
Line 248: | Line 135: | ||
<code>:cd</code> and <code>:pushd</code> accept two parameters, which specifies path for inactive pane. | <code>:cd</code> and <code>:pushd</code> accept two parameters, which specifies path for inactive pane. | ||
− | == File operations == | + | === File operations === |
{| class="wikitable" | {| class="wikitable" | ||
Line 264: | Line 151: | ||
|} | |} | ||
− | === Normal mode commands === | + | ==== Normal mode commands ==== |
Depending of the value of <code>'cpoptions'</code> option | Depending of the value of <code>'cpoptions'</code> option | ||
Line 282: | Line 169: | ||
destructive. | destructive. | ||
− | === Command-line mode commands === | + | ==== Command-line mode commands ==== |
− | * <code>:copy</code> - copy current file | + | * <code>:copy</code> - copy current file of selected files from active pane to inactive pane (fails on name conflicts). |
− | * <code>:copy!</code> - copy current file | + | * <code>:copy!</code> - copy current file of selected files from active pane to inactive pane (overwrites files at destination). |
− | * <code>:move</code> - move current file | + | * <code>:move</code> - move current file of selected files from active pane to inactive pane (fails on name conflicts). |
− | * <code>:move!</code> - move current file | + | * <code>:move!</code> - move current file of selected files from active pane to inactive pane (overwrites files at destination). |
− | * <code>:delete</code> - moves current file | + | * <code>:delete</code> - moves current file of selected files to trash. |
− | * <code>:delete!</code> - erases current file | + | * <code>:delete!</code> - erases current file of selected files to trash (by defaults after confirmation). |
− | |||
− | ==== Running operations in background ==== | + | ===== Running operations in background ===== |
File system operations are blocking by default and sometimes can require | File system operations are blocking by default and sometimes can require | ||
Line 308: | Line 194: | ||
running in background. | running in background. | ||
− | = Basic configuration = | + | == Basic configuration == |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | '''TODO: cover following topics''' | |
+ | * Setting options | ||
+ | * Making options persistent | ||
[[Category:Manual]] | [[Category:Manual]] |