keifer / vimrc

Raphanus's vimrc

Raphanus's vimrc

Creator: Tsung-Hsiang (Sean) Chang [e-mail]

Modifier: Raphanus Lo

Fork me on GITHUB https://github.com/COLDTURNIP/vimrc.

HOW TO INSTALL

1. Check out from github

    $ git clone https://github.com/COLDTURNIP/vimrc ~/.vim
    $ cd ~/.vim
    $ git submodule update --init
   

2. Install ~/.vimrc and ~/.gvimrc

    $ ./install-vimrc.sh
   

3. (Optional, if you want Command-T) Compile the Command-T plugin

    $ cd .vim/bundle/command-t/ruby/command-t
    $ ruby extconf.rb
    $ make
   

If you have some problem when updating submodule, such as

    $ git submodule update
    fatal: reference is not a tree: 2d7cfbd09fc96c04c4c41148d44ed7778add6b43
    Unable to checkout '2d7cfbd09fc96c04c4c41148d44ed7778add6b43' in submodule path 'mysubmodule'

then you may need to roll-back your parent repository and re-update submodules to solve it. There's a good tutorial to solve such problems:

• Stackoverflow: Git submodule head

UPGRADE PLUGIN BUNDLES

All plugins (except vim-latex) were checked out as git submodules, which can be upgraded with git pull. For example, to upgrade Command-T

 $ cd ~/.vim/bundle/command-t
 $ git pull

HOW TO USE

see the "USEFUL SHORTCUTS" section in vimrc to learn my shortcuts.

PLUGINS

• Pathogen: Pathogen let us install a plugin as a bundle in ~/.vim/bundle seprately.

• AutoClose: Inserts matching bracket, paren, brace or quote.

• vim-surround: deal with pairs of surroundings.

• matchit: extended % matching for HTML, LaTeX, and many other languages.

• xmledit: XML/HTML tags will be completed automatically.

• Command-T: open and navigate between files with cmd-t.

• YankRing: Maintains a history of previous yanks, changes and deletes

  :help yankring to see more info.

• VisIncr: Produce increasing/decreasing columns of numbers, dates, or daynames.

• Cute Error Marker: showing error and warning icons on line.

  Note: MacVim users need to enable "Use experimental renderer" to see graphical icons.

• vim-latex: Latex support.

• OmniCppComplete: C/C++ omni-completion with ctags database.

• JavaComplete: Java Omni-completion.

• neocomplcache: great completion by making a cache of keyword in buffer.

• taglist: list definitions in current source file.

• Source Explorer: a source code explorer provides an overview of the function and type definitions.

• trinity: an IDE manager to control the three plugins open and close: taglist, Source Explorer, and NERD tree.

Language specific supports

• Latex: Read :help latex-suite.txt
• Restructured Text: ctrl-u 1~5 inserts Part/Chapter/Section headers
• HTML, Javascript, Python, CSS, C, C++, Java: use TAB to do omni-completion.
• HTML/XML: End tags are automatically completed after typing a begin tag. (Typing > twice pushes the end tag to a new line.)

Other good references

• http://amix.dk/vim/vimrc.html
• http://spf13.com/post/perfect-vimrc-vim-config-file