View source for Vim

== General ==

Vi or Vim (VI IMproved) is a visual text editor that can be run inside a [[shell]]. This has the advantage, that you can quickly write or edit text files in the [[shell]], even over an [[ssh]] connection without needing a graphical user interface. Alternatively there is the option to edit files locally (on your desktop computer) in your favourite editor or IDE (e.g. Notepad++, VSCode, ...) and then transfer the files to the remote (super)computer. Visit the [[File_Transfer|file transfer]] page for more information on that topic. As these tansfers can be a lot of effort, just to fix a missing <code>;</code> or typo, Vi/Vim can come in handy, as they are available on practically every Unix system.

While it's usage is far from intuitive, a few basics are generally helpful. For a more complete coverage of this editor, why people use it and why you should probably do that too, please take a look at the [[#Absolute_Basics|<code>vimtutor</code>]], the [[#References|References]] or the internet in general. There are lots of great resources, presenting reasons for using Vi/Vim and giving detailed instructions for its effective usage.

== Modes ==

In Vi/Vim there are two modes. Normal mode and Insert mode. You switch to normal mode with the <code>ESC</code> key and to insert mode by pressing <code>i</code>. Insert mode works more or less like you would expect a normal text editor to work with arrow keys for navigation, backspace for deletion and characters for text. More information about what normal mode is good for etc. can be found in the [[#References|References]] or the internet.

== Absolute Basics ==
To open yourfile.txt in Vi/Vim simply enter

<syntaxhighlight lang="bash">
$ vim yourfile.txt
</syntaxhighlight>

From normal mode (press <code>Esc</code> to get there) you can type

{| class="wikitable" style="width: 40%;"
| <code>:q</code> || to quit Vi/Vim
|-
| <code>:w</code> || to save the current file
|-
| <code>:q!</code> || to quit Vi/Vim without saving (discarding changes)
|-
| <code>:x</code> || to quit Vi/Vim with saving changes
|}

For a tutorial you can call the

<syntaxhighlight lang="bash">
$ vimtutor
</syntaxhighlight>

and follow the instructions on screen.

== References ==
[http://www.openvim.com/ Interactive Vim Tutorial]

[https://wiki.gentoo.org/wiki/Vim/Guide Vim/Guide in the Gentoo wiki]

[http://www.viemu.com/a-why-vi-vim.html Why should you use vi (or vim)]

[https://vim-adventures.com/ Vim Game]