Vim: Difference between revisions

From wikinotes
 
(33 intermediate revisions by the same user not shown)
Line 1: Line 1:
A fast, customizable, cross platform mode based text editor that usually runs in a console.
A fast, customizable, cross platform editor that generally runs in a console.


Vim is uniqe in that it is modal:
Vim is uniqe in that it is modal:
Line 14: Line 14:
<blockquote>
<blockquote>
{| class="wikitable"  
{| class="wikitable"  
|-
| home || https://www.vim.org/
|-
| <code>:help</code> || https://vimhelp.org/
| <code>:help</code> || https://vimhelp.org/
|-
|}
|}


Line 21: Line 25:
= Locations =
= Locations =
<blockquote>
<blockquote>
 
{| class="wikitable"
{| class="wikitable"  
|-
!colspan=2| Unix
|-
| <code>~/.vimrc</code> || user config
|-
| <code>~/.vim</code> || user libraries, syntax, help, plugins, ...
|-
| <code>${PREFIX}/share/vim/vim82</code> || official config
|-
| <code>${PREFIX}/share/vim/vimfiles</code> || distro config
|-
!colspan=2| Windows
|-
|-
| <code>~/.vimrc</code><br>
| <code>%HOMEDRIVE%%HOMEPATH%/_vimrc</code> || user config
<code>%HOMEDRIVE%%HOMEPATH%/_vimrc</code>
|| configuration
|-
|-
| <code>~/.vim</code><br>
| <code>%HOMEDRIVE%%HOMEPATH%/vimfiles</code> || user libraries, syntax, help, plugins, ...
<code>%HOMEDRIVE%%HOMEPATH%/vimfiles</code>
|| plugins, libraries, etc
|-
|-
|}
|}
Line 36: Line 47:
</blockquote><!-- locations -->
</blockquote><!-- locations -->


= Terminology =
= Basics =
<blockquote>
<blockquote>
{|
{|
|-
|-
| buffer ||
| [[vim intro]]
|-
|-
| register ||
| [[vim install]]
|-
|-
| macro ||
| [[vim troubleshooting]]
|-
|-
|}
|}
 
</blockquote><!-- Basics -->
</blockquote><!-- terminology -->
 
= Install =
<blockquote>
<source lang="bash">
# archlinux (packages have most languages preinstalled)
pacman -S vim
pacman -S gvim
 
# freebsd
 
 
# ubuntu (default package minimal, noXorg variant has all)
sudo apt install -y vim-nox
 
</source>
</blockquote><!-- Install -->


= Usage =
= Usage =
Line 70: Line 64:
{|
{|
|-
|-
| [[vim commandline]]
| [[vim cli]]
|-
|-
| [[vim keybindings]]
| [[vim diff]]
|-
| [[vim commands]]
|-
|-
| [[vim folding]]
| [[vim printing]]
|-
| [[vim tips/tricks]]
|-
| [[vim ctags]]
|-
|-
|}
|}
</blockquote><!--Hotkeys-->
</blockquote><!--Hotkeys-->


= Scripting =
= Configuration =
<blockquote>
<blockquote>
{|
{|
| [[viml]]  
|-
| [[viml]]
|-
| [[vim options]]
|-
| [[vim autocmd]]
|-
| [[vim keybindings]]
|-
|-
| [[vim plugins]]
| [[vim plugins]]
|-
| [[vim indenting]]
|-
| [[vim after-directory]]
|-
|}
|}
</blockquote><!-- Scripting -->
</blockquote><!-- Configuration -->


= Tools =
= Features =
<blockquote>
<blockquote>
{|
{|
| [[vim diff]]
|-
| [[vim help]]
|-
| [[vim commands]]
|-
| [[vim folds]]
|-
| [[vim registers]]
|-
| [[vim macros]]
|-
| [[vim motions]]
|-
| [[vim cursor stacks]]
|-
| [[vim ctags]]
|-
| [[vim digraphs]]
|-
| [[vim profiling]]
|-
| [[vim shell]]
|-
|}
|}
</blockquote><!-- Tools -->
</blockquote><!-- Features -->
 
= Behaviour =
<blockquote>
=== Buffers ===
Buffers are any text that vim stores. It is typically associated with a file
 
=== Registers ===
Registers are places where you can copy text to for processing. There is the system clipboad
register, the standard vim register, named registers, etc. Registers are accessed by using <code>"</code>
followed by a letter(the register), and then the operation you want to perform on it. When yanking,
if you use a capital letter, you will append to your register instead of replacing it.
 
<syntaxhighlight lang="vim">
@                                      ""The yank-text register
"zyy ""Copy Line under text to register 'z'
"Zyy ""Append Line under text to existing register 'z'
"zp ""Paste register 'z'
 
let var = @z ""Save contents of register 'z' to a variable
</syntaxhighlight>
 
You can also record expressions to registers.
<source lang="vim">
let @* = expand('%:p')  " copy current filepath to clipboard
</source>
 
=== Filetypes ===
sometimes you want to use syntax highlighting for files that aren't really programs.
sometimes you want certain programs to be recognized as their proper filetype while using a different extension.
 
<syntaxhighlight lang="vim">
set filetype=python      #sets current filetype to python
set filetype=?            #query current filetype
 
au BufRead,BufNewFile *.cpy set filetype=python  #auto associate filetypes with extensions (in your .vimrc)
</syntaxhighlight>
 
=== Macros ===
<source lang="vim">
q<letter>    # start recording macro bound to <letter>
q            # stop recording
 
@<letter>    # play-back recording
</source>
</blockquote><!--Behaviour-->

Latest revision as of 15:46, 10 February 2024

A fast, customizable, cross platform editor that generally runs in a console.

Vim is uniqe in that it is modal:

  • text is written in insert mode
  • navigation is performed in normal mode
  • selections made in visual mode
  • commands entered in command mode

Each has it's own keybindings.


Documentation

home https://www.vim.org/
:help https://vimhelp.org/

Locations

Unix
~/.vimrc user config
~/.vim user libraries, syntax, help, plugins, ...
${PREFIX}/share/vim/vim82 official config
${PREFIX}/share/vim/vimfiles distro config
Windows
%HOMEDRIVE%%HOMEPATH%/_vimrc user config
%HOMEDRIVE%%HOMEPATH%/vimfiles user libraries, syntax, help, plugins, ...

Basics

vim intro
vim install
vim troubleshooting

Usage

vim cli
vim diff
vim printing

Configuration

viml
vim options
vim autocmd
vim keybindings
vim plugins
vim indenting
vim after-directory

Features

vim help
vim commands
vim folds
vim registers
vim macros
vim motions
vim cursor stacks
vim ctags
vim digraphs
vim profiling
vim shell
Retrieved from "http://willpittman.net:8080/index.php?title=Vim&oldid=34535"