# 2018-05-06-vim

"Vim is a highly configurable text editor built to make creating and changing any kind of text very efficient."

### Learning Materials

[The vim cheatsheet](http://www.viemu.com/a_vi_vim_graphical_cheat_sheet_tutorial.html) Hands down the best vim cheatsheet there is. Print it out and keep in an arm's reach at all time! The creators of the cheatsheet also provide introductory slides to get you started and learn everything covered by the cheatsheet step-by-step.

[Vim Tips Wiki](http://vim.wikia.com/wiki/Vim_Tips_Wiki) A big collection of useful vim-topics in wiki form. Good source of information to anything from basic stuff like keymappings to more specific vim-topics. Browse it directly or get flushed there during deep google-searches.

[Vim Awesome](https://vimawesome.com/) Site that advertises and describes basically all popular vim-plugins.

[Learn vimscript the hard way](http://learnvimscriptthehardway.stevelosh.com/) If you want to get really deep down and dirty with vim, this is the way to go. The site teaches vimscript: The language used to customize vim. The .vimrc file uses vimscript to setup vim during start and pugins can be written in vimscript too.

[Introductory videos](https://egghead.io/courses/learn-to-use-vim) The basic things to get you to momentum in self contained course-like videos.

### Installation

First of all make sure that vim is installed

```bash
sudo apt-get install vim
```

Copy the `.vimrc` file in this directory to your home directory as `.vimrc`. Assuming that you cloned this repository in your home folder you can do:

```
cp ~/dotfiles/vim/.vimrc ~/
```

If it doesn't exist already, create a directory "autoload" inside `.vim`:

```
mkdir -p ~/.vim/autoload
```

Go to that directory:

```
cd ~/.vim/autoload
```

Download the plugin:

```
curl https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim -o plug.vim
```

Enter vim:

```
vim
```

Install all plugins by calling PlugInstall inside vim

```
:PlugInstall!
```

Once it's done installing the plugins, in your `.vimrc` file go to line 17 and uncomment it.

## Contributors

* Octavio Arriaga - **Original author**
* Argentina Ortega - **Formatting**
* Maximilian Schöbel - **Learning materials**

## See Also

* <https://egghead.io/courses/learn-to-use-vim>

  \*[Vim the cheat sheet method](https://www.ibm.com/developerworks/linux/tutorials/l-vi/index.html)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://b-it-bots.gitbook.io/wiki/gitbook-1/_posts/2018-05-06-vim.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.