 _     _           _
| |   | |         | |
| |___| |_____  __| | ____
|_____  (____ |/ _  |/ ___)
 _____| / ___ ( (_| | |
(_______\_____|\____|_|

# Yet Another Dotfile Repo v1.1
# Now with Prezto and Vundle!

sh -c "`curl -fsSL https://raw.githubusercontent.com/skwp/dotfiles/master/install.sh `"

Always be sure to run rake update after pulling to ensure plugins are updated

What is YADR?

YADR is an opinionated dotfile repo that will make your heart sing

The best bits of all the top dotfile repos, vim and zsh plugins curated in one place, into a simple and cohesive way of working.
More than 90 vim plugins, all under one roof, working together, each plugin researched and configured to be at its best, often with better shortcut keys.
Many zsh plugins, starting with the wonderful Prezto base, and adding a few niceties on top.
All things are vimized: irb, postgres command line, etc.

Linux/Ubuntu is not supported! If it works, great. If it doesn't, please don't complain. You may need to install zsh if you don't already have it. That being said, check the Docker section below

Mailing List

Got questions, concerns, want to hear announcements? Join the Google Group

Please use GitHub Issues for pull requests or bug reports only.

Screenshot

screenshot

Installation

To get started please run:

sh -c "`curl -fsSL https://raw.githubusercontent.com/skwp/dotfiles/master/install.sh`"

Note: YADR will automatically install all of its subcomponents. If you want to be asked about each one, use:

sh -c "`curl -fsSL https://raw.githubusercontent.com/skwp/dotfiles/master/install.sh`" -s ask

Wait, you're not done! Do this:

Install iTerm Solarized Colors

YADR will install Solarized colorschemes into your iTerm. Go to Profiles => Colors => Load Presets to pick Solarized Dark.

Remap caps-lock to escape with Karabiner-Elements

The escape key is the single most used key in vim. Old keyboards used to have Escape where Tab is today. Apple keyboards are the worst with their tiny Esc keys. But all this is fixed by remapping Caps to Escape. If you're hitting a small target in the corner, you are slowing yourself down considerably, and probably damaging your hands with repetitive strain injuries.

Set up a system wide hotkey for iTerm (Keys=>Hotkey)

Recommended Cmd-Escape, which is really Cmd-Capslock.

In iTerm, uncheck "Native full screen windows" on General

This will give you fast full screen windows that are switchable without switching to spaces.

in MacVim, uncheck "Prefer native full-screen support" under Advanced settings

Same as iTerm. The native spaces navigation slows everything down for no reason.

If you want to run vim in terminal

Make sure you install Solarized colorscheme in your terminal!
If you don't want to use solarized terminal, then make sure you do this:
```
let g:yadr_using_unsolarized_terminal = 1
# in ~/.vimrc.before
```
If you want to use an alternate colorcheme like Gruvbox, then in your ~/.vimrc.after do:
```
let g:yadr_disable_solarized_enhancements = 1
colorscheme base16-twilight
```

Upgrading

Upgrading is easy.

cd ~/.yadr
git pull --rebase
rake update

What's included, and how to customize?

Read on to learn what YADR provides!

Homebrew

Homebrew is the missing package manager for macOS. Installed automatically.

We automatically install a few useful packages including ctags, git, macvim, hub, and the silver searcher ('ag') Note that our autocomplete plugin requires a MacVim that supports Lua. The installer knows how to install it, but if you had one installed before, you may need to manually remove your old MacVim.

ZSH

Think of Zsh as a more awesome bash without having to learn anything new. Automatic spell correction for your commands, syntax highlighting, and more. We've also provided lots of enhancements:

Vim mode and bash style Ctrl-R for reverse history finder
Ctrl-x,Ctrl-l to insert output of last command
Fuzzy matching - if you mistype a directory name, tab completion will fix it
fasd integration - hit z and partial match for recently used directory. Tab completion enabled.
Prezto - the power behind YADR's zsh
How to add your own ZSH theme

Aliases

Lots of things we do every day are done with two or three character mnemonic aliases. Please feel free to edit them:

ae # alias edit
ar # alias reload

Git Customizations:

YADR will take over your ~/.gitconfig, so if you want to store your usernames, please put them into ~/.gitconfig.user

It is recommended to use this file to set your user info. Alternately, you can set the appropriate environment variables in your ~/.secrets.

git l or gl- a much more usable git log
git b or gb- a list of branches with summary of last commit
git r - a list of remotes with info
git t or gt- a list of tags with info
git nb or gnb- a (n)ew (b)ranch - like checkout -b
git cp or gcp- cherry-pick -x (showing what was cherrypicked)
git simple - a clean format for creating changelogs
git recent-branches - if you forgot what you've been working on
git unstage / guns (remove from index) and git uncommit / gunc (revert to the time prior to the last commit - dangerous if already pushed) aliases
Some sensible default configs, such as improving merge messages, push only pushes the current branch, removing status hints, and using mnemonic prefixes in diff: (i)ndex, (w)ork tree, (c)ommit and (o)bject
Slightly improved colors for diff
gdmb (g)it (d)elete (m)erged (b)ranches - Deletes all branches already merged on current branch

RubyGems

A .gemrc is included. Never again type gem install whatever --no-ri --no-rdoc. --no-ri --no-rdoc is done by default.

Tmux configuration

tmux.conf provides some sane defaults for tmux on Mac OS like a powerful status bar and vim keybindings. You can customize the configuration in ~/.tmux.conf.user.

Vimization of everything

The provided inputrc and editrc will turn your various command line tools like mysql and irb into vim prompts. There's also an included Ctrl-R reverse history search feature in editrc, very useful in irb, postgres command line, and etc.

Github Issues: ghi gem

We include the ghi command. Try ghi list and have fun managing issues from command line!

Vim - What's included?

A list of some of the most useful commands that YADR provides in vim are included below. This is not a comprehensive list. To get deeper knowledge, practice a few of these every day, and then start looking into the lists of plugins above to learn more.

Navigation

,z - go to previous buffer (:bp)
,x - go to next buffer (:bn)
Cmd-j and Cmd-k to move up and down roughly by functions (Alt in Linux)
Ctrl-o - Old cursor position - this is a standard mapping but very useful, so included here
Ctrl-i - opposite of Ctrl-O (again, this is standard)

Search/Code Navigation

,f - instantly Find definition of class (must have exuberant ctags installed)
,F - same as ,f but in a vertical split
,gf or Ctrl-f - same as vim normal gf (go to file), but in a vertical split (works with file.rb:123 line numbers also)
gF - standard vim mapping, here for completeness (go to file at line number)
,k - Search the current word under the cursor and show results in quickfix window
,K - Grep the current word up to next exclamation point (useful for ruby foo! methods)
Cmd-* - highlight all occurrences of current word (similar to regular * except doesn't move)
,hl - toggle search highlight on and off
,gg or ,ag - Grep command line, type between quotes. Uses Ag Silver Searcher.
After searching with ,gg you can navigate the results with Ctrl-x and Ctrl-z (or standard vim :cn and :cp)
,gd - Grep def (greps for 'def [function name]') when cursor is over the function name
,gcf - Grep Current File to find references to the current file
// - clear the search
,,w (alias ,<esc>) or ,,b (alias ,<shift-esc>) - EasyMotion, a vimperator style tool that highlights jump-points on the screen and lets you type to get there.
,mc - mark this word for MultiCursor (like sublime). Use Ctrl-n (next), Ctrl-p (prev), Ctrl-x(skip) to add more cursors, then do normal vim things like edit the word.
gK - Opens the documentation for the word under the cursor.
Spacebar - Sneak - type two characters to move there in a line. Kind of like vim's f but more accurate.
:Gsearch foo - global search, then do your normal %s/search/replace/g and follow up with :Greplace to replace across all files. When done use :wall to write all the files.

File Navigation

,t - CtrlP fuzzy file selector
,b - CtrlP buffer selector - great for jumping to a file you already have open
Cmd-Shift-M - jump to method - CtrlP tag search with

Dotfiles

Install / Use

README