NOTE: This project is in maintenance mode and not currently being developed or maintained. Pull requests will be reviewed and accepted but may not get an immediate response. Sorry for the inconvenience.
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 utf-8
separators.
(require 'powerline)
(powerline-default-theme)
The second line customizes mode-line-format
according to the default theme.
There are five builtin themes:
powerline-default-theme
powerline-center-theme
powerline-center-evil-theme
powerline-vim-theme
powerline-nano-theme
You can revert back to the original value of mode-line-format
that was being used when powerline was loaded using powerline-revert
.
The faces that powerline uses for the builtin themes are powerline-active1
and powerline-active2
for the active modeline, and powerline-inactive1
ande 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 mode-line-format
.
Please look over the powerline-default-theme
and powerline-center-theme
in 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 powerline-default-theme
the let*
defines two lists: lhs
and 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 lhs
and 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.
- Cleaner code.
- Try to simply be a library that provides functions for generating a mode-line
- Make right-aligned text actually be flush against the right side.
- Separators are designed to dynamically size their height based on the font settings.
- Separators spread their width to the nearest character width. (This is required to make right-aligned text actually be right-aligned)
The function should return an XPM image created using the create-image
function.
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 (font-char-height)
Separators should consider the height
when they are created so that the mode-line can change sizes based on the font height.