Emacs - disable counsel-describe-function.
[dotfiles.git] / emacs.d / emacs-evil.org
1 #+TITLE:Emacs Evil Config
2 #+AUTHOR: Peng Li
3 #+EMAIL: seudut@gmail.com
4  
5 As the =Evil= mode is significant, and has lots of configurations, it's better put them 
6 in a separate file.
7
8 * Evil mode 
9 ** Install and basic config
10 https://www.emacswiki.org/emacs/Evil.
11 =global-evil-leader-mode= should be set before =evil-mode=.
12 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
13   (use-package evil
14     :ensure t
15     :init
16     ;; (setq evil-default-state 'emacs)
17     (setq evil-emacs-state-cursor '("red" box))
18     (setq evil-normal-state-cursor '("green" box))
19     (setq evil-motion-state-cursor '("green" box))
20     (setq evil-visual-state-cursor '("orange" box))
21     (setq evil-insert-state-cursor '("red" bar))
22     (setq evil-replace-state-cursor '("red" bar))
23     (setq evil-operator-state-cursor '("red" hollow))
24     ;; others, don't move back cursor when exit insert mode
25     (setq evil-move-cursor-back nil)
26     :config
27     (use-package evil-leader
28       :ensure t
29       :init
30       :config
31       (evil-leader/set-leader ";")
32       (global-evil-leader-mode))
33     ;; (require 'evil-leader)
34     (evil-mode t))
35
36   (add-hook 'prog-mode-hook #'(lambda ()
37                                 (modify-syntax-entry ?_ "w")
38                                 ;; (modify-syntax-entry ?- "w")
39                                 ))
40
41   (with-eval-after-load "evil"
42     ;; remap x to X as `evil-move-cursor-back' is set nil
43     ;; (define-key evil-normal-state-map [remap evil-delete-char] 'evil-delete-backward-char)
44     (define-key evil-normal-state-map (kbd "x") (lambda () (interactive)
45                                                   (let ((org evil-move-cursor-back))
46                                                     (setq evil-move-cursor-back t)
47                                                     (call-interactively 'evil-delete-char)
48                                                     ;; (evil-delete-char)
49                                                     (setq evil-move-cursor-back org)))))
50 #+END_SRC
51
52 ** Initial mode and state config
53 - Use =normal= as the default state but exclude some special modes.
54 - Bind =[escape]=  to =normal= mode. This only works on GUI Emacs. If need to work on Terminal, shoudl also bind =(kbd
55   "<ESC>)=, but this will make the combined key =M-= not wor.
56 - Not alias =insert= state to =emacs= state, as it break some vi's feature in insert mode, such as column edit. Instead,
57   here add a advice function to change the sate as emacs when enter insert mode, but this is only limited in some
58   certain modes.
59 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
60   (defvar my-mode-list-to-use-emacs-as-insert '(emacs-lisp-mode
61                                                 org-mode
62                                                 eshell-mode
63                                                 lisp-interaction-mode)
64     "The mode in this list will consider insert state as emacs state by adding `advice-add' below.")
65
66   (defvar my-modes-use-emacs-init '(emacs-lisp-mode
67                                     org-mode
68                                     lisp-interaction-mode
69                                     eshell-mode
70                                     text-mode
71                                     package-menu-mode
72                                     paradox-menu-mode)
73     "The mode in this list will use emacs sate as a initial evil state.")
74
75   (with-eval-after-load "evil"
76     (setq evil-default-state 'normal)
77       ;; (defalias 'evil-inset-mode 'evil-emacs-state)
78     (define-key evil-emacs-state-map [escape] 'evil-normal-state)
79     ;; (define-key evil-emacs-state-map (kbd "<ESC>") 'evil-normal-state)
80     (dolist (mode my-modes-use-emacs-init) (evil-set-initial-state mode 'emacs))
81     (advice-add 'evil-insert-state :after (lambda (&optional arg)
82                                             (when (memq major-mode my-mode-list-to-use-emacs-as-insert)
83                                               (evil-emacs-state)))))
84 #+END_SRC
85
86 * Evil-escape
87 [[https://github.com/syl20bnr/evil-escape][evil-escape]], escape from anything with customizable key sequence.
88 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
89   (use-package evil-escape
90     :ensure t
91     :init
92     (setq-default evil-escape-delay 0.2)
93     (setq-default evil-escape-key-sequence "jj")
94     (setq-default evil-escape-excluded-states '(normal visual motion emacs))
95     (setq-default evil-escape-excluded-major-modes '(emacs-lisp-mode org-mode))
96     :config
97     (evil-escape-mode))
98 #+END_SRC
99
100 * other extention
101 ** Evil-matchit
102 [[https://github.com/redguardtoo/evil-matchit]]
103 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
104   (use-package evil-matchit
105     :ensure t
106     :config
107     (global-evil-matchit-mode 1))
108 #+END_SRC
109
110 ** Evil-visualstar
111 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
112   (use-package evil-visualstar
113     :ensure t
114     :init
115     (setq evil-visualstar/persistent t)
116     :config
117     (global-evil-visualstar-mode))
118 #+END_SRC
119
120 ** Evil-surround
121 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
122   (use-package evil-surround
123     :ensure t
124     :config
125     (global-evil-surround-mode 1))
126 #+END_SRC
127 * Key bindings
128 ** Evil-Leader
129 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
130   (with-eval-after-load "evil-leader"
131     ;; Buffer & File explore
132     (evil-leader/set-key "b" 'counsel-projectile-find-file)
133     (evil-leader/set-key "f" 'ivy-switch-buffer)
134     (evil-leader/set-key "r" 'ivy-recentf)
135     (evil-leader/set-key "w" 'save-buffer)
136     ;; Window
137     (evil-leader/set-key "s" 'evil-window-split)
138     (evil-leader/set-key "v" 'evil-window-vsplit)
139     (evil-leader/set-key "t" 'sd/hydra-window-layout/body)
140     (evil-leader/set-key "q" 'evil-quit)
141     ;; others
142     (evil-leader/set-key "g" 'magit-status)
143     ;; (evil-leader/set-key "d" (lambda () (interactive) (dired default-directory)))
144     (evil-leader/set-key "d" 'dired)
145     (evil-leader/set-key "e" 'sd/toggle-project-eshell)
146     (evil-leader/set-key "h" 'help))
147 #+END_SRC
148 ** Basic state bindings
149 There are three kinds key bindings
150 - prefix key is the leader key, defined by evil-leader.
151 - prefix key is the =Ctrl=,
152 - prefix key is =\=, 
153
154 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
155   (with-eval-after-load "evil"
156     (mapc (lambda (map)
157             (define-key map "\C-W s" 'evil-window-split)
158             (define-key map "\C-W v" 'evil-window-vsplit)
159             (define-key map "\C-h" 'evil-window-left)
160             (define-key map "\C-j" 'evil-window-down)
161             (define-key map "\C-k" 'evil-window-up)
162             (define-key map "\C-l" 'evil-window-right)
163             (define-key map (kbd "C->") (lambda () (interactive) (evil-window-increase-width 3)))
164             (define-key map (kbd "C-<") (lambda () (interactive) (evil-window-decrease-width 3)))
165             (define-key map (kbd "C-+") (lambda () (interactive) (evil-window-increase-height 3)))
166             (define-key map (kbd "C--") (lambda () (interactive) (evil-window-decrease-height 3)))
167             (define-key map (kbd "C-=") (lambda () (interactive) (balance-windows))))
168           (list evil-normal-state-map evil-motion-state-map))
169     ;; normal state
170     (define-key evil-normal-state-map (kbd "C-SPC") 'mode-line-other-buffer)
171     (define-key evil-normal-state-map (kbd "C-;") 'previous-multiframe-window)
172     ;; insert state
173     (define-key evil-insert-state-map (kbd "C-p") 'previous-line)
174     (define-key evil-insert-state-map (kbd "C-n") 'next-line)
175     (define-key evil-insert-state-map (kbd "C-h") 'delete-backward-char)
176     (define-key evil-insert-state-map (kbd "C-a") 'move-beginning-of-line)
177     (define-key evil-insert-state-map (kbd "C-e") 'move-end-of-line)
178     (define-key evil-insert-state-map (kbd "C-k") 'kill-line)
179     ;; motion mode
180     (define-key evil-motion-state-map (kbd "SPC") 'scroll-up-command)
181     (define-key evil-motion-state-map (kbd "S-SPC") 'scroll-down-command))
182 #+END_SRC
183
184
185 Let the search highlight persistent, https://stackoverflow.com/questions/25768036/emacs-evil-non-incremental-search-and-persistent-highlighting/34252236
186 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
187   (evil-select-search-module 'evil-search-module 'evil-search)
188
189   (with-eval-after-load "evil"
190     (define-key evil-normal-state-map "\\" nil)
191     (define-key evil-normal-state-map "\\\\" #'evil-ex-nohighlight))
192 #+END_SRC
193
194 ** Eshell
195 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
196   (add-hook 'eshell-mode-hook (lambda ()
197                                 (when (and (boundp 'evil-mode) evil-mode)
198                                   (dolist (key-fun '(("f" . ivy-switch-buffer)
199                                                      ("b" . counsel-projectile-find-file)
200                                                      ("r" . counsel-recentf)
201                                                      ("t" . sd/hydra-window-layout/body)
202                                                      ("e" . sd/toggle-project-eshell)
203                                                      ("d" . dired)
204                                                      ("'" . other-window)
205                                                      ("h" . help)
206                                                      ("q" . evil-quit)))
207                                     (evil-define-key 'emacs eshell-mode-map (kbd (concat evil-leader/leader (car key-fun))) (cdr key-fun))))
208                                 ;; (define-key eshell-mode-map (kbd "C-j") nil)
209                                 ))
210
211   ;; 
212   ;; (add-hook 'eshell-mode-map
213   ;;        (lambda ()
214   ;;          (mapc (lambda (key-fun)
215   ;;                  (evil-define-key 'emacs eshell-mode-map (kbd (concat evil-leader/leader (car key-fun))) (cdr key-fun)))
216   ;;                '(("e" . dired)))))
217
218   ;; (add-hook 'eshell-mode-hook (lambda ()
219   ;;                               (loop for (key . fun) in '(
220   ;;                                                          ("e" . sd/toggle-project-eshell))
221   ;;                                     do (evil-define-key 'emacs eshell-mode-map (kbd (concat evil-leader/leader key)) fun))))
222 #+END_SRC
223 ** Dired mode
224 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
225   (with-eval-after-load "evil"
226     ;; file and directory explore
227     (define-key dired-mode-map (kbd "C-h") nil)
228     (define-key dired-mode-map (kbd "C-k") nil)
229     (evil-define-key 'normal dired-mode-map (kbd "H") 'dired-omit-mode)
230     (evil-define-key 'normal dired-mode-map (kbd "g") 'dired-goto-file)
231     (evil-define-key 'normal dired-mode-map (kbd "r") 'revert-buffer)
232     (evil-define-key 'normal dired-mode-map (kbd "i") 'dired-maybe-insert-subdir)
233     (evil-define-key 'normal dired-mode-map (kbd "TAB") 'diredp-next-subdir)
234     (evil-define-key 'normal dired-mode-map (kbd "J") 'diredp-next-subdir)
235     (evil-define-key 'normal dired-mode-map (kbd "K") 'diredp-prev-subdir)
236     (evil-define-key 'normal dired-mode-map (kbd "l") 'dired-display-file)
237     (evil-define-key 'normal dired-mode-map (kbd "f") 'dired-narrow)
238     (evil-define-key 'normal dired-mode-map (kbd "j") 'sd/dired-next-line)
239     (evil-define-key 'normal dired-mode-map (kbd "k") 'sd/dired-previous-line)
240     (evil-define-key 'normal dired-mode-map (kbd "h") 'sd/dired-up-directory)
241     (evil-define-key 'normal dired-mode-map [C-backspace] 'dired-up-directory)
242     ;; file and folder deletion
243     (evil-define-key 'normal dired-mode-map (kbd "m") 'dired-mark)
244     (evil-define-key 'normal dired-mode-map (kbd "u") 'dired-unmark)
245     (evil-define-key 'normal dired-mode-map (kbd "U") 'dired-unmark-all-marks)
246     (evil-define-key 'normal dired-mode-map (kbd "z") #'sd/dired-get-size)
247     (evil-define-key 'normal dired-mode-map (kbd "d") 'dired-flag-file-deletion)
248     (evil-define-key 'normal dired-mode-map (kbd "x") 'dired-do-flagged-delete)
249     (evil-define-key 'normal dired-mode-map (kbd "D") 'dired-do-delete)
250     ;; File and folder creation
251     (evil-define-key 'normal dired-mode-map (kbd "c") 'sd/dired-new-file)
252     (evil-define-key 'normal dired-mode-map (kbd "+") 'dired-create-directory)
253     (evil-define-key 'normal dired-mode-map (kbd "C") 'dired-do-copy)
254     (evil-define-key 'normal dired-mode-map (kbd "R") 'dired-do-rename)
255
256     ;; keep some normap mapping
257     (evil-define-key 'normal dired-mode-map (kbd "/") 'evil-ex-search-forward)
258     (evil-define-key 'normal dired-mode-map (kbd "n") 'evil-search-next)
259     (evil-define-key 'normal dired-mode-map (kbd "N") 'evil-search-previous)
260     (evil-define-key 'normal dired-mode-map (kbd "v") 'evil-visual-char))
261
262 #+END_SRC
263
264 ** expand region
265 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
266   (with-eval-after-load "evil"
267     (with-eval-after-load "expand-region"
268       (define-key evil-normal-state-map (kbd "SPC") 'er/expand-region)
269       (define-key evil-visual-state-map (kbd "SPC") 'er/expand-region)
270       (define-key evil-visual-state-map (kbd "S-SPC") 'er/contract-region)
271       (define-key evil-normal-state-map (kbd "S-SPC") 'er/contract-region)))
272 #+END_SRC
273
274 ** Org Mode (worf mode) and Lispy mode
275 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
276   (with-eval-after-load "evil"
277     (with-eval-after-load "lispy"
278       (evil-define-key 'normal lispy-mode-map (kbd "[") (lambda ()
279                                                           (interactive)
280                                                           (call-interactively #'lispy-backward)
281                                                           (evil-emacs-state)))
282       (evil-define-key 'normal lispy-mode-map (kbd "]") (lambda ()
283                                                           (interactive)
284                                                           (call-interactively #'lispy-forward)
285                                                           (evil-emacs-state))))
286     (with-eval-after-load "worf"
287       (evil-define-key 'normal worf-mode-map (kbd "[") (lambda ()
288                                                          (interactive)
289                                                          (call-interactively #'worf-backward)
290                                                          (evil-emacs-state)))
291       (evil-define-key 'normal worf-mode-map (kbd "]") (lambda ()
292                                                          (interactive)
293                                                          (call-interactively #'worf-forward)
294                                                          (evil-emacs-state)))))
295 #+END_SRC
296
297 * Others
298 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
299   (dolist (mode '(c-mode-hook lua-mode-hook))
300     (add-hook mode (lambda () (setq indent-tabs-mode nil))))
301 #+END_SRC
302 * Provide 
303 #+BEGIN_SRC emacs-lisp :tangle yes :results silent
304   (provide 'init-evil-mode)
305 #+END_SRC