gardart / dotfiles-go-vim

dotfiles and Vim configuration

dotfiles and Vim configuration

These are my dotfiles and Vim configuration to use this awesome editor as a fully-featured IDE for most programming languages.

Polyglot prompt, Git completion and Kubernetes integration

These dotfiles use Polyglot to customize the shell prompt. It also enables bash completion for Git and provides a nice integration with Kubernetes.

These featuers can be installed as follows:

# Clone the repo and get the polyglot fork
git clone https://github.com/nacx/dotfiles.git
cd dotfiles
git submodule update --init

# Source the provided `.bashrc` file (the one in the cloned repo) and consider adding it
# to your existing `.bashrc`.
source .bashrc

Vim features

• File explorer and quick search.
• Language objects information such as classes, methods, variables, etc.
• Code completion.
• Integrated Git status information.
• Easy buffer navigation between open files.
• Integrated terminal.

Prerequisites

In order to use the Vim plugins the following pieces have to be installed manually:

• curl
• Git
• Exuberant ctags >= 5.5
• Python3 and its development libraries
• tmux (only if you are using the integrated terminal)

If you are using OSX, you will need to install Vim with Homebrew. Otherwise auto-completion will not work since the version of Vim that comes by default is not compiled with Python3 support.

Installation

There is no automatic way to install this, but only a few links need to be created. You can install all the plugins and create the links as follows:

# Install Neovim python3 support
pip3 install neovim

# Clone the repo
git clone https://github.com/nacx/dotfiles.git

# Create the symbolic links in your home
cd ~
ln -s dotfiles/.vimrc
ln -s dotfiles/.vim

Once the links have been created you're done! All the plugins will be automatically installed the first time you open Vim.

Integrated terminal

If you want to use the integrated terminal tmux needs to be installed. You can use the provided tmux configuration by creating the corresponding symlink:

# Create the symbolic for the tmux configuration
cd ~
ln -s dotfiles/.tmux.conf

In order to easily open Vim in a tmux session that allows you to open the console, add the following lines to the .barhrc file:

# Open Vim with tmux
function vim_tmux() {
    VIM_SESSION="vim-${RANDOM}"
    tmux new -s ${VIM_SESSION} -d "VIM_SESSION=${VIM_SESSION} vim $*" \; attach;
}
alias vim='vim_tmux'

Usage cheat sheet

The following keys have been mapped by default:

Shortcut	Description
F2	Toggle NERDTree
F3	Toggle Tagbar (it is opened by default in certain source ccode files)
F4	Open a vertical split and show the list of existing buffers
F5	Open a shell in a tmux split
Shift-Left/Right	Change to the previous/next buffer
<Ctrl-Space>	In INSERT mode opens the autocompletion popup
<Ctrl-p>	Opens the CtrlP file search window