harry191518 / ivim

I love Vim, and I also love modifying it to be more convenient and efficient. So I name it "ivim"!

ivim - An easy & highly customizable vim configuration

    _       _          
   (_)   __(_)___ ___  
  / / | / / / __ `__ \ 
 / /| |/ / / / / / / / 
/_/ |___/_/_/ /_/ /_/  

Version: 2.0

Features

Beautiful

• Use lots of famous colorschemes to make your eyes feel comfortable in both Vim and MacVim/gVim.

  • Hybrid(default)
  • Solarized
  • Base16

Efficient

• Make using Vim more convenient and faster, and lots of useful plugins (such as Neocomplcache, NERD_commenter, Syntastic) confirm a better performance of Vim.

• To view the full plugin list, please consult here

Requirements

Vim

• This distribution is adapted to both Vim and MacVim/gVim. Remember that the Vim/MacVim/gVim version should be 7.3+, or errors would occur!

Git

• All the installations are based on Git which is a famous distributed revision control system. If you use Windows, you may need install msysgit.

Ctags

• Ctags generates an index (or tag) file of language objects found in source files that allows these items to be quickly and easily located by a text editor or other utility. I recommend you to use Exuberant Ctags.

To use this distribution with less bugs, please get more suggestions from here

Installation

Manual Installation

0. A Vim/MacVim/gVim with version higher than 7.3 should be installed on your computer;
1. Get ivim from github website, git clone git://github.com/kepbod/ivim.git $HOME/ivim;
2. Make symbolic links of vimrc to your home directory, ln -s $HOME/ivim/vimrc $HOME/.vimrc;
3. Install NeoBundle to install and update plugins, git clone git://github.com/Shougo/neobundle.vim.git $HOME/.vim/bundle/neobundle.vim;
4. Install plugins, $HOME/.vim/bundle/neobundle.vim/bin/neoinstall > /dev/null 2>&1 for *nix or $HOME/.vim/bundle/neobundle.vim/bin/neoinstall.bat for windows;
5. Just enjoy it!

Automatic Installation (*nix only)

via 'curl'

bash <(curl -L https://raw.githubusercontent.com/kepbod/ivim/master/setup.sh) -i

via 'wget'

bash <(wget --no-check-certificate https://raw.githubusercontent.com/kepbod/ivim/master/setup.sh -O -) -i

Updating

bash $HOME/ivim/setup.sh -n

Configuration

There are some options you could set through .vimrc to configure ivim:

• g:ivim_user -- your username
• g:ivim_email -- your email
• g:ivim_github -- your github
• g:ivim_default_scheme -- color settings adapted for hybrid
• g:ivim_fancy_font -- using fancy font or not
• g:ivim_show_number -- showing number or not
• g:ivim_autocomplete -- autocomplete engine (NEO: neocomplete/neocomplcache/neosnippet, YCM: YouCompleteMe/UltiSnips)
• g:ivim_bundle_groups -- plugin groups ('ui', 'enhance', 'move', 'navigate', 'complete', 'compile', 'git', 'language')

This distribution is completely customisable using a ~/.vimrc.local, ~/.gvimrc.local, ~/.vimrc.ivim.local and ~/.vimrc.bundles.local!

Vim Tips

Learning Vim

• A good learning method of Vim is vimtutor, a 30 minute tutorial that teaches the most basic Vim functionality hands-on.

  To try it, just type vimtutor on terminal.

• To practice vim skills, you can enable hard mode, and it will disable the arrow keys, the 'hjkl' keys, the page up/down keys, and a handful of other keys which allow one to rely on character-wise navigation.

  To enable it, just type :call HardMode() in normal mode.

• Another way to get familiar with Vim commands and settings is just rely on the strong help system of Vim.

  It's easy and convenient to type :h or :help in Vim for help of whatever you want to know.

• A beautiful Vim cheat sheet is available here. If you want one, just click it!

Key Mappings

• Because I have set some key mappings for more convenient typing and checking, you may feel inconvenient with them at start. But if you get familiar with them, I'm sure you will love them.

  You can just type :map in Vim to see them.

More Tips

• Vim_Tips_Wiki is an excellent website, and you can learn much from it.
• Vimcasts publishes free screencasts about Vim. It's useful and interesting! Believe me!

Hope You Enjoy Vimming!!!

License

Copyright (C) 2012-2014 Xiao-Ou Zhang and contributors. See the LICENSE file for license rights and limitations (MIT)