git clone 'git://github.com/milkypostman/powerline.git'
Emacs version of the Vim powerline.
This is a proposed version 2.0 of the original Emacs Powerline which is a fork of vim-powerline.
This version has utf-8 support enabled. The
utf-8 separators will display a unicode character properly under mintty for example - as long as you have patched fonts installed.
By default, any terminal mode emacs will use the
(require 'powerline) (powerline-default-theme)
The second line customizes
mode-line-format according to the default theme.
There are two builtin themes:
You can revert back to the original value of
mode-line-format that was being used when powerline was loaded using
The faces that powerline uses for the builtin themes are
powerline-active2 for the active modeline, and
powerline-inactive2 for the inactive modelines. If you create your own theme, you can add as many faces as you want and pass those faces to the corresponding
powerline-* functions when creating your
Please look over the
powerline-themes.el for examples of themes that involve different justifications of modeline text.
You can write your own powerline theme by simply setting your own
mode-line-format to be an evaluation (
:eval) of the powerline functions. Notice in
let* defines two lists:
rhs which are exactly the lists that define what goes on the left and right sides of the modeline. The
powerline-center-theme demonstrates how to center justify part of the modeline and defines an additional
center list which is exactly the modeline components to be displayed in the middle section.
In most circumstances you should only need to modify the builtin themes unless you are trying to do a particularly unique layout.
This theme does some tricks to improve performance and get all the text justified properly. First, it sets
rhs to a list of powerline sections. You can easily re-utilize builtin modeline formatting by adding it as a raw powerline section. For example,
(powerline-raw mode-line-mule-info nil 'l)
would add the formatting defined in
mode-line-mule-info to the modeline as it appears in the default modeline.
The last line of this is what actually puts it all together, by concatonating the
lhs, some “fill” space, and
rhs. This must be done to ensure that the padding in between the left and right sections properly fills the modeline.
The function should return an XPM image created using the
There is a function called
memoize that will help make calling the function multiple times with the same parameters be much quicker by caching the return value.
Each divider should have the signature:
(face1 face2 &optional height)
face1 : the left-hand face
face2 : the right-hand face
height : specifies the height of the XPM, most of time this is
Separators should consider the
height when they are created so that the mode-line can change sizes based on the font height.