doom-modeline/README.md

61 lines
2 KiB
Markdown
Raw Normal View History

2018-06-11 23:20:04 +08:00
# doom-modeline
2018-06-12 01:13:02 +08:00
2018-07-05 15:23:44 +08:00
[![Build Status](https://travis-ci.org/seagle0128/doom-modeline.svg?branch=master)](https://travis-ci.org/seagle0128/doom-modeline)
2018-07-05 14:42:35 +08:00
[![MELPA](https://melpa.org/packages/doom-modeline-badge.svg)](https://melpa.org/#/doom-modeline)
2018-07-05 15:01:25 +08:00
[![MELPA Stable](https://stable.melpa.org/packages/doom-modeline-badge.svg)](https://stable.melpa.org/#/doom-modeline)
2018-06-17 22:49:51 +08:00
[![License](http://img.shields.io/:license-gpl3-blue.svg)](http://www.gnu.org/licenses/gpl-3.0.html)
2018-07-05 15:54:06 +08:00
A fancy mode-line from [DOOM Emacs](https://github.com/hlissner/doom-emacs/tree/master/modules/ui/doom-modeline).
It's integrated to [Centaur Emacs](https://github.com/seagle0128/.emacs.d).
2018-06-12 01:44:37 +08:00
2018-06-12 01:13:02 +08:00
## Feature
The DOOM modeline was designed for minimalism, and offers:
2018-06-22 15:19:52 +08:00
- A match count panel (for anzue, iedit, evil-search and evil-substitute)
2018-06-12 01:13:02 +08:00
- An indicator for recording a macro
2018-06-22 15:19:52 +08:00
- Local python/ruby/go version in the major-mode
- A customizable mode-line height (see doom-modeline-height)
2018-06-12 01:13:02 +08:00
- An error/warning count segment for flycheck
2018-06-22 15:19:52 +08:00
- A workspace number segment for eyebrowse
2018-07-05 15:16:11 +08:00
- A window number segment for winum and window-numbering
2018-06-12 01:13:02 +08:00
## Install
### Manual
From melpa, `M-x package-install RET doom-modeline RET`.
In `init.el`,
``` emacs-lisp
(require 'doom-modeline)
2018-06-13 14:58:30 +08:00
(doom-modeline-init)
2018-06-12 01:13:02 +08:00
```
### Use-package
``` emacs-lisp
(use-package doom-modeline
:ensure t
2018-06-12 23:56:12 +08:00
:defer t
:hook (after-init . doom-modeline-init))
2018-06-12 01:13:02 +08:00
```
This package requires the fonts included with `all-the-icons` to be installed.
Run `M-x all-the-icons-install-fonts` to do so.
## Screenshots
![modeline](https://github.com/hlissner/doom-emacs/raw/screenshots/ml.png)
![search](https://github.com/hlissner/doom-emacs/raw/screenshots/ml-search.png)
![subst](https://github.com/hlissner/doom-emacs/raw/screenshots/ml-subst.png)
![macro](https://github.com/hlissner/doom-emacs/raw/screenshots/ml-macro.png)
![version](https://github.com/hlissner/doom-emacs/raw/screenshots/ml-version.png)
![errors](https://github.com/hlissner/doom-emacs/raw/screenshots/ml-errors.png)