a6895e2754
commit 7cd477ba7fb2f960c9e832626546e12ab939b59e
Merge: b6e3d5c 9f93628
Author: Bailey Ling <bling@live.ca>
Date: Mon Jul 15 20:07:01 2013 +0000
Merge branch 'solarized-themes-merge' of https://github.com/seletskiy/vim-airline into seletskiy-solarized-themes-merge
commit 9f936281ed072d1bf545f6f80a5f3c2ba544b9c8
Author: Stanislav Seletskiy <s.seletskiy@office.ngs.ru>
Date: Mon Jul 15 11:57:14 2013 +0700
get rid of background detection magic
commit 230b16d3c54fec7d17117c6085c9bdc8c1694375
Author: Stanislav Seletskiy <s.seletskiy@office.ngs.ru>
Date: Sun Jul 14 12:22:30 2013 +0700
merge solarized and solarized2
g:airline_solarized_reduced controls how many colors can change between
mode switching.
vim-airline
Lean & mean statusline for vim that's light as air.
Rationale
There's already powerline, why yet another statusline?
- it's 100% vimscript; no python needed.
- it's small. i want the core plugin to be less than 200 lines as a rule (specifically adhering to the open/closed principle).
- despite the small size, it is fully featured and already integrates with: vim-bufferline, fugitive, unite, ctrlp, minibufexpl, gundo, undotree, nerdtree, tagbar and syntastic.
- it looks good with regular fonts, and provides configuration points so you can use unicode or powerline symbols.
- it's fast to load, taking roughly 1ms. by comparison, powerline needs 60ms on the same machine.
- it's fully customizable; if you know a little
statuslinesyntax you can tweak it to your needs. - it's trivial to write colorschemes; for a minimal theme you need to edit 9 lines of colors. (please send pull requests if you create new themes!)
What about old powerline?
- the old version still works well, but since it's deprecated new features won't get added
- it uses different font codes, which makes it incompatible with other powerline bindings in the same terminal (e.g. bash, zsh, tmux, etc.)
Why's it called airline?
I wrote the initial version on an airplane, and since it's light as air it turned out to be a good name. Thanks for flying vim!
Installation
This plugin follows the standard runtime path structure, and as such it can be installed with a variety of plugin managers:
- pathogen
git clone https://github.com/bling/vim-airline ~/.vim/bundle/vim-airline- neobundle
NeoBundle 'bling/vim-airline'- vundle
Bundle 'bling/vim-airline'- manual
- copy all of the files into your
~/.vimdirectory
Configuration
:help airline
Integrating with powerline fonts
For the nice looking powerline symbols to appear, you will need to install a patched font. Instructions can be found in the official powerline documentation. Prepatched fonts can be found in the powerine-fonts repository.
Finally, enable them in vim-airline by adding let g:airline_powerline_fonts = 1 to your vimrc.
Bugs
If you encounter a bug, please do the following:
- reproduce it with this minivimrc repository to rule out any configuration conflicts.
- specify your version and patch level, as well as operating system (found with
:version). - a link to a gist or your vimrc where it can be reproduced.
FAQ/Troubleshooting
Solutions to common problems can be found in the Wiki.
Screenshots
A full list of screenshots can be found in the Wiki.
Contributions
Contributions and pull requests are welcome. Please take note of the following guidelines:
- adhere to the existing style as much as possible; notably, 2 space indents and long-form keywords.
- keep the history clean! squash your branches before you submit a pull request.
pull --rebaseis your friend. - this plugin got a lot more popular than i initially expected, if you make changes to the core, please test on as many versions of vim as possible.
License
Distributed under the same terms as the Vim license. See :help license.