Maximum Awesome
Config files for vim and tmux, lovingly tended by a small subculture of
peace-loving hippies. Built for Mac OS X.
What's in it?
- MacVim (independent or for use in a terminal)
- iTerm 2
- tmux
- Awesome syntax highlighting with the Solarized color scheme
- Want to know more? Fly Vim, First Class
vim
,dbrings up NERDTree, a sidebar buffer for navigating and manipulating files,tbrings up ctrlp.vim, a project file filter for easily opening specific files,brestricts ctrlp.vim to open buffers,astarts project search with ag.vim using the silver searcher (like ack, but faster)ds/csdelete/change surrounding characters (e.g."Hey!"+ds"=Hey!,"Hey!"+cs"'='Hey!') with vim-surroundgcctoggles current line commentgctoggles visual selection comment linesvii/vaivisually select in or around the cursor's indentVp/vpreplaces visual selection with default register without yanking selected text (works with any visual selection),[space]strips trailing whitespace<C-]>jump to definition using ctags,lbegins aligning lines on a string, usually used as,l=to align assignments<C-hjkl>move between windows, shorthand for<C-w> hjkl
tmux
<C-a>is the prefix- mouse scroll initiates tmux scroll
prefix vmakes a vertical splitprefix smakes a horizontal split
If you have three or more panes:
prefix +opens up the main-horizontal-layoutprefix =opens up the main-vertical-layout
You can adjust the size of the smaller panes in tmux.conf by lowering or increasing the other-pane-height and other-pane-width options.
Install
rake
Update
rake
This will update all installed plugins using Vundle's :PluginInstall!
command. Any errors encountered during this process may be resolved by clearing
out the problematic directories in ~/.vim/bundle. :help PluginInstall
provides more detailed information about Vundle.
Customize
In your home directory, Maximum Awesome creates .vimrc.local, .vimrc.bundles.local and .tmux.conf.local files where you can customize
Vim and tmux to your heart’s content. However, we’d love to incorporate your changes and improve Vim and tmux
for everyone, so feel free to fork Maximum Awesome and open some pull requests!
Uninstall
rake uninstall
Note that this won't remove everything, but your vim configuration should be reset to whatever it was before installing. Some uninstallation steps will be manual.
Contribute
Before creating your pull request, consider whether the feature you want to add
is something that you think every user of maximum-awesome should have. Is it
support for a very common language people would ordinarily use vim to write? Is
it a useful utility that does not change many defaults and composes well with
other parts of maximum-awesome? If so then perhaps it would be a good fit. If
not, perhaps keep it in your *.local files. This does not apply to bug fixes.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
Any contributors to the master maximum-awesome repository must sign the
Individual Contributor License Agreement (CLA). It's a short form that
covers our bases and makes sure you're eligible to contribute.
When you have a change you'd like to see in the master repository, send a pull
request. Before we merge your
request, we'll make sure you're in the list of people who have signed a CLA.
Acknowledgements
Thanks to the vimsters at Square who put this together. Thanks to Tim Pope for
his awesome vim plugins.