Contributing to This Wiki

From Vifm Wiki
Revision as of 17:48, 23 July 2014 by Y2kbugger (talk | contribs)
Jump to navigation Jump to search

A place to map out and plan the topics found in the wiki.

Outline of Topics

Ideology

  1. Why vifm?
    • Compare with ranger.
  2. How not to use vifm.
  3. When and how use vifm.

Starting vifm

  1. From some kind of menu (e.g. KDEMenu).
  2. From command-line
    • Where it starts (previous directories/current directory/any other directory)
    • Start by specifying name of a file rather than directory name
      • Specify path to fuse mount and path inside of it
  3. From any buffer in Vim
    • Replace file in current buffer
    • Edit in tab
    • Edit in horizontal split
    • Edit in vertical split
    • Diff with file
  4. From mail buffer in Vim to add an attachment

Quiting vifm

  1. Saving/not saving state.
    • Controlling whether current directories are remembered.
  2. Switching shell current working directory after leaving vifm.

Modes general

  1. What modes and submodes exist.
  2. Transitions between modes and submodes.

Navigation

  1. Navigation within view.
  2. Rearranging views.
  3. Marks.
  4. Directory stack.

File searching

  1. / and ?
  2. n and N
  3. 'hlsearch', 'incsearch', 'ignorecase', 'smartcase'
  4. Regular expressions

Manual file selection

  1. 'hlsearch' and searching.
  2. t command.
  3. Visual mode.
    • cover all submodes

File auto selection

  1. Motions.
  2. Selectors.

Command-line and alike modes

  1. Auto-completion.
    • Mention slash completion shortcut.
    • Mention completion of :help that checks for presence not for starts with.
  2. Emacs-like navigation.
  3. History (Ctrl-N/Ctrl-P/Down/Up).
  4. External command editing.
    • Plugin addition.
  5. Alt-. command.
  6. Ctrl-X mappings.

Command-line commands

  1. General syntax overview.
    • :[range]command arg1 'arg2' "arg3" /arg4/
    • Comments.
    • Several commands separated by a bar ("|").
  2. :!! command.
  3. Ranges.
  4. Macros.
  5. User-defined commands.
    • External commands.
    • Local commands (":do something").
    • Background commands.
  6. Commands that accept expressions.
  7. Backgrounding commands.
  8. Cancelling commands.

Controlling view

  1. Permanent file filtering.
  2. Real-time file filtering.

Mappings

  1. With remapping (:map).
  2. Without remapping (:noremap).
  3. Angle-bracket notation.
  4. Displaying existing mappings.

Trash directories

  1. Overview, state incompatibility with Trash specification of FreeDesktop.
  2. Location ('trashdir' option).
  3. Related command-line commands (":lstrash", ":trashes").
  4. Related normal mode commands (p, P, d, D).

Previewing files

  1. Exploring.
  2. Previewing.

Color schemes

Color schemes

  1. Color scheme files
    • location
    • file syntax
    • hierarchy
    • Color definitions
  2. Preparing your terminal.
    • 8,8+8(no bold),16,256 colors & light vs bold
    • teminal specifics
      • xterm
  3. colorscheme Default
  4. Per-directory schemes.
  5. User colorschemes
    • Tips for customizing
    • Recommend extra info to include about your Color scheme
      • Terminal settings
      • Terminal Pallet
      • Color scheme

Running files

Combining with external scripts

Writing scripts in vifmrc file