2018-06-11 15:20:04 +00:00
|
|
|
# doom-modeline
|
2018-06-11 17:13:02 +00:00
|
|
|
|
2018-07-05 07:23:44 +00:00
|
|
|
[](https://travis-ci.org/seagle0128/doom-modeline)
|
2018-07-05 06:42:35 +00:00
|
|
|
[](https://melpa.org/#/doom-modeline)
|
2018-07-05 07:01:25 +00:00
|
|
|
[](https://stable.melpa.org/#/doom-modeline)
|
2018-06-17 14:49:51 +00:00
|
|
|
[](http://www.gnu.org/licenses/gpl-3.0.html)
|
|
|
|
|
|
2018-07-05 07:54:06 +00: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-11 17:44:37 +00:00
|
|
|
|
2018-06-11 17:13:02 +00:00
|
|
|
## Feature
|
|
|
|
|
|
|
|
|
|
The DOOM modeline was designed for minimalism, and offers:
|
|
|
|
|
|
2018-08-23 03:10:51 +00:00
|
|
|
- A match count panel (for `anzu`, `iedit`, `multi-cusor`, `evil-search` and `evil-substitute`)
|
2018-06-11 17:13:02 +00:00
|
|
|
- An indicator for recording a macro
|
2018-08-23 03:10:51 +00: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-28 16:47:43 +00:00
|
|
|
- An indicator for current input method
|
2018-06-11 17:13:02 +00:00
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
### Manual
|
|
|
|
|
|
|
|
|
|
From melpa, `M-x package-install RET doom-modeline RET`.
|
|
|
|
|
|
|
|
|
|
In `init.el`,
|
|
|
|
|
|
|
|
|
|
``` emacs-lisp
|
|
|
|
|
(require 'doom-modeline)
|
2018-06-13 06:58:30 +00:00
|
|
|
(doom-modeline-init)
|
2018-06-11 17:13:02 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Use-package
|
|
|
|
|
|
|
|
|
|
``` emacs-lisp
|
|
|
|
|
(use-package doom-modeline
|
|
|
|
|
:ensure t
|
2018-06-12 15:56:12 +00:00
|
|
|
:defer t
|
2018-06-15 15:18:51 +00:00
|
|
|
:hook (after-init . doom-modeline-init))
|
2018-06-11 17:13:02 +00: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 07:08:12 +00:00
|
|
|
Recommand to use [doom-themes](https://github.com/hlissner/emacs-doom-themes);
|
|
|
|
|
|
2018-10-07 14:20:31 +00:00
|
|
|
## Customize
|
|
|
|
|
|
|
|
|
|
``` emacs-lisp
|
2018-10-25 08:11:03 +00:00
|
|
|
;; How tall the mode-line should be (only respected in GUI Emacs).
|
2018-10-07 14:20:31 +00:00
|
|
|
(setq doom-modeline-height 25)
|
|
|
|
|
|
2018-10-25 08:11:03 +00:00
|
|
|
;; How wide the mode-line bar should be (only respected in GUI Emacs).
|
2018-10-07 14:20:31 +00:00
|
|
|
(setq doom-modeline-bar-width 3)
|
|
|
|
|
|
2018-10-25 08:11:03 +00:00
|
|
|
;; Determines the style used by `doom-modeline-buffer-file-name'.
|
2018-10-15 12:58:27 +00: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 14:20:31 +00:00
|
|
|
;; Please refer to https://github.com/bbatsov/projectile/issues/657.
|
|
|
|
|
(setq doom-modeline-buffer-file-name-style 'truncate-upto-project)
|
|
|
|
|
|
2018-10-25 08:11:03 +00:00
|
|
|
;; What executable of Python will be used (if nil nothing will be showed).
|
2018-10-07 14:20:31 +00:00
|
|
|
(setq doom-modeline-python-executable "python")
|
2018-10-25 08:11:03 +00:00
|
|
|
|
|
|
|
|
;; Whether show `all-the-icons' or not (if nil nothing will be showed).
|
|
|
|
|
;; The icons may not be showed correctly on Windows. Disable to make it work.
|
|
|
|
|
(setq doom-modeline-icon t)
|
2018-10-07 14:20:31 +00:00
|
|
|
```
|
|
|
|
|
|
2018-06-11 17:13:02 +00:00
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-08-12 06:44:22 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
