dotfiles

dotfiles

Configuration files for:

• Bash (3.2+) and Zsh (4.3.17+)
• Vim (7+) and NeoVim
• Tmux (1.8+)
• Other bits and pieces

Heavy preference for Vim-like bindings.

Installation

Clone to a home folder and run make install or ./install. Restart the terminal session.

Usage

Below is a non-exhaustive list of dotfiles features.

Bash/Zsh

• Case-insensitive completion.
• The excellent z and v commands:
  • z for folder jumping: z regex = cd /path/with/regex.
  • v for file editing: v regex = vim /path/with/regex.
• Multi-line shell prompt that displays Git repo info and job count.
• Mostly-Mnemonic Git shortcuts: gs = git status, gd = git diff, etc.
• Custom settings can be contained in .local files:
  • bash: ~/.bashrc.local and ~/.bashenv.local
  • zsh: ~/.zshrc.local and ~/.zshenv.local
• SSH agent automation:
  • Set AUTO_AGENT_SETUP=1 (in an env file) to auto-load keys into ssh-agent.

Vim

Space is the <Leader>.

• <Leader>w saves.
• <Leader>q closes.
• <Leader>l lists loaded buffers and allows jumping to them by number.
• <Leader>p fuzzy-finds files.
• <Leader>n toggles line numbers.
• <Leader>c finds VCS conflict markers.
• - opens a file browser.
• Additional text objects exist (see 'Text Objects' in plugins.vim).
• :Goyo for distraction-free writing.
• :Dark, :Light colour schemes available.
• Custom plugins can be listed in ~/.vim/plugins.vim.local.
• Custom settings can be put in .vim.local files in ~/.vim/settings/, or in a ~/.vim/settings/local/ directory.

Tmux

<C-a> = Ctrl-a = the tmux prefix.

• <C-a> + [vi motion] moves around panes.
• <C-a> + <C-[vi motion]> moves around windows.
• Alt/Meta + number moves to window number (1-10).
• <C-a> + - cuts a pane horizontally,
• <C-a> + \ cuts a pane vertically (think |).
• <C-a> + s starts synchronized panes.
• <C-a><C-s> swaps between sessions.
• Mouse support works for selecting and resizing panes/windows.

Recommended

• Font: Meslo for Powerline (works well with Rainbarf).
• Vim with Ruby/Python support, or Neovim: for Vim-Plug parallel downloads.
• Ripgrep - fast text search (Ack included as fallback).
• Pandoc - Vim creates documents from .pandoc files (Pandoc Markdown).
• pandoc-citeproc - bibliographical assistance when using Pandoc.