<commit_before>## Dotvim

### An attempt at The Ultimate Vim Configuration™ ;)

All the right plugins are in. Nerdtree, CtrlP, you name it.

The focus is on supporting Rails, but there is a lot of generic stuff too, so
it will surely serve you well with any language of your choice.

The config is using [Vundle](http://github.com/gmarik/vundle) for easy
upgrading.

*Some* help tips are provided for *some* of the plugins. please check out the
plugin's docs for more info.

Follow [@vkushner][@vkushner] and [@astrails][@astrails] on Twitter to receive
announcements of new versions, tips, etc.

[@vkushner]: https://twitter.com/vkushner
[@astrails]: https://twitter.com/astrails

<a name=top>
#### Contents

* [Installation](#installation)
* [General Configuration](#general)
* [Local configuration](#local)
* [Backups](#backups)
* [Persistent Undo](#undo)
* [Macros](#macros)
* [Interesting Plugins](#interesting)
  * [nerdtree](#nerdtree)
  * [nerdcommenter](#nerdcommenter)
  * [Command-T](#Command-T)
  * [CtrlP](#CtrlP)
  * [AutoComplPop](#AutoComplPop)
  * [taglist.vim](#taglist.vim)
  * [YankRing.vim](#YankRing.vim)
  * [vim-fugitive](#vim-fugitive)
  * [syntastic](#syntastic)
  * [snipmate](#snipmate)
  * [vim-surround](#vim-surround)
  * [vim-align](#vim-align)
  * [ack.vim](#ack.vim)
  * [vim-indentobject](#vim-indentobject)
  * [greplace.vim](#greplace.vim)
  * [vim-powerline](#vim-powerline)
  * [threesome.vim](#threesome.vim)
  * [vim-endwise](#vim-endwise)
  * [delimitMate](#delimitMate)
  * [Gundo](#dgundo)
* [Ruby/Rails Support](#ruby)
  * [vim-rails](#vim-rails)
  * [vim-bundler](#vim-bundler)
  * [vim-rake](#vim-rake)
  * [vim-textobj-rubyblock](#vim-textobj-rubyblock)
  * [vim-ruby-refactoring](#vim-ruby-refactoring)
  * [apidock.vim](#apidock.vim)
* [Org mode and support plugins](#orgmode)
  * [calendar](#calendar)
  * [NrrwRgn](#NrrwRgn)
  * [utl.vim](#utl.vim)
  * [VimOrganizer](#VimOrganizer)
* [Color themes](#themes)
  * [vim-colors-solarized](#vim-colors-solarized)
  * [vim-vividchalk](#vim-vividchalk)
* [Syntax plugins](#syntax)
* ["Support" and "minor" plugins](#minor)
* [Misc Bindings](#misc)
* [Russian Translit Layout support](#russian)

<a name=installation>
##### Installation

From your homedirectory (on Linux/Mac OSX):

* `git clone git://github.com/astrails/dotvim.git`
* `ln -sfn dotvim .vim`
* `ln -sfn dotvim/vimrc .vimrc`
* `cd .vim; make install`
* create ~/.local.vim if you want to have some
  local/personal settings you don't want to commit into the repo

Note: if you already have `~/.vim` `~/.vimrc` REMOVE THEM (you might want to backup them first :)

[top](#top)

<a name=general>
#### General configuration

`,` is used as mapleader
`backslash` is used as localleader

* `,e` mapped to `:e **/`. essentially you do `,efoo<tab>` to get a list of all files starting with foo
* `,s` - toggle invisible characters display
* `,n` - next `quicklist` result (like :Ggrep etc)
* `,N` - previous `quicklist` result (like :Ggrep etc)
* `Ctrl-E` - switch between 2 last buffers  (its just a `:b#<cr>` :)
* `Ctrl-N` to cancel current search highlighing
* `,f` global Ggrep for word under the cursor or for selection<commit_msg>updated README to include a common workaround for missing 'normal' highlighting group<commit_after>## Dotvim

### An attempt at The Ultimate Vim Configuration™ ;)

All the right plugins are in. Nerdtree, CtrlP, you name it.

The focus is on supporting Rails, but there is a lot of generic stuff too, so
it will surely serve you well with any language of your choice.

The config is using [Vundle](http://github.com/gmarik/vundle) for easy
upgrading.

*Some* help tips are provided for *some* of the plugins. please check out the
plugin's docs for more info.

Follow [@vkushner][@vkushner] and [@astrails][@astrails] on Twitter to receive
announcements of new versions, tips, etc.

[@vkushner]: https://twitter.com/vkushner
[@astrails]: https://twitter.com/astrails

<a name=top>
#### Contents

* [Installation](#installation)
* [General Configuration](#general)
* [Local configuration](#local)
* [Backups](#backups)
* [Persistent Undo](#undo)
* [Macros](#macros)
* [Interesting Plugins](#interesting)
  * [nerdtree](#nerdtree)
  * [nerdcommenter](#nerdcommenter)
  * [Command-T](#Command-T)
  * [CtrlP](#CtrlP)
  * [AutoComplPop](#AutoComplPop)
  * [taglist.vim](#taglist.vim)
  * [YankRing.vim](#YankRing.vim)
  * [vim-fugitive](#vim-fugitive)
  * [syntastic](#syntastic)
  * [snipmate](#snipmate)
  * [vim-surround](#vim-surround)
  * [vim-align](#vim-align)
  * [ack.vim](#ack.vim)
  * [vim-indentobject](#vim-indentobject)
  * [greplace.vim](#greplace.vim)
  * [vim-powerline](#vim-powerline)
  * [threesome.vim](#threesome.vim)
  * [vim-endwise](#vim-endwise)
  * [delimitMate](#delimitMate)
  * [Gundo](#dgundo)
* [Ruby/Rails Support](#ruby)
  * [vim-rails](#vim-rails)
  * [vim-bundler](#vim-bundler)
  * [vim-rake](#vim-rake)
  * [vim-textobj-rubyblock](#vim-textobj-rubyblock)
  * [vim-ruby-refactoring](#vim-ruby-refactoring)
  * [apidock.vim](#apidock.vim)
* [Org mode and support plugins](#orgmode)
  * [calendar](#calendar)
  * [NrrwRgn](#NrrwRgn)
  * [utl.vim](#utl.vim)
  * [VimOrganizer](#VimOrganizer)
* [Color themes](#themes)
  * [vim-colors-solarized](#vim-colors-solarized)
  * [vim-vividchalk](#vim-vividchalk)
* [Syntax plugins](#syntax)
* ["Support" and "minor" plugins](#minor)
* [Misc Bindings](#misc)
* [Russian Translit Layout support](#russian)

<a name=installation>
##### Installation

From your homedirectory (on Linux/Mac OSX):

* `git clone git://github.com/astrails/dotvim.git`
* `ln -sfn dotvim .vim`
* `ln -sfn dotvim/vimrc .vimrc`
* `cd .vim; make install`
* create ~/.local.vim if you want to have some
  local/personal settings you don't want to commit into the repo

> IMPORTANT: **always** add a `conolrscheme` to your `~/.local-after.vim` file,
> even if you use the defaults scheme add `colorscheme default`. Othewise you
> will get a highlighting error `"E411: highlight group not found: Normal"`
> during vim startup.

Note: if you already have `~/.vim` `~/.vimrc` REMOVE THEM (you might want to backup them first :)

[top](#top)

<a name=general>
#### General configuration

`,` is used as mapleader
`backslash` is used as localleader

* `,e` mapped to `:e **/`. essentially you do `,efoo<tab>` to get a list of all files starting with foo
* `,s` - toggle invisible characters display
* `,n` - next `quicklist` result (like :Ggrep etc)
* `,N` - previous `quicklist` result (like :Ggrep etc)
* `Ctrl-E` - switch between 2 last buffers  (its just a `:b#<cr>` :)
* `Ctrl-N` to cancel current search highlighing
* `,f` global Ggrep for word under the cursor or for selection
{'fraction_non_alphanumeric': 0.1668903803131991, 'fraction_numerical': 0.0007457121551081282, 'mean_word_length': 4.811091854419411, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 17, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3775558', 'n_tokens_mistral': 2653, 'n_tokens_neox': 2349, 'n_words': 637}