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
|
|
|
[](https://travis-ci.org/seagle0128/doom-modeline)
|
2018-07-05 14:42:35 +08:00
|
|
|
[](https://melpa.org/#/doom-modeline)
|
2018-07-05 15:01:25 +08:00
|
|
|
[](https://stable.melpa.org/#/doom-modeline)
|
2018-06-17 22:49:51 +08:00
|
|
|
[](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-08-23 11:10:51 +08:00
|
|
|
- A match count panel (for `anzu`, `iedit`, `multi-cusor`, `evil-search` and `evil-substitute`)
|
2018-06-12 01:13:02 +08:00
|
|
|
- An indicator for recording a macro
|
2018-08-23 11:10:51 +08:00
|
|
|
- Local `python`/`ruby`/`perl`/`go`/`elixir` version in the major-mode
|
|
|
|
|
- A customizable mode-line height (see `doom-modeline-height`)
|
|
|
|
|
- An error/warning count segment for `flycheck`
|
|
|
|
|
- A workspace number segment for `eyebrowse`
|
|
|
|
|
- A window number segment for `winum` and `window-numbering`
|
|
|
|
|
- An indicator for `evil` state
|
2018-09-29 00:47:43 +08:00
|
|
|
- An indicator for current input method
|
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
|
2018-06-15 09:18:51 -06:00
|
|
|
: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.
|
|
|
|
|
|
2018-09-14 15:08:12 +08:00
|
|
|
Recommand to use [doom-themes](https://github.com/hlissner/emacs-doom-themes);
|
|
|
|
|
|
2018-10-07 22:20:31 +08:00
|
|
|
## Customize
|
|
|
|
|
|
|
|
|
|
``` emacs-lisp
|
|
|
|
|
;; How tall the mode-line should be (only respected in GUI Emacs)
|
|
|
|
|
(setq doom-modeline-height 25)
|
|
|
|
|
|
|
|
|
|
;; How wide the mode-line bar should be (only respected in GUI Emacs)
|
|
|
|
|
(setq doom-modeline-bar-width 3)
|
|
|
|
|
|
|
|
|
|
;; Determines the style used by `doom-modeline-buffer-file-name'
|
2018-10-15 20:58:27 +08:00
|
|
|
;; If you are expereicing the laggy issue, especially while editing remote files
|
|
|
|
|
;; with tramp, please use `file-name', `truncate-all' or `truncate-upto-root'
|
|
|
|
|
;; style.
|
2018-10-07 22:20:31 +08:00
|
|
|
;; Please refer to https://github.com/bbatsov/projectile/issues/657.
|
|
|
|
|
(setq doom-modeline-buffer-file-name-style 'truncate-upto-project)
|
|
|
|
|
|
|
|
|
|
;; What executable of Python will be used (if nil nothing will be shown)
|
|
|
|
|
(setq doom-modeline-python-executable "python")
|
|
|
|
|
```
|
|
|
|
|
|
2018-06-12 01:13:02 +08:00
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-08-12 14:44:22 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
