xbogdan / dotfiles

My very personal configuration files for vim, tmux, zsh etc.

VIM Configuration

• Compatible with Vim and Neovim.
• Layout compatible for Neovim but easily linkable for Vim.
• All Neovim specific plugins, settings, key mappings etc. are isolated with has('nvim') conditionals.
• Recommended environment includes iTerm nightly and tmux.
• Plugins managed by vim-plug.
• Primary programming languages supported: Python, Rust, Go, Clojure and Common Lisp
• Mnemonic keyboard shortcuts. E.g. file based actions under <Leader>f and buffer based shortcuts are under <Leader>b.
• Leader key is space.
• Local leader is \.

MacOS

• Install Neovim and Vim (i prefer HEAD for both).

    brew install neovim --HEAD
    brew install vim --with-luajit --with-override-system-vi --HEAD
  

• Install plugin dependencies.

    brew install the_silver_searcher
    brew install fzf
  

• For Neovim it is recommended to use separated virtual python environments for editor's own needs. For any shell these virtual environments must be located under ~/.virtualenvs/.

    virtualenv neovim2
    pip install neovim
  
    virtualenv --python=python3 neovim3
    pip3 install neovim
  

• Install ruby plugins

    [sudo] gem install neovim
  

• Clone repository to any place you prefer.

    git clone https://github.com/xbogdan/dotfiles 
  

• Create symbolic links for both editors.

    cd $HOME
    cd .config
    ln -s /path/to/dotfiles/nvim .
  
    cd $HOME
    ln -s /path/to/dotfiles/nvim .vim
    ln -s /path/to/dotfiles/nvim/init.vim .vimrc
  

• Create necessary directories.

    cd $HOME
    mkdir .nvimtmp
  

• First run will give errors. Ignore them.

    nvim
    vim
  

• For each editor execute :PlugInstall command.

Keybindings List

Notable custom keybindings;

• General
  • Swap ; with : so to enter command mode use only one keystroke. If you want to repeat latest linewise jump use :.
• File based operations (starts with <leader>f)
  • <leader>ff Find files. Fuzzy search UI populated with ripgrep.
  • <leader>fj Find junkfile files. Fuzzy search UI populated with files in junk file folder.
  • <leader>ft Toggle tagbar.
  • <leader>fs Write buffer to disk. Equilavent :w<cr>.
  • <leader>fW Remove trailing whitespace from whole buffer.
• Buffer based operations (starts with <leader>b)
  • <leader>fl Populates all lines of current file into fuzzy search UI.
  • <leader>fo Poplulates (on the fly) all tags (outline) in the file (ctags) into fuzzy search UI.
  • <leader>bb List buffer to jump. Fuzzy search UI.
  • <leader><tab> Switch to previous buffer. Equilavent to :b#<cr>.
• Search based operations
  • n mapped to nzzzv to keep matching line in the middle of the screen.
  • <leader>/ greps recursively in the directory and loads results into fuzzy search UI including preview for each row.
  • <leader>* same as previous one except this does not wait for input. Instead uses the word under cursor as input.
  • <leader>ss uses grepper plugin to grep. Results loaded into quickfix window.
  • <BS> executes :nohlsearch<cr>.
• Other
  • <leader>V selects just pasted text.

Check keybindings.vim for all custom keybindings.

Plugins List

Check plugins.vim for all plugins and keybindings.vim for all custom keybindings.

TMUX Configuration

Mac OS X

• First install Homebrew

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  

• Next, install the tmux and reattach-to-user-namespace packages using Homebrew

    brew install tmux
    brew install reattach-to-user-namespace
  

• Create a symbolic link to dotfiles/tmux/tmux.conf

    ln -s /path/to/repo/dotfiles/tmux/tmux.conf ~/.tmux.conf
  

• (Optional) Change the shell

  • Open ~/.tmux.conf in your favourite editor and edit the MYSHELL and MYSHELL_PATH.

      ...
      3 # SHELL choice (zsh | fish)
      4 MYSHELL=zsh
      5 MYSHELL_PATH=/usr/local/bin/zsh
      ...
    

• Run tmux

  ~$ tmux