Skip to content
Jason Charney edited this page Feb 4, 2015 · 9 revisions

SPF13-Vim is a suite of Vim plugins that

Pros

  • Pop up menu auto completion for new words.
  • Powerline
  • Ideal if you are a Python Programmer

Cons

  • Pop up menu auto completion activates on existing words, saves your spelling errors. (So haphazardous!)
  • The favored use of the Solarized Theme. (Loads 500+ color schemes. Only uses one.)
  • List mode is enabled by default. (Why?)
  • Fancy quotes enabled when you create a new text file or edit an exiting one. (Please don't!)
  • V-Line selection is a P.I.T.A. (See my Vim page on how to copypasta like a boss rather than a chump.)

But despite all the cons, SPF13 is still worth installing.

Installation Instructions

Using SPF13 is not recommened for new vim users, as new vim users should understand how vim works on its own first before delving into the use of power tools like SPF13. Once you know the basics, and are comfortable doing quite a bit of stuff, then you should decide if SPF13 is right for you.

  1. Backup your ~/.vimrc file. It WILL be deleted and replaced by SPF13's series of .vimrc files. So cp ~/.vimrc ~/.vimrc.backup`
  2. Backup your ~/.vim/ directory. SPF13 will mercilessly wipe out anything that may be in it. So cp -R ~/.vim ~/.vim.backup/
  3. Download and install SPF13. The original instructions call for the use of sh. I find using bash to be more effective and with fewer problems. curl http://j.mp/spf13-vim3 -L -o - | bash
  4. Edit ~/.vimrc.local, this file is basically the new ~/.vimrc. Anything you are used to using that may be in your ~/.vimrc.backup probably should go in ~/.vimrc.local or in rare instances ~/.vimrc.before. Some of the things you may want to change are listed below especially if ~/.vimrc.local has them set differently from what you were used to having. Save those changes. Close vim and reopen it to see the new settings applied.

Things you can fix and how to fix them

Coming soon. Might just rename this "SPF Serenity".

Airline doesn't show Powerline style symbols and chevrons

See my Airline page on how to fix that.

List mode is enabled, tabs are converted to spaces, hidden characteers are showing, Dogs and Cats are living together! Utter chaos!

Let's fix most of the madness. Open ~/.vimrc.local. If it doesn't exist, create it. If you need help, try using another text editor like nano, gedit, or leafpad.

set nocompatible                        " I use this anyway. This should be the first setting set.
set shell=/bin/bash                     " Set the default shell to bash instead of sh

set background=dark                     " Use a dark background so the color scheme uses bright syntax
filetype plugin indent on               " Automatically detect file types
syntax on                               " Enable syntax highlighting
set mouse=""                            " Disable the mouse.  Great vim users use keyboard commands!
set mousehide                           " Hide the cursor while typing
scriptencoding utf-8                    " Set encoding to Unicode

colorscheme jellybeans                  " Use some other theme that ISN'T solarized. Jellybeans is good.

set tabpagemax=15             " Allow up to 15 tabs to be open in a session. Some people set this to 20.

set showmode      " Show the current mode in status line. (TODO: Is this still need if Airline is used?)
set cursorline                          " Highlight the current line

highlight Normal ctermbg=none           " Allow transparent background for normal text
highlight NonText ctermbg=none          " Ditto for nontext
highlight clear SignColumn              " Signcolumn should match the background
highlight clear LineNr     " Current line number row will have the same background color in relative mode
" highlight clear CursorLineNr  "Remove highlight color from the current line number. (Let's keep that.)
highlight CursorLine term=bold cterm=bold guibg=Grey40   " bold the current line and use a grey bkgnd

set nu                                  " show the line numbers
set noincsearch                         " Don't highlight search as you type. (Vim users use RegEx!)
set nolist                              " Don't show list characters
set wrap                                " Wrap long lines.  This can stay. Though I'd like to tweak it.
set noexpandtab                         " Don't expand tabs to spaces

How do I get 256 colors?

That's more of a Bash question. It's still relevant to Vim though.

Home and End keys don't work.

I'll have to get back to you on that. This might be a Bash issue too if you changed your terminal. I'm looking into it.

See also

External Links

Clone this wiki locally