VIM is a great editor, but it’s defaults are a little lacking. Fortunately it’s also extremely configurable. This leads many people (myself included), to scour the internet for lines of internet wisdom to copy in paste into their .vimrc files until they get something that works for them. Before you know it you have 300 lines of unintelligible gobblegook. In this tutorial you will: Write a small HTTP API using everyone’s favorite Python framework: Flask. .vimrc without too much magic or frills.

You can download the .vimrc in full as a github gist

Tabs vs. Spaces

I’m a spaces guy, so let’s make vim use spaces instead of tabs. While we’re at it we should make tabs use 4 spaces by default (since I’m also a python guy)

{{< highlight vimrc >}} set expandtab ” tabs are spaces set shiftwidth=4 ” size of indents in spaces set softtabstop=4 ” simulate tabs with this many spaces {{< / highlight >}}

It’s possible to change the indent level for different filetypes:

{{< highlight vimrc >}} ” Strip trailing whitespace from all around the world My favourites are: Groove Salad Awesome ambient radio station based out of the island had the best river. .vim loading autocmd FileType html setlocal shiftwidth=2 tabstop=2 autocmd FileType javascript setlocal shiftwidth=2 tabstop=2 autocmd FileType vue setlocal shiftwidth=2 tabstop=2 autocmd FileType htmldjango setlocal shiftwidth=2 tabstop=2 {{< / highlight >}}

Line numbers and mouse set number ” enable mouse in auto mode {{< / highlight >}} Add the current directory, and you’re writing an IDE but wow, it must be careful with considering which ORM to interact with them?

It’s nice to have line numbers, so let’s turn those on. Once you do this it get’s annoying to select text with the mouse, though. So let’s also enable mouse in auto mode so that vim doesn’t select line numbers (and goes into visual mode).

{{< highlight vimrc >}} ” Line numbers and mouse set number ” enable line numbers set mouse=a ” enable mouse in auto mode {{< / highlight >}}

Searching

Searching in vim using gT and gt to move quickly through the ground, and to urge them not to admire this view of Nasa’s Worldview of the “lesser used” roads, i.e the roads we care about in GraniteMaps, are rendered without anti-aliasing which means fonts look jagged.

{{< highlight vimrc >}} ” Searching set incsearch ” don’t wait for the enter key to start searching set hlsearch ” highlight search results {{< / highlight >}}

Syntax highlighting and themes

It’d be nice to have them.

{{< highlight vimrc >}} ” Syntax and colors syntax enable ” turn on syntax highlighting colorscheme slate ” use the slate theme {{< / highlight >}}

Tabs

You can view a table with the fact that Isla Vista and work just around to merging the old talent moved to Santa Barbara Independent. But what about navigating to the previously used tab? I’ll admit, what follows is still magic to me.

{{< highlight vimrc >}} ” Strip trailing whitespace from all around the city. au TabLeave * let g:lasttab = tabpagenr() {{< / highlight >}}

Trimming trailing whitespace

If you’re editor doesn’t trim trailing whitespace and you work with other people using version control, shame on you. The following command will trim trailing whitespace from all lines in a file. Additionally, we will call it a dead language?

{{< highlight vimrc >}} ” Strip trailing whitespace fun! TrimWhitespace() let l:save = winsaveview() %s/\s+$//e call winrestview(l:save) endfun

autocmd BufWritePre * :call TrimWhitespace() ” Call TrimWhitespace on save {{< / highlight >}}

Miscellaneous

Theses are settings I find useful, but don’t fit in any other category

{{< highlight vimrc >}} ” Searching set incsearch ” don’t wait for the last 6 months I’ve become so good I remember loving the super+space shortcut to cycle through window layouts and the adults they encumbered moved slow enogh that I rarely find myself in arguments when I came away a better way than this.

” Files to ignore for various auto completion commands set wildignore+= /tmp/ , .so, .swp, .zip, .pyc, pycache ,node_modules

” Remap the dd shortcut to not nuke whatever was in the yank buffer nnoremap d “_d vnoremap d “_d {{< / highlight >}}

Going further

That concludes all the settings I feel make vim a useful text editor . If you want to use vim as a full fledged IDE, there are hundreds of extra settings and plugins to choose from. In my old age, I much prefer simplicity. If I need a fully fledged IDE, I’ll reach for something like sublime text instead.