Commit | Line | Data |
---|---|---|
180cab37 AB |
1 | #+title: =aminb='s Literate Emacs Configuration |
2 | #+author: Amin Bandali | |
3 | #+babel: :cache yes | |
4 | #+property: header-args :tangle yes | |
5 | ||
6 | * About | |
7 | :PROPERTIES: | |
8 | :CUSTOM_ID: about | |
9 | :END: | |
10 | ||
11 | This org file is my literate configuration for GNU Emacs, and is | |
3b98e899 AB |
12 | tangled to [[./init.el][init.el]]. Packages are installed and managed using |
13 | [[https://github.com/emacscollective/borg][Borg]]. Over the years, I've taken inspiration from configurations of | |
14 | many different people. Some of the configurations that I can remember | |
15 | off the top of my head are: | |
16 | ||
17 | - [[https://github.com/dieggsy/dotfiles][dieggsy/dotfiles]]: literate Emacs and dotfiles configuration, uses | |
18 | straight.el for managing packages | |
19 | - [[https://github.com/dakra/dmacs][dakra/dmacs]]: literate Emacs configuration, using Borg for managing | |
20 | packages | |
21 | - [[http://pages.sachachua.com/.emacs.d/Sacha.html][Sacha Chua's literate Emacs configuration]] | |
22 | - [[https://github.com/dakrone/eos][dakrone/eos]] | |
23 | - Ryan Rix's [[http://doc.rix.si/cce/cce.html][Complete Computing Environment]] ([[http://doc.rix.si/projects/fsem.html][about cce]]) | |
24 | - [[https://github.com/jwiegley/dot-emacs][jwiegley/dot-emacs]]: nix-based configuration | |
25 | - [[https://github.com/wasamasa/dotemacs][wasamasa/dotemacs]] | |
26 | - [[https://github.com/hlissner/doom-emacs][Doom Emacs]] | |
180cab37 AB |
27 | |
28 | I'd like to have a fully reproducible Emacs setup (part of the reason | |
29 | why I store my configuration in this repository) but unfortunately out | |
30 | of the box, that's not achievable with =package.el=, not currently | |
31 | anyway. So, I've opted to use Borg. For what it's worth, I briefly | |
32 | experimented with [[https://github.com/raxod502/straight.el][straight.el]], but found that it added about 2 seconds | |
33 | to my init time; which is unacceptable for me: I use Emacs as my | |
34 | window manager (via EXWM) and coming from bspwm, I'm too used to | |
35 | having fast startup times. | |
36 | ||
3b98e899 AB |
37 | ** Installation |
38 | ||
4ae2cd62 AB |
39 | To use this config for your Emacs, first you need to clone this repo, |
40 | then bootstrap Borg, tell Borg to retrieve package submodules, and | |
41 | byte-compiled the packages. Something along these lines should work: | |
42 | ||
4b4e432d | 43 | #+begin_src sh :tangle no |
4ae2cd62 AB |
44 | git clone https://github.com/aminb/dotfiles ~/.emacs.d |
45 | cd ~/.emacs.d | |
46 | make bootstrap-borg | |
4ae2cd62 AB |
47 | make bootstrap |
48 | make build | |
49 | #+end_src | |
50 | ||
180cab37 AB |
51 | * Contents :toc_1:noexport: |
52 | ||
53 | - [[#about][About]] | |
54 | - [[#header][Header]] | |
55 | - [[#initial-setup][Initial setup]] | |
56 | - [[#core][Core]] | |
967b0a82 | 57 | - [[#post-initialization][Post initialization]] |
180cab37 AB |
58 | - [[#footer][Footer]] |
59 | ||
60 | * Header | |
61 | :PROPERTIES: | |
62 | :CUSTOM_ID: header | |
63 | :END: | |
64 | ||
65 | ** First line | |
66 | ||
67 | #+begin_src emacs-lisp :comments none | |
68 | ;;; init.el --- Amin Bandali's Emacs config -*- lexical-binding: t ; eval: (view-mode 1)-*- | |
69 | #+end_src | |
70 | ||
71 | Enable =view-mode=, which both makes the file read-only (as a reminder | |
72 | that =init.el= is an auto-generated file, not supposed to be edited), | |
73 | and provides some convenient key bindings for browsing through the | |
74 | file. | |
75 | ||
76 | ** License | |
77 | ||
78 | #+begin_src emacs-lisp :comments none | |
79 | ;; Copyright (C) 2018 Amin Bandali <amin@aminb.org> | |
80 | ||
81 | ;; This program is free software: you can redistribute it and/or modify | |
82 | ;; it under the terms of the GNU General Public License as published by | |
83 | ;; the Free Software Foundation, either version 3 of the License, or | |
84 | ;; (at your option) any later version. | |
85 | ||
86 | ;; This program is distributed in the hope that it will be useful, | |
87 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
88 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
89 | ;; GNU General Public License for more details. | |
90 | ||
91 | ;; You should have received a copy of the GNU General Public License | |
92 | ;; along with this program. If not, see <https://www.gnu.org/licenses/>. | |
93 | #+end_src | |
94 | ||
95 | ** Commentary | |
96 | ||
97 | #+begin_src emacs-lisp :comments none | |
98 | ;;; Commentary: | |
99 | ||
100 | ;; Emacs configuration of Amin Bandali, computer scientist and functional | |
101 | ;; programmer. | |
102 | ||
103 | ;; THIS FILE IS AUTO-GENERATED FROM `init.org'. | |
104 | #+end_src | |
105 | ||
106 | ** Naming conventions | |
107 | ||
108 | The conventions below were inspired by [[https://github.com/hlissner/doom-emacs][Doom]]'s conventions, found | |
109 | [[https://github.com/hlissner/doom-emacs/blob/5dacbb7cb1c6ac246a9ccd15e6c4290def67757c/core/core.el#L3-L17][here]]. Naturally, I use my initials, =ab=, instead of =doom=. | |
110 | ||
111 | #+begin_src emacs-lisp :comments none | |
112 | ;; Naming conventions: | |
113 | ;; | |
114 | ;; ab-... public variables or non-interactive functions | |
115 | ;; ab--... private anything (non-interactive), not safe for direct use | |
116 | ;; ab/... an interactive function; safe for M-x or keybinding | |
117 | ;; ab:... an evil operator, motion, or command | |
118 | ;; ab|... a hook function | |
119 | ;; ab*... an advising function | |
120 | ;; ab@... a hydra command | |
121 | ;; ...! a macro | |
122 | #+end_src | |
123 | ||
124 | * Initial setup | |
125 | :PROPERTIES: | |
126 | :CUSTOM_ID: initial-setup | |
127 | :END: | |
128 | ||
129 | #+begin_src emacs-lisp :comments none | |
130 | ;;; Code: | |
131 | #+end_src | |
132 | ||
133 | ** Emacs initialization | |
134 | ||
135 | I'd like to do a couple of measurements of Emacs' startup time. First, | |
136 | let's see how long Emacs takes to start up, before even loading | |
137 | =init.el=, i.e. =user-init-file=: | |
138 | ||
139 | #+begin_src emacs-lisp | |
140 | (defvar ab--before-user-init-time (current-time) | |
141 | "Value of `current-time' when Emacs begins loading `user-init-file'.") | |
142 | (message "Loading Emacs...done (%.3fs)" | |
143 | (float-time (time-subtract ab--before-user-init-time | |
144 | before-init-time))) | |
145 | #+end_src | |
146 | ||
147 | Also, temporarily increase ~gc-cons-threshhold~ and | |
148 | ~gc-cons-percentage~ during startup to reduce garbage collection | |
149 | frequency. Clearing the ~file-name-handler-alist~ seems to help reduce | |
150 | startup time as well. | |
151 | ||
152 | #+begin_src emacs-lisp | |
153 | (defvar ab--gc-cons-threshold gc-cons-threshold) | |
154 | (defvar ab--gc-cons-percentage gc-cons-percentage) | |
155 | (defvar ab--file-name-handler-alist file-name-handler-alist) | |
156 | (setq gc-cons-threshold (* 400 1024 1024) ; 400 MiB | |
157 | gc-cons-percentage 0.6 | |
158 | file-name-handler-alist nil | |
159 | ;; sidesteps a bug when profiling with esup | |
160 | esup-child-profile-require-level 0) | |
161 | #+end_src | |
162 | ||
163 | Of course, we'd like to set them back to their defaults once we're | |
164 | done initializing. | |
165 | ||
166 | #+begin_src emacs-lisp | |
167 | (add-hook | |
168 | 'after-init-hook | |
169 | (lambda () | |
180cab37 AB |
170 | (setq gc-cons-threshold ab--gc-cons-threshold |
171 | gc-cons-percentage ab--gc-cons-percentage | |
172 | file-name-handler-alist ab--file-name-handler-alist))) | |
173 | #+end_src | |
174 | ||
175 | Increase the number of lines kept in message logs (the =*Messages*= | |
176 | buffer). | |
177 | ||
178 | #+begin_src emacs-lisp | |
179 | (setq message-log-max 20000) | |
180 | #+end_src | |
181 | ||
182 | Optionally, we could suppress some byte compiler warnings like below, | |
183 | but for now I've decided to keep them enabled. See documentation for | |
184 | ~byte-compile-warnings~ for more details. | |
185 | ||
186 | #+begin_src emacs-lisp | |
187 | ;; (setq byte-compile-warnings | |
188 | ;; '(not free-vars unresolved noruntime lexical make-local)) | |
189 | #+end_src | |
190 | ||
41a4f26a AB |
191 | ** whoami |
192 | ||
193 | #+begin_src emacs-lisp | |
194 | (setq user-full-name "Amin Bandali" | |
195 | user-mail-address "amin@aminb.org") | |
196 | #+end_src | |
197 | ||
180cab37 AB |
198 | ** Package management |
199 | ||
200 | *** No =package.el= | |
201 | ||
202 | I can do all my package management things with Borg, and don't need | |
203 | Emacs' built-in =package.el=. Emacs 27 lets us disable =package.el= in | |
204 | the =early-init-file= (see [[https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=24acb31c04b4048b85311d794e600ecd7ce60d3b][here]]). | |
205 | ||
206 | #+begin_src emacs-lisp :tangle early-init.el | |
207 | (setq package-enable-at-startup nil) | |
208 | #+end_src | |
209 | ||
210 | But since Emacs 27 isn't out yet (Emacs 26 is just around the corner | |
211 | right now), and even when released it'll be long before most distros | |
212 | ship in their repos, I'll still put the old workaround with the | |
213 | commented call to ~package-initialize~ here anyway. | |
214 | ||
215 | #+begin_src emacs-lisp | |
216 | (setq package-enable-at-startup nil) | |
217 | ;; (package-initialize) | |
218 | #+end_src | |
219 | ||
220 | *** Borg | |
221 | ||
222 | #+begin_quote | |
223 | Assimilate Emacs packages as Git submodules | |
224 | #+end_quote | |
225 | ||
226 | [[https://github.com/emacscollective/borg][Borg]] is at the heart of package management of my Emacs setup. In | |
227 | short, it creates a git submodule in =lib/= for each package, which | |
228 | can then be managed with the help of Magit or other tools. | |
229 | ||
230 | #+begin_src emacs-lisp | |
231 | (setq user-init-file (or load-file-name buffer-file-name) | |
232 | user-emacs-directory (file-name-directory user-init-file)) | |
233 | (add-to-list 'load-path | |
234 | (expand-file-name "lib/borg" user-emacs-directory)) | |
235 | (require 'borg) | |
236 | (borg-initialize) | |
237 | #+end_src | |
238 | ||
239 | *** =use-package= | |
240 | ||
241 | #+begin_quote | |
242 | A use-package declaration for simplifying your .emacs | |
243 | #+end_quote | |
244 | ||
245 | [[https://github.com/jwiegley/use-package][use-package]] is an awesome utility for managing and configuring | |
246 | packages (in our case especially the latter) in a neatly organized way | |
247 | and without compromising on performance. | |
248 | ||
249 | #+begin_src emacs-lisp | |
250 | (require 'use-package) | |
eb186a5a | 251 | (if nil ; set to t when need to debug init |
180cab37 AB |
252 | (setq use-package-verbose t |
253 | use-package-expand-minimally nil | |
254 | use-package-compute-statistics t | |
255 | debug-on-error t) | |
256 | (setq use-package-verbose nil | |
257 | use-package-expand-minimally t)) | |
258 | #+end_src | |
259 | ||
260 | *** Epkg | |
261 | ||
262 | #+begin_quote | |
263 | Browse the Emacsmirror package database | |
264 | #+end_quote | |
265 | ||
266 | Epkg provides access to a local copy of the [[https://emacsmirror.net][Emacsmirror]] package | |
267 | database, low-level functions for querying the database, and a | |
268 | =package.el=-like user interface for browsing the available packages. | |
269 | ||
270 | #+begin_src emacs-lisp | |
271 | (use-package epkg | |
272 | :defer t) | |
273 | #+end_src | |
274 | ||
275 | ** No littering in =~/.emacs.d= | |
276 | ||
277 | #+begin_quote | |
278 | Help keeping ~/.emacs.d clean | |
279 | #+end_quote | |
280 | ||
281 | By default, even for Emacs' built-in packages, the configuration files | |
282 | and persistent data are all over the place. Use =no-littering= to help | |
283 | contain the mess. | |
284 | ||
285 | #+begin_src emacs-lisp | |
286 | (use-package no-littering | |
287 | :demand t | |
288 | :config | |
289 | (savehist-mode 1) | |
290 | (add-to-list 'savehist-additional-variables 'kill-ring) | |
291 | (save-place-mode 1) | |
292 | (setq auto-save-file-name-transforms | |
293 | `((".*" ,(no-littering-expand-var-file-name "auto-save/") t)))) | |
294 | #+end_src | |
295 | ||
180cab37 AB |
296 | ** Custom file (=custom.el=) |
297 | ||
298 | I'm not planning on using the custom file much, but even so, I | |
299 | definitely don't want it mixing with =init.el=. So, here; let's give | |
300 | it it's own file. While at it, treat themes as safe. | |
301 | ||
302 | #+begin_src emacs-lisp | |
303 | (use-package custom | |
304 | :no-require t | |
305 | :config | |
306 | (setq custom-file (no-littering-expand-etc-file-name "custom.el")) | |
307 | (when (file-exists-p custom-file) | |
308 | (load custom-file)) | |
309 | (setf custom-safe-themes t)) | |
310 | #+end_src | |
311 | ||
312 | ** Better =$PATH= handling | |
313 | ||
314 | Let's use [[https://github.com/purcell/exec-path-from-shell][exec-path-from-shell]] to make Emacs use the =$PATH= as set up | |
315 | in my shell. | |
316 | ||
317 | #+begin_src emacs-lisp | |
7538956f AB |
318 | (use-package exec-path-from-shell |
319 | :defer 1 | |
320 | :init | |
321 | (setq exec-path-from-shell-check-startup-files nil) | |
322 | :config | |
323 | (exec-path-from-shell-initialize) | |
324 | ;; while we're at it, let's fix access to our running ssh-agent | |
325 | (exec-path-from-shell-copy-env "SSH_AGENT_PID") | |
326 | (exec-path-from-shell-copy-env "SSH_AUTH_SOCK")) | |
180cab37 AB |
327 | #+end_src |
328 | ||
ebec2c18 AB |
329 | ** Only one custom theme at a time |
330 | ||
331 | #+begin_src emacs-lisp | |
332 | (defadvice load-theme (before clear-previous-themes activate) | |
333 | "Clear existing theme settings instead of layering them" | |
334 | (mapc #'disable-theme custom-enabled-themes)) | |
335 | #+end_src | |
336 | ||
180cab37 AB |
337 | ** Server |
338 | ||
339 | Start server if not already running. Alternatively, can be done by | |
340 | issuing =emacs --daemon= in the terminal, which can be automated with | |
341 | a systemd service or using =brew services start emacs= on macOS. I use | |
342 | Emacs as my window manager (via EXWM), so I always start Emacs on | |
343 | login; so starting the server from inside Emacs is good enough for me. | |
344 | ||
345 | See [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Emacs-Server.html#Emacs-Server][Using Emacs as a Server]]. | |
346 | ||
347 | #+begin_src emacs-lisp | |
348 | (use-package server | |
349 | :config (or (server-running-p) (server-mode))) | |
350 | #+end_src | |
351 | ||
e9bcfa30 AB |
352 | ** Unicode support |
353 | ||
354 | Font stack with better unicode support, around =Ubuntu Mono= and | |
355 | =Hack=. | |
356 | ||
357 | #+begin_src emacs-lisp | |
358 | (dolist (ft (fontset-list)) | |
359 | (set-fontset-font | |
360 | ft | |
361 | 'unicode | |
362 | (font-spec :name "Ubuntu Mono")) | |
363 | (set-fontset-font | |
364 | ft | |
365 | 'unicode | |
16d70d6f | 366 | (font-spec :name "DejaVu Sans Mono") |
e9bcfa30 AB |
367 | nil |
368 | 'append) | |
16d70d6f AB |
369 | ;; (set-fontset-font |
370 | ;; ft | |
371 | ;; 'unicode | |
372 | ;; (font-spec | |
373 | ;; :name "Symbola monospacified for DejaVu Sans Mono") | |
374 | ;; nil | |
375 | ;; 'append) | |
376 | ;; (set-fontset-font | |
377 | ;; ft | |
378 | ;; #x2115 ; â„• | |
379 | ;; (font-spec :name "DejaVu Sans Mono") | |
380 | ;; nil | |
381 | ;; 'append) | |
e9bcfa30 AB |
382 | (set-fontset-font |
383 | ft | |
16d70d6f AB |
384 | (cons ?Α ?ω) |
385 | (font-spec :name "DejaVu Sans Mono" :size 14) | |
e9bcfa30 | 386 | nil |
16d70d6f | 387 | 'prepend)) |
e9bcfa30 AB |
388 | #+end_src |
389 | ||
51db62d8 AB |
390 | ** Libraries |
391 | ||
392 | #+begin_src emacs-lisp | |
393 | (require 'cl-lib) | |
394 | (require 'subr-x) | |
395 | #+end_src | |
396 | ||
397 | ** Useful utilities | |
398 | ||
399 | #+begin_src emacs-lisp | |
400 | (defun ab-enlist (exp) | |
401 | "Return EXP wrapped in a list, or as-is if already a list." | |
402 | (if (listp exp) exp (list exp))) | |
403 | ||
404 | ; from https://github.com/hlissner/doom-emacs/commit/589108fdb270f24a98ba6209f6955fe41530b3ef | |
405 | (defmacro after! (features &rest body) | |
406 | "A smart wrapper around `with-eval-after-load'. Supresses warnings during | |
407 | compilation." | |
408 | (declare (indent defun) (debug t)) | |
409 | (list (if (or (not (bound-and-true-p byte-compile-current-file)) | |
410 | (dolist (next (ab-enlist features)) | |
411 | (if (symbolp next) | |
412 | (require next nil :no-error) | |
413 | (load next :no-message :no-error)))) | |
414 | #'progn | |
415 | #'with-no-warnings) | |
416 | (cond ((symbolp features) | |
417 | `(eval-after-load ',features '(progn ,@body))) | |
418 | ((and (consp features) | |
419 | (memq (car features) '(:or :any))) | |
420 | `(progn | |
421 | ,@(cl-loop for next in (cdr features) | |
422 | collect `(after! ,next ,@body)))) | |
423 | ((and (consp features) | |
424 | (memq (car features) '(:and :all))) | |
425 | (dolist (next (cdr features)) | |
426 | (setq body `(after! ,next ,@body))) | |
427 | body) | |
428 | ((listp features) | |
eb186a5a | 429 | `(after! (:all ,@features) ,@body))))) |
51db62d8 AB |
430 | #+end_src |
431 | ||
180cab37 AB |
432 | * Core |
433 | :PROPERTIES: | |
434 | :CUSTOM_ID: core | |
435 | :END: | |
436 | ||
437 | ** Defaults | |
438 | ||
e602de37 AB |
439 | *** Time and battery in mode-line |
440 | ||
441 | Enable displaying time and battery in the mode-line, since I'm not | |
442 | using the Xfce panel anymore. Also, I don't need to see the load | |
443 | average on a regular basis, so disable that. | |
444 | ||
63073abd AB |
445 | Note: using =i3status= on sway at the moment, so disabling this. |
446 | ||
447 | #+begin_src emacs-lisp :tangle no | |
e602de37 AB |
448 | (use-package time |
449 | :ensure nil | |
450 | :init | |
451 | (setq display-time-default-load-average nil) | |
452 | :config | |
453 | (display-time-mode)) | |
454 | ||
455 | (use-package battery | |
456 | :ensure nil | |
457 | :config | |
458 | (display-battery-mode)) | |
459 | #+end_src | |
460 | ||
180cab37 AB |
461 | *** Smaller fringe |
462 | ||
2f8102f0 AB |
463 | Might want to set the fringe to a smaller value, especially if using |
464 | EXWM. I'm fine with the default for now. | |
180cab37 AB |
465 | |
466 | #+begin_src emacs-lisp | |
2f8102f0 | 467 | ;; (fringe-mode '(3 . 1)) |
4b4e432d | 468 | (fringe-mode nil) |
180cab37 AB |
469 | #+end_src |
470 | ||
471 | *** Disable disabled commands | |
472 | ||
473 | Emacs disables some commands by default that could persumably be | |
474 | confusing for novice users. Let's disable that. | |
475 | ||
476 | #+begin_src emacs-lisp | |
477 | (setq disabled-command-function nil) | |
478 | #+end_src | |
479 | ||
480 | *** Kill-ring | |
481 | ||
482 | Save what I copy into clipboard from other applications into Emacs' | |
483 | kill-ring, which would allow me to still be able to easily access it | |
484 | in case I kill (cut or copy) something else inside Emacs before | |
485 | yanking (pasting) what I'd originally intended to. | |
486 | ||
487 | #+begin_src emacs-lisp | |
488 | (setq save-interprogram-paste-before-kill t) | |
489 | #+end_src | |
490 | ||
491 | *** Minibuffer | |
492 | ||
493 | #+begin_src emacs-lisp | |
494 | (setq enable-recursive-minibuffers t | |
495 | resize-mini-windows t) | |
496 | #+end_src | |
497 | ||
498 | *** Lazy-person-friendly yes/no prompts | |
499 | ||
500 | Lazy people would prefer to type fewer keystrokes, especially for yes | |
501 | or no questions. I'm lazy. | |
502 | ||
503 | #+begin_src emacs-lisp | |
504 | (defalias 'yes-or-no-p #'y-or-n-p) | |
505 | #+end_src | |
506 | ||
507 | *** Startup screen and =*scratch*= | |
508 | ||
509 | Firstly, let Emacs know that I'd like to have =*scratch*= as my | |
510 | startup buffer. | |
511 | ||
512 | #+begin_src emacs-lisp | |
513 | (setq initial-buffer-choice t) | |
514 | #+end_src | |
515 | ||
516 | Now let's customize the =*scratch*= buffer a bit. First off, I don't | |
517 | need the default hint. | |
518 | ||
519 | #+begin_src emacs-lisp | |
520 | (setq initial-scratch-message nil) | |
521 | #+end_src | |
522 | ||
523 | Also, let's use Text mode as the major mode, in case I want to | |
524 | customize it (=*scratch*='s default major mode, Fundamental mode, | |
525 | can't really be customized). | |
526 | ||
527 | #+begin_src emacs-lisp | |
528 | (setq initial-major-mode 'text-mode) | |
529 | #+end_src | |
530 | ||
531 | Inhibit the buffer list when more than 2 files are loaded. | |
532 | ||
533 | #+begin_src emacs-lisp | |
534 | (setq inhibit-startup-buffer-menu t) | |
535 | #+end_src | |
536 | ||
537 | I don't really need to see the startup screen or echo area message | |
538 | either. | |
539 | ||
540 | #+begin_src emacs-lisp | |
541 | (advice-add #'display-startup-echo-area-message :override #'ignore) | |
542 | (setq inhibit-startup-screen t | |
543 | inhibit-startup-echo-area-message user-login-name) | |
544 | #+end_src | |
545 | ||
546 | *** More useful frame titles | |
547 | ||
548 | Show either the file name or the buffer name (in case the buffer isn't | |
549 | visiting a file). Borrowed from Emacs Prelude. | |
550 | ||
551 | #+begin_src emacs-lisp | |
552 | (setq frame-title-format | |
553 | '("" invocation-name " - " | |
554 | (:eval (if (buffer-file-name) | |
555 | (abbreviate-file-name (buffer-file-name)) | |
556 | "%b")))) | |
557 | #+end_src | |
558 | ||
559 | *** Backups | |
560 | ||
561 | Emacs' default backup settings aren't that great. Let's use more | |
562 | sensible options. See documentation for the ~make-backup-file~ | |
563 | variable. | |
564 | ||
565 | #+begin_src emacs-lisp | |
566 | (setq backup-by-copying t | |
567 | version-control t) | |
568 | #+end_src | |
569 | ||
89394449 AB |
570 | *** Auto revert |
571 | ||
572 | Enable automatic reloading of changed buffers and files. | |
573 | ||
574 | #+begin_src emacs-lisp | |
575 | (global-auto-revert-mode 1) | |
576 | (setq auto-revert-verbose nil | |
577 | global-auto-revert-non-file-buffers t) | |
578 | #+end_src | |
579 | ||
580 | *** Always use space for indentation | |
581 | ||
582 | #+begin_src emacs-lisp | |
583 | (setq-default | |
584 | indent-tabs-mode nil | |
585 | require-final-newline t | |
586 | tab-width 4) | |
587 | #+end_src | |
588 | ||
180cab37 AB |
589 | ** Packages |
590 | ||
591 | The packages in this section are absolutely essential to my everyday | |
592 | workflow, and they play key roles in how I do my computing. They | |
593 | immensely enhance the Emacs experience for me; both using Emacs, and | |
594 | customizing it. | |
595 | ||
596 | *** [[https://github.com/emacscollective/auto-compile][auto-compile]] | |
597 | ||
598 | #+begin_src emacs-lisp | |
599 | (use-package auto-compile | |
600 | :demand t | |
601 | :config | |
602 | (auto-compile-on-load-mode) | |
603 | (auto-compile-on-save-mode) | |
604 | (setq auto-compile-display-buffer nil | |
eb186a5a AB |
605 | auto-compile-mode-line-counter t |
606 | auto-compile-source-recreate-deletes-dest t | |
607 | auto-compile-toggle-deletes-nonlib-dest t | |
608 | auto-compile-update-autoloads t) | |
180cab37 AB |
609 | (add-hook 'auto-compile-inhibit-compile-hook |
610 | 'auto-compile-inhibit-compile-detached-git-head)) | |
611 | #+end_src | |
612 | ||
eb186a5a | 613 | *** [[https://github.com/Kungsgeten/ryo-modal][ryo-modal]] |
180cab37 AB |
614 | |
615 | #+begin_quote | |
616 | Roll your own modal mode | |
617 | #+end_quote | |
618 | ||
3ea5e792 | 619 | #+begin_src emacs-lisp |
eb186a5a AB |
620 | (use-package ryo-modal |
621 | :commands ryo-modal-mode | |
622 | :bind ("M-m" . ryo-modal-mode) | |
623 | :after which-key | |
3ea5e792 | 624 | :config |
eb186a5a AB |
625 | (push '((nil . "ryo:.*:") . (nil . "")) which-key-replacement-alist) |
626 | (ryo-modal-keys | |
627 | ("," ryo-modal-repeat) | |
eb186a5a AB |
628 | ("b" backward-char) |
629 | ("n" next-line) | |
630 | ("p" previous-line) | |
51f3b22b | 631 | ("f" forward-char) |
bffae347 | 632 | ("/" undo) |
0ea64cb1 AB |
633 | ("i" ryo-modal-mode) |
634 | ("l" recenter-top-bottom) | |
635 | ("v" scroll-up-command) | |
636 | ("V" scroll-down-command) | |
637 | ("x" delete-forward-char) | |
82ff3214 AB |
638 | ("SPC" (("b" (("b" ibuffer-list-buffers) |
639 | ("k" kill-this-buffer) | |
640 | ("o" other-window) | |
641 | ("s" save-buffer))) | |
0ea64cb1 AB |
642 | ("B" (("A" borg-activate) |
643 | ("a" borg-assimilate) | |
644 | ("b" borg-build) | |
645 | ("c" borg-clone) | |
646 | ("r" borg-remove))) | |
82ff3214 AB |
647 | ("h" (("c" describe-char) |
648 | ("f" describe-function) | |
649 | ("F" describe-face) | |
650 | ("i" info) | |
651 | ("k" describe-key) | |
652 | ("l" view-lossage) | |
653 | ("v" describe-variable))) | |
654 | ("q" (("q" save-buffers-kill-terminal))))) | |
51f3b22b | 655 | ("d" (("w" kill-word) |
51f3b22b | 656 | ("b" backward-kill-word))) |
bb93c9e1 | 657 | ("c w" kill-word :exit t)) |
eb186a5a AB |
658 | |
659 | (ryo-modal-keys | |
660 | ;; First argyment to ryo-modal-keys may be a list of keywords. | |
661 | ;; These keywords will be applied to all keybindings. | |
662 | (:norepeat t) | |
663 | ("0" "M-0") | |
664 | ("1" "M-1") | |
665 | ("2" "M-2") | |
666 | ("3" "M-3") | |
667 | ("4" "M-4") | |
668 | ("5" "M-5") | |
669 | ("6" "M-6") | |
670 | ("7" "M-7") | |
671 | ("8" "M-8") | |
672 | ("9" "M-9")) | |
673 | :hook ((text-mode . ryo-modal-mode) | |
674 | (prog-mode . ryo-modal-mode))) | |
3ea5e792 AB |
675 | #+end_src |
676 | ||
180cab37 AB |
677 | *** [[https://orgmode.org/][Org mode]] |
678 | ||
679 | #+begin_quote | |
680 | Org mode is for keeping notes, maintaining TODO lists, planning | |
681 | projects, and authoring documents with a fast and effective plain-text | |
682 | system. | |
683 | #+end_quote | |
684 | ||
685 | In short, my favourite way of life. | |
686 | ||
687 | #+begin_src emacs-lisp | |
51f3b22b AB |
688 | (use-package org |
689 | :ryo ("SPC b t" org-babel-tangle) | |
690 | :config | |
691 | (setq org-src-tab-acts-natively t | |
692 | org-src-preserve-indentation nil | |
c0f95448 | 693 | org-edit-src-content-indentation 0) |
51f3b22b | 694 | :hook (org-mode . org-indent-mode)) |
f1dd8248 AB |
695 | (use-package org-notmuch |
696 | :after (:any org notmuch)) | |
180cab37 AB |
697 | #+end_src |
698 | ||
699 | *** [[https://magit.vc/][Magit]] | |
700 | ||
701 | #+begin_quote | |
702 | It's Magit! A Git porcelain inside Emacs. | |
703 | #+end_quote | |
704 | ||
705 | Not just how I do git, but /the/ way to do git. | |
706 | ||
707 | #+begin_src emacs-lisp | |
708 | (use-package magit | |
eb186a5a | 709 | :ryo ("SPC" (("g s" magit-status))) |
180cab37 AB |
710 | :defer t |
711 | :bind (("s-g" . magit-status) | |
eb186a5a | 712 | ("C-x g" . magit-status) |
180cab37 AB |
713 | ("C-x M-g" . magit-dispatch-popup)) |
714 | :config | |
715 | (magit-add-section-hook 'magit-status-sections-hook | |
716 | 'magit-insert-modules | |
717 | 'magit-insert-stashes | |
718 | 'append)) | |
719 | #+end_src | |
720 | ||
721 | *** [[https://github.com/abo-abo/swiper][Ivy]] (and friends) | |
722 | ||
723 | #+begin_quote | |
724 | Ivy - a generic completion frontend for Emacs, Swiper - isearch with | |
725 | an overview, and more. Oh, man! | |
726 | #+end_quote | |
727 | ||
728 | There's no way I could top that, so I won't attempt to. | |
729 | ||
730 | **** Ivy | |
731 | ||
732 | #+begin_src emacs-lisp | |
f7752223 | 733 | (use-package ivy |
3ea5e792 | 734 | :defer 1 |
f7752223 AB |
735 | :bind |
736 | (:map ivy-minibuffer-map | |
737 | ([escape] . keyboard-escape-quit) | |
5ad7f83a AB |
738 | ;; ("C-j" . ivy-next-line) |
739 | ;; ("C-k" . ivy-previous-line) | |
f7752223 AB |
740 | ([S-up] . ivy-previous-history-element) |
741 | ([S-down] . ivy-next-history-element) | |
742 | ("DEL" . ivy-backward-delete-char)) | |
eb186a5a | 743 | :ryo ("SPC ," ivy-switch-buffer) |
f7752223 | 744 | :config |
f6d8e3e4 | 745 | (setq ivy-wrap t) |
f7752223 | 746 | (ivy-mode 1)) |
180cab37 AB |
747 | #+end_src |
748 | ||
749 | **** Swiper | |
750 | ||
751 | #+begin_src emacs-lisp | |
f7752223 | 752 | (use-package swiper |
51f3b22b AB |
753 | :ryo |
754 | ("SPC /" swiper) | |
755 | ("s" swiper) | |
f7752223 | 756 | :bind (([remap isearch-forward] . swiper) |
eb186a5a | 757 | ([remap isearch-backward] . swiper))) |
180cab37 AB |
758 | #+end_src |
759 | ||
760 | **** Counsel | |
761 | ||
762 | #+begin_src emacs-lisp | |
f7752223 | 763 | (use-package counsel |
3d35bdff | 764 | :defer 1 |
eb186a5a AB |
765 | :ryo |
766 | ("SPC" (("f r" counsel-recentf) | |
767 | ("SPC" counsel-M-x) | |
768 | ("." counsel-find-file))) | |
f7752223 AB |
769 | :bind (([remap execute-extended-command] . counsel-M-x) |
770 | ([remap find-file] . counsel-find-file) | |
771 | ("s-r" . counsel-recentf) | |
772 | :map minibuffer-local-map | |
eb186a5a | 773 | ("C-r" . counsel-minibuffer-history)) |
f7752223 AB |
774 | :config |
775 | (counsel-mode 1) | |
776 | (defalias 'locate #'counsel-locate)) | |
180cab37 AB |
777 | #+end_src |
778 | ||
779 | * Borg's =layer/essentials= | |
780 | ||
781 | TODO: break this giant source block down into individual org sections. | |
782 | ||
783 | #+begin_src emacs-lisp | |
784 | (use-package dash | |
785 | :config (dash-enable-font-lock)) | |
786 | ||
787 | (use-package diff-hl | |
788 | :config | |
789 | (setq diff-hl-draw-borders nil) | |
790 | (global-diff-hl-mode) | |
791 | (add-hook 'magit-post-refresh-hook 'diff-hl-magit-post-refresh t)) | |
792 | ||
793 | (use-package dired | |
794 | :defer t | |
795 | :config (setq dired-listing-switches "-alh")) | |
796 | ||
797 | (use-package eldoc | |
798 | :when (version< "25" emacs-version) | |
799 | :config (global-eldoc-mode)) | |
800 | ||
801 | (use-package help | |
802 | :defer t | |
803 | :config (temp-buffer-resize-mode)) | |
804 | ||
805 | (progn ; `isearch' | |
806 | (setq isearch-allow-scroll t)) | |
807 | ||
808 | (use-package lisp-mode | |
809 | :config | |
810 | (add-hook 'emacs-lisp-mode-hook 'outline-minor-mode) | |
811 | (add-hook 'emacs-lisp-mode-hook 'reveal-mode) | |
812 | (defun indent-spaces-mode () | |
813 | (setq indent-tabs-mode nil)) | |
814 | (add-hook 'lisp-interaction-mode-hook #'indent-spaces-mode)) | |
815 | ||
816 | (use-package man | |
817 | :defer t | |
818 | :config (setq Man-width 80)) | |
819 | ||
820 | (use-package paren | |
821 | :config (show-paren-mode)) | |
822 | ||
823 | (use-package prog-mode | |
824 | :config (global-prettify-symbols-mode) | |
825 | (defun indicate-buffer-boundaries-left () | |
826 | (setq indicate-buffer-boundaries 'left)) | |
827 | (add-hook 'prog-mode-hook #'indicate-buffer-boundaries-left)) | |
828 | ||
829 | (use-package recentf | |
830 | :demand t | |
831 | :config (add-to-list 'recentf-exclude "^/\\(?:ssh\\|su\\|sudo\\)?:")) | |
832 | ||
833 | (use-package savehist | |
834 | :config (savehist-mode)) | |
835 | ||
836 | (use-package saveplace | |
837 | :when (version< "25" emacs-version) | |
838 | :config (save-place-mode)) | |
839 | ||
840 | (use-package simple | |
841 | :config (column-number-mode)) | |
842 | ||
843 | (progn ; `text-mode' | |
844 | (add-hook 'text-mode-hook #'indicate-buffer-boundaries-left)) | |
845 | ||
846 | (use-package tramp | |
847 | :defer t | |
848 | :config | |
849 | (add-to-list 'tramp-default-proxies-alist '(nil "\\`root\\'" "/ssh:%h:")) | |
850 | (add-to-list 'tramp-default-proxies-alist '("localhost" nil nil)) | |
851 | (add-to-list 'tramp-default-proxies-alist | |
852 | (list (regexp-quote (system-name)) nil nil))) | |
853 | ||
854 | (use-package undo-tree | |
51f3b22b | 855 | :ryo |
bffae347 | 856 | ("?" undo-tree-undo) |
51f3b22b | 857 | ("_" undo-tree-redo) |
bffae347 | 858 | :bind (("C-?" . undo-tree-undo) |
82ff3214 | 859 | ("M-_" . undo-tree-redo)) |
180cab37 AB |
860 | :config |
861 | (global-undo-tree-mode) | |
bffae347 AB |
862 | (setq undo-tree-mode-lighter "" |
863 | undo-tree-auto-save-history t)) | |
180cab37 AB |
864 | #+end_src |
865 | ||
54512e45 AB |
866 | * Editing |
867 | ||
868 | ** Company | |
869 | ||
870 | #+begin_src emacs-lisp | |
871 | (use-package company | |
872 | :defer 5 | |
873 | :bind | |
874 | (:map company-active-map | |
eb186a5a | 875 | ([tab] . company-complete-common-or-cycle)) |
54512e45 AB |
876 | :custom |
877 | (company-idle-delay 0.3) | |
878 | (company-minimum-prefix-length 1) | |
879 | (company-selection-wrap-around t) | |
880 | (company-dabbrev-char-regexp "\\sw\\|\\s_\\|[-_]") | |
881 | :config | |
882 | (global-company-mode t)) | |
883 | #+end_src | |
884 | ||
284bbe78 AB |
885 | * Syntax and spell checking |
886 | #+begin_src emacs-lisp | |
887 | (use-package flycheck | |
888 | :hook (prog-mode . flycheck-mode) | |
889 | :config | |
890 | ;; Use the load-path from running Emacs when checking elisp files | |
891 | (setq flycheck-emacs-lisp-load-path 'inherit) | |
892 | ||
893 | ;; Only flycheck when I actually save the buffer | |
894 | (setq flycheck-check-syntax-automatically '(mode-enabled save))) | |
895 | #+end_src | |
3f0f8d01 AB |
896 | * Programming modes |
897 | ||
d43a8eda | 898 | ** [[http://alloytools.org][Alloy]] (with [[https://github.com/dwwmmn/alloy-mode][alloy-mode]]) |
221cdaa3 AB |
899 | |
900 | #+begin_src emacs-lisp | |
fad62af5 AB |
901 | (use-package alloy-mode |
902 | :config (setq alloy-basic-offset 2)) | |
221cdaa3 AB |
903 | #+end_src |
904 | ||
d43a8eda | 905 | ** [[https://coq.inria.fr][Coq]] (with [[https://github.com/ProofGeneral/PG][Proof General]]) |
695170a4 AB |
906 | |
907 | #+begin_src emacs-lisp | |
908 | (use-package proof-site ; Proof General | |
909 | :load-path "lib/proof-site/generic/") | |
910 | #+end_src | |
911 | ||
d43a8eda | 912 | ** [[https://leanprover.github.io][Lean]] (with [[https://github.com/leanprover/lean-mode][lean-mode]]) |
3f0f8d01 AB |
913 | |
914 | #+begin_src emacs-lisp | |
e9bcfa30 AB |
915 | (use-package lean-mode |
916 | :bind (:map lean-mode-map | |
eb186a5a | 917 | ("S-SPC" . company-complete))) |
3f0f8d01 AB |
918 | #+end_src |
919 | ||
36fca309 AB |
920 | ** Haskell |
921 | ||
922 | *** [[https://github.com/haskell/haskell-mode][haskell-mode]] | |
a81db923 AB |
923 | |
924 | #+begin_src emacs-lisp | |
925 | (use-package haskell-mode | |
926 | :config | |
927 | (setq haskell-indentation-layout-offset 4 | |
928 | haskell-indentation-left-offset 4 | |
eb186a5a AB |
929 | flycheck-checker 'haskell-hlint |
930 | flycheck-disabled-checkers '(haskell-stack-ghc haskell-ghc))) | |
a81db923 | 931 | #+end_src |
36fca309 | 932 | |
eba52b9c AB |
933 | *** [[https://github.com/jyp/dante][dante]] |
934 | ||
935 | #+begin_src emacs-lisp | |
936 | (use-package dante | |
937 | :after haskell-mode | |
938 | :commands dante-mode | |
939 | :hook (haskell-mode . dante-mode)) | |
940 | #+end_src | |
941 | ||
36fca309 AB |
942 | *** [[https://github.com/mpickering/hlint-refactor-mode][hlint-refactor]] |
943 | ||
944 | Emacs bindings for [[https://github.com/ndmitchell/hlint][hlint]]'s refactor option. This requires the refact | |
945 | executable from [[https://github.com/mpickering/apply-refact][apply-refact]]. | |
946 | ||
947 | #+begin_src emacs-lisp | |
948 | (use-package hlint-refactor | |
949 | :bind (:map hlint-refactor-mode-map | |
eb186a5a AB |
950 | ("C-c l b" . hlint-refactor-refactor-buffer) |
951 | ("C-c l r" . hlint-refactor-refactor-at-point)) | |
36fca309 AB |
952 | :hook (haskell-mode . hlint-refactor-mode)) |
953 | #+end_src | |
954 | ||
f76bdaa8 AB |
955 | *** [[https://github.com/flycheck/flycheck-haskell][flycheck-haskell]] |
956 | ||
957 | #+begin_src emacs-lisp | |
958 | (use-package flycheck-haskell) | |
959 | #+end_src | |
960 | ||
961 | *** [[https://github.com/ndmitchell/hlint/blob/20e116a043f2073c57b17b24ae6364b5e433ba7e/data/hs-lint.el][hs-lint.el]] | |
962 | :PROPERTIES: | |
963 | :header-args+: :tangle lisp/hs-lint.el :mkdirp yes | |
964 | :END: | |
965 | ||
966 | Currently using =flycheck-haskell= with the =haskell-hlint= checker | |
967 | instead. | |
968 | ||
969 | #+begin_src emacs-lisp :tangle no | |
970 | ;;; hs-lint.el --- minor mode for HLint code checking | |
971 | ||
972 | ;; Copyright 2009 (C) Alex Ott | |
973 | ;; | |
974 | ;; Author: Alex Ott <alexott@gmail.com> | |
975 | ;; Keywords: haskell, lint, HLint | |
976 | ;; Requirements: | |
977 | ;; Status: distributed under terms of GPL2 or above | |
978 | ||
979 | ;; Typical message from HLint looks like: | |
980 | ;; | |
981 | ;; /Users/ott/projects/lang-exp/haskell/test.hs:52:1: Eta reduce | |
982 | ;; Found: | |
983 | ;; count1 p l = length (filter p l) | |
984 | ;; Why not: | |
985 | ;; count1 p = length . filter p | |
986 | ||
987 | ||
988 | (require 'compile) | |
989 | ||
990 | (defgroup hs-lint nil | |
991 | "Run HLint as inferior of Emacs, parse error messages." | |
992 | :group 'tools | |
993 | :group 'haskell) | |
994 | ||
995 | (defcustom hs-lint-command "hlint" | |
996 | "The default hs-lint command for \\[hlint]." | |
997 | :type 'string | |
998 | :group 'hs-lint) | |
999 | ||
1000 | (defcustom hs-lint-save-files t | |
1001 | "Save modified files when run HLint or no (ask user)" | |
1002 | :type 'boolean | |
1003 | :group 'hs-lint) | |
1004 | ||
1005 | (defcustom hs-lint-replace-with-suggestions nil | |
1006 | "Replace user's code with suggested replacements" | |
1007 | :type 'boolean | |
1008 | :group 'hs-lint) | |
1009 | ||
1010 | (defcustom hs-lint-replace-without-ask nil | |
1011 | "Replace user's code with suggested replacements automatically" | |
1012 | :type 'boolean | |
1013 | :group 'hs-lint) | |
1014 | ||
1015 | (defun hs-lint-process-setup () | |
1016 | "Setup compilation variables and buffer for `hlint'." | |
1017 | (run-hooks 'hs-lint-setup-hook)) | |
1018 | ||
1019 | ;; regex for replace suggestions | |
1020 | ;; | |
1021 | ;; ^\(.*?\):\([0-9]+\):\([0-9]+\): .* | |
1022 | ;; Found: | |
1023 | ;; \s +\(.*\) | |
1024 | ;; Why not: | |
1025 | ;; \s +\(.*\) | |
1026 | ||
1027 | (defvar hs-lint-regex | |
1028 | "^\\(.*?\\):\\([0-9]+\\):\\([0-9]+\\): .*[\n\C-m]Found:[\n\C-m]\\s +\\(.*\\)[\n\C-m]Why not:[\n\C-m]\\s +\\(.*\\)[\n\C-m]" | |
1029 | "Regex for HLint messages") | |
1030 | ||
1031 | (defun make-short-string (str maxlen) | |
1032 | (if (< (length str) maxlen) | |
1033 | str | |
1034 | (concat (substring str 0 (- maxlen 3)) "..."))) | |
1035 | ||
1036 | (defun hs-lint-replace-suggestions () | |
1037 | "Perform actual replacement of suggestions" | |
1038 | (goto-char (point-min)) | |
1039 | (while (re-search-forward hs-lint-regex nil t) | |
1040 | (let* ((fname (match-string 1)) | |
1041 | (fline (string-to-number (match-string 2))) | |
1042 | (old-code (match-string 4)) | |
1043 | (new-code (match-string 5)) | |
1044 | (msg (concat "Replace '" (make-short-string old-code 30) | |
1045 | "' with '" (make-short-string new-code 30) "'")) | |
1046 | (bline 0) | |
1047 | (eline 0) | |
1048 | (spos 0) | |
1049 | (new-old-code "")) | |
1050 | (save-excursion | |
1051 | (switch-to-buffer (get-file-buffer fname)) | |
eb186a5a AB |
1052 | (goto-char (point-min)) |
1053 | (forward-line (1- fline)) | |
f76bdaa8 AB |
1054 | (beginning-of-line) |
1055 | (setf bline (point)) | |
1056 | (when (or hs-lint-replace-without-ask | |
1057 | (yes-or-no-p msg)) | |
1058 | (end-of-line) | |
1059 | (setf eline (point)) | |
1060 | (beginning-of-line) | |
1061 | (setf old-code (regexp-quote old-code)) | |
1062 | (while (string-match "\\\\ " old-code spos) | |
1063 | (setf new-old-code (concat new-old-code | |
1064 | (substring old-code spos (match-beginning 0)) | |
1065 | "\\ *")) | |
1066 | (setf spos (match-end 0))) | |
1067 | (setf new-old-code (concat new-old-code (substring old-code spos))) | |
1068 | (remove-text-properties bline eline '(composition nil)) | |
1069 | (when (re-search-forward new-old-code eline t) | |
1070 | (replace-match new-code nil t))))))) | |
1071 | ||
1072 | (defun hs-lint-finish-hook (buf msg) | |
1073 | "Function, that is executed at the end of HLint execution" | |
1074 | (if hs-lint-replace-with-suggestions | |
1075 | (hs-lint-replace-suggestions) | |
1076 | (next-error 1 t))) | |
1077 | ||
1078 | (define-compilation-mode hs-lint-mode "HLint" | |
1079 | "Mode for check Haskell source code." | |
1080 | (set (make-local-variable 'compilation-process-setup-function) | |
1081 | 'hs-lint-process-setup) | |
1082 | (set (make-local-variable 'compilation-disable-input) t) | |
1083 | (set (make-local-variable 'compilation-scroll-output) nil) | |
1084 | (set (make-local-variable 'compilation-finish-functions) | |
1085 | (list 'hs-lint-finish-hook)) | |
1086 | ) | |
1087 | ||
1088 | (defun hs-lint () | |
1089 | "Run HLint for current buffer with haskell source" | |
1090 | (interactive) | |
1091 | (save-some-buffers hs-lint-save-files) | |
1092 | (compilation-start (concat hs-lint-command " \"" buffer-file-name "\"") | |
1093 | 'hs-lint-mode)) | |
1094 | ||
1095 | (provide 'hs-lint) | |
1096 | ;;; hs-lint.el ends here | |
1097 | #+end_src | |
1098 | ||
1099 | #+begin_src emacs-lisp :tangle no | |
1100 | (use-package hs-lint | |
1101 | :load-path "lisp/" | |
1102 | :bind (:map haskell-mode-map | |
1103 | ("C-c l l" . hs-lint))) | |
1104 | #+end_src | |
0deee788 AB |
1105 | * Emacs Enhancements |
1106 | ||
1107 | ** [[https://github.com/justbur/emacs-which-key][which-key]] | |
1108 | ||
1109 | #+begin_quote | |
1110 | Emacs package that displays available keybindings in popup | |
1111 | #+end_quote | |
1112 | ||
1113 | #+begin_src emacs-lisp | |
1114 | (use-package which-key | |
1115 | :defer 1 | |
1116 | :config (which-key-mode)) | |
1117 | #+end_src | |
75095920 | 1118 | |
d43a8eda | 1119 | ** [[https://github.com/seagle0128/doom-modeline][doom-modeline]] |
75095920 AB |
1120 | |
1121 | #+begin_src emacs-lisp | |
1122 | (use-package doom-modeline | |
1123 | :demand t | |
1124 | :config (setq doom-modeline-height 32) | |
1125 | :hook (after-init . doom-modeline-init)) | |
1126 | #+end_src | |
1127 | ||
d43a8eda | 1128 | ** [[https://github.com/11111000000/tao-theme-emacs][tao-theme]] |
75095920 | 1129 | |
fdcac86a | 1130 | #+begin_src emacs-lisp :tangle no |
75095920 AB |
1131 | (use-package tao-theme |
1132 | :demand t | |
1133 | :config (load-theme 'tao-yang t)) | |
1134 | #+end_src | |
1135 | ||
fdcac86a AB |
1136 | ** [[https://github.com/maio/eink-emacs][eink-theme]] |
1137 | ||
1138 | #+begin_src emacs-lisp | |
1139 | (load-theme 'eink t) | |
1140 | #+end_src | |
1141 | ||
bb93c9e1 AB |
1142 | ** [[https://github.com/bbatsov/crux][crux]] |
1143 | ||
1144 | #+begin_src emacs-lisp | |
1145 | (use-package crux | |
1146 | :bind (("C-c d" . crux-duplicate-current-line-or-region) | |
1147 | ("C-c M-d" . crux-duplicate-and-comment-current-line-or-region)) | |
1148 | :ryo | |
1149 | ("o" crux-smart-open-line :exit t) | |
1150 | ("O" crux-smart-open-line-above :exit t) | |
1151 | ("SPC b K" crux-kill-other-buffers) | |
1152 | ("d d" crux-kill-whole-line) | |
1153 | ("c c" crux-kill-whole-line :then '(crux-smart-open-line-above) :exit t) | |
1154 | ("SPC f" (("c" crux-copy-file-preserve-attributes) | |
1155 | ("D" crux-delete-file-and-buffer) | |
1156 | ("R" crux-rename-file-and-buffer)))) | |
1157 | #+end_src | |
1158 | ||
1159 | ** [[https://github.com/alezost/mwim.el][mwim]] | |
1160 | ||
1161 | #+begin_src emacs-lisp | |
1162 | (use-package mwim | |
1163 | :bind (("C-a" . mwim-beginning-of-code-or-line) | |
1164 | ("C-e" . mwim-end-of-code-or-line) | |
1165 | ("<home>" . mwim-beginning-of-line-or-code) | |
1166 | ("<end>" . mwim-end-of-line-or-code)) | |
1167 | :ryo | |
1168 | ("a" mwim-beginning-of-code-or-line) | |
1169 | ("e" mwim-end-of-code-or-line)) | |
1170 | #+end_src | |
1171 | ||
7a04e186 | 1172 | ** [[https://www.emacswiki.org/emacs/KeyChord][key-chord]] |
f8869b0b AB |
1173 | |
1174 | #+begin_src emacs-lisp | |
1175 | (use-package key-chord | |
1176 | :demand t | |
1177 | :config | |
1178 | (key-chord-mode 1) | |
7a04e186 | 1179 | (key-chord-define-global "jk" 'ryo-modal-mode) |
f8869b0b | 1180 | (setq key-chord-one-key-delay 0 ; i don't need one-key chords for now |
7a04e186 | 1181 | key-chord-two-keys-delay 0.005)) |
f8869b0b AB |
1182 | #+end_src |
1183 | ||
51db62d8 | 1184 | |
d43a8eda | 1185 | ** [[https://notmuchmail.org][notmuch]] |
51db62d8 | 1186 | |
9d5d55c5 AB |
1187 | See [[notmuch:id:87muuqsvci.fsf@fencepost.gnu.org][bug follow-up]]. |
1188 | ||
51db62d8 AB |
1189 | #+begin_src emacs-lisp |
1190 | (defun ab/notmuch () | |
1191 | "Delete other windows, then launch `notmuch'." | |
1192 | (interactive) | |
1193 | (require 'notmuch) | |
1194 | (delete-other-windows) | |
1195 | (notmuch)) | |
1196 | ||
1197 | ;; (map! | |
1198 | ;; :leader | |
1199 | ;; :desc "notmuch" :n "m" #'ab/notmuch | |
1200 | ;; (:desc "search" :prefix "/" | |
1201 | ;; :desc "notmuch" :n "m" #'counsel-notmuch)) | |
1202 | #+end_src | |
1203 | ||
1204 | #+begin_src emacs-lisp | |
1205 | (defvar ab-maildir "~/mail") | |
1206 | ||
1207 | (use-package sendmail | |
1208 | ;; :ensure nil | |
1209 | :config | |
1210 | (setq sendmail-program "/usr/bin/msmtp" | |
9e568495 | 1211 | ; message-sendmail-extra-arguments '("-v" "-d") |
51db62d8 AB |
1212 | mail-specify-envelope-from t |
1213 | mail-envelope-from 'header)) | |
1214 | ||
1215 | (use-package message | |
1216 | ;; :ensure nil | |
1217 | :config | |
1218 | (setq message-kill-buffer-on-exit t | |
1219 | message-send-mail-function 'message-send-mail-with-sendmail | |
1220 | message-sendmail-envelope-from 'header | |
1221 | message-directory "drafts" | |
41a4f26a | 1222 | message-user-fqdn "aminb.org") |
51db62d8 AB |
1223 | (add-hook 'message-mode-hook |
1224 | (lambda () (setq fill-column 65 | |
1225 | message-fill-column 65))) | |
1226 | (add-hook 'message-mode-hook | |
1227 | #'flyspell-mode) | |
1228 | ;; (add-hook 'notmuch-message-mode-hook #'+doom-modeline|set-special-modeline) | |
1229 | ;; TODO: is there a way to only run this when replying and not composing? | |
5842415b AB |
1230 | ;; (add-hook 'notmuch-message-mode-hook |
1231 | ;; (lambda () (progn | |
1232 | ;; (newline) | |
1233 | ;; (newline) | |
1234 | ;; (forward-line -1) | |
1235 | ;; (forward-line -1)))) | |
51db62d8 AB |
1236 | ;; (add-hook 'message-setup-hook |
1237 | ;; #'mml-secure-message-sign-pgpmime) | |
1238 | ) | |
1239 | ||
1240 | (after! mml-sec | |
1241 | (setq mml-secure-openpgp-encrypt-to-self t | |
1242 | mml-secure-openpgp-sign-with-sender t)) | |
1243 | ||
1244 | (use-package notmuch | |
eb186a5a | 1245 | :ryo ("SPC m" ab/notmuch) |
51db62d8 AB |
1246 | :config |
1247 | (setq notmuch-hello-sections | |
1248 | '(notmuch-hello-insert-header | |
1249 | notmuch-hello-insert-saved-searches | |
1250 | ;; notmuch-hello-insert-search | |
1251 | notmuch-hello-insert-alltags) | |
1252 | notmuch-search-oldest-first nil | |
1253 | notmuch-show-all-tags-list t | |
9d5d55c5 AB |
1254 | notmuch-message-headers ; see bug follow-up above |
1255 | '("Subject" "To" "Cc" "Date" "List-Id" "X-RT-Originator") | |
51db62d8 AB |
1256 | notmuch-hello-thousands-separator "," |
1257 | notmuch-fcc-dirs | |
1258 | '(("amin@aminb.org" . "amin/Sent") | |
835adbdb | 1259 | ("amin@gnu.org" . "gnu/Sent") |
51db62d8 | 1260 | ("abandali@uwaterloo.ca" . "\"uwaterloo/Sent Items\"") |
9e568495 | 1261 | ("mab@gnu.org" . "gnu/Sent") |
51db62d8 | 1262 | ("aminb@gnu.org" . "gnu/Sent") |
f4636d6b AB |
1263 | (".*" . "sent")) |
1264 | notmuch-search-result-format | |
1265 | '(("date" . "%12s ") | |
1266 | ("count" . "%-7s ") | |
1267 | ("authors" . "%-40s ") | |
1268 | ("subject" . "%s ") | |
1269 | ("tags" . "(%s)"))) | |
51db62d8 AB |
1270 | ;; (add-hook 'visual-fill-column-mode-hook |
1271 | ;; (lambda () | |
1272 | ;; (when (string= major-mode 'notmuch-message-mode) | |
1273 | ;; (setq visual-fill-column-width 70)))) | |
1274 | ;; (set! :evil-state 'notmuch-message-mode 'insert) | |
1275 | ;; (advice-add #'notmuch-bury-or-kill-this-buffer | |
1276 | ;; :override #'kill-this-buffer) | |
1277 | :bind | |
1278 | (:map notmuch-hello-mode-map | |
eb186a5a | 1279 | ("g" . notmuch-poll-and-refresh-this-buffer) |
eb186a5a AB |
1280 | ("u" . (lambda () |
1281 | "Search for `unread' tagged messages" | |
1282 | (interactive) | |
1283 | (notmuch-hello-search "tag:unread"))) | |
e473bc20 AB |
1284 | ("i" . (lambda () |
1285 | "Search for `inbox' tagged messages" | |
1286 | (interactive) | |
1287 | (notmuch-hello-search "tag:inbox"))) | |
eb186a5a | 1288 | ("l" . (lambda () |
e473bc20 | 1289 | "Search for `latest' tagged messages" |
eb186a5a AB |
1290 | (interactive) |
1291 | (notmuch-hello-search "tag:latest"))) | |
e473bc20 AB |
1292 | ("e" . (lambda () |
1293 | "Search for `encrypted' tagged messages" | |
1294 | (interactive) | |
1295 | (notmuch-hello-search "tag:encrypted"))) | |
eb186a5a AB |
1296 | ("M" . (lambda () |
1297 | "Compose new mail and prompt for sender" | |
1298 | (interactive) | |
1299 | (let ((current-prefix-arg t)) | |
1300 | (call-interactively #'notmuch-mua-new-mail))))) | |
51db62d8 | 1301 | (:map notmuch-search-mode-map |
eb186a5a AB |
1302 | ("g" . notmuch-poll-and-refresh-this-buffer) |
1303 | ("k" . (lambda () | |
1304 | "Mark message read" | |
1305 | (interactive) | |
1306 | (notmuch-search-tag '("-unread")) | |
1307 | ;; (notmuch-search-archive-thread) | |
1308 | (notmuch-search-next-thread))) | |
1309 | ("u" . (lambda () | |
1310 | "Mark message unread" | |
1311 | (interactive) | |
1312 | (notmuch-search-tag '("+unread")) | |
1313 | (notmuch-search-next-thread))) | |
1314 | ("K" . (lambda () | |
1315 | "Mark message deleted" | |
1316 | (interactive) | |
1317 | (notmuch-search-tag '("-unread" "-inbox" "+deleted")) | |
1318 | (notmuch-search-archive-thread))) | |
1319 | ("S" . (lambda () | |
1320 | "Mark message as spam" | |
1321 | (interactive) | |
1322 | (notmuch-search-tag '("-unread" "-inbox" "-webmasters" "+spam")) | |
1323 | (notmuch-search-archive-thread)))) | |
51db62d8 | 1324 | (:map notmuch-tree-mode-map ; TODO: additional bindings |
eb186a5a AB |
1325 | ("S" . (lambda () |
1326 | "Mark message as spam" | |
1327 | (interactive) | |
1328 | (notmuch-tree-tag '("-unread" "-inbox" "-webmasters" "+spam")) | |
1329 | (notmuch-tree-archive-thread)))) | |
51db62d8 AB |
1330 | ) |
1331 | ||
1332 | ;; (use-package counsel-notmuch | |
1333 | ;; :commands counsel-notmuch) | |
1334 | ||
1335 | (after! notmuch-crypto | |
1336 | (setq notmuch-crypto-process-mime t)) | |
1337 | ||
1338 | ;; (after! evil | |
1339 | ;; (mapc (lambda (str) (evil-set-initial-state (car str) (cdr str))) | |
1340 | ;; '((notmuch-hello-mode . emacs) | |
1341 | ;; (notmuch-search-mode . emacs) | |
1342 | ;; (notmuch-tree-mode . emacs)))) | |
1343 | ||
1344 | (after! recentf | |
1345 | (add-to-list 'recentf-exclude (expand-file-name ab-maildir))) | |
1346 | #+end_src | |
f76bdaa8 | 1347 | |
26172d91 AB |
1348 | ** supercite |
1349 | ||
1350 | #+begin_src emacs-lisp :tangle no | |
1351 | (use-package supercite | |
1352 | :commands sc-cite-original | |
1353 | :init | |
1354 | (add-hook 'mail-citation-hook 'sc-cite-original) | |
1355 | ||
1356 | (defun sc-remove-existing-signature () | |
1357 | (save-excursion | |
1358 | (goto-char (region-beginning)) | |
1359 | (when (re-search-forward message-signature-separator (region-end) t) | |
1360 | (delete-region (match-beginning 0) (region-end))))) | |
1361 | ||
1362 | (add-hook 'mail-citation-hook 'sc-remove-existing-signature) | |
1363 | ||
1364 | (defun sc-remove-if-not-mailing-list () | |
1365 | (unless (assoc "list-id" sc-mail-info) | |
1366 | (setq attribution sc-default-attribution | |
1367 | citation (concat sc-citation-delimiter | |
1368 | sc-citation-separator)))) | |
1369 | ||
1370 | (add-hook 'sc-attribs-postselect-hook 'sc-remove-if-not-mailing-list) | |
1371 | ||
1372 | :config | |
1373 | (defun sc-fill-if-different (&optional prefix) | |
1374 | "Fill the region bounded by `sc-fill-begin' and point. | |
1375 | Only fill if optional PREFIX is different than | |
1376 | `sc-fill-line-prefix'. If `sc-auto-fill-region-p' is nil, do not | |
1377 | fill region. If PREFIX is not supplied, initialize fill | |
1378 | variables. This is useful for a regi `begin' frame-entry." | |
1379 | (if (not prefix) | |
1380 | (setq sc-fill-line-prefix "" | |
1381 | sc-fill-begin (line-beginning-position)) | |
1382 | (if (and sc-auto-fill-region-p | |
1383 | (not (string= prefix sc-fill-line-prefix))) | |
1384 | (let ((fill-prefix sc-fill-line-prefix)) | |
1385 | (unless (or (string= fill-prefix "") | |
1386 | (save-excursion | |
1387 | (goto-char sc-fill-begin) | |
1388 | (or (looking-at ">+ +") | |
1389 | (< (length | |
1390 | (buffer-substring (point) | |
1391 | (line-end-position))) | |
1392 | 65)))) | |
1393 | (fill-region sc-fill-begin (line-beginning-position))) | |
1394 | (setq sc-fill-line-prefix prefix | |
1395 | sc-fill-begin (line-beginning-position))))) | |
1396 | nil)) | |
1397 | #+end_src | |
1398 | ||
97934ec4 AB |
1399 | * Blogging |
1400 | ** [[https://ox-hugo.scripter.co][ox-hugo]] | |
1401 | ||
1402 | #+begin_src emacs-lisp | |
1403 | (use-package ox-hugo | |
1404 | :after ox) | |
1405 | #+end_src | |
1406 | ||
180cab37 AB |
1407 | * Post initialization |
1408 | :PROPERTIES: | |
967b0a82 | 1409 | :CUSTOM_ID: post-initialization |
180cab37 AB |
1410 | :END: |
1411 | ||
1412 | Display how long it took to load the init file. | |
1413 | ||
1414 | #+begin_src emacs-lisp | |
1415 | (message "Loading %s...done (%.3fs)" user-init-file | |
1416 | (float-time (time-subtract (current-time) | |
1417 | ab--before-user-init-time))) | |
1418 | #+end_src | |
1419 | ||
1420 | * Footer | |
1421 | :PROPERTIES: | |
1422 | :CUSTOM_ID: footer | |
1423 | :END: | |
1424 | ||
1425 | #+begin_src emacs-lisp :comments none | |
1426 | ;;; init.el ends here | |
1427 | #+end_src |