;;; Emacs configuration ;;; =================== ;;; I recommend watching the following video by BuildFunThings called ;;; [My GNU Emacs configuration for programming](https://www.youtube.com/watch?v=I28jFkpN5Zk). ;;; Below are fragments from my Emacs configuration file ;;; (`~/.emacs.d/init.el`). ;;; I use `:ensure nil` argument of the `use-package` macro below for ;;; the packages I use because I do not want them to be upgraded on ;;; every Emacs start, actually `:ensure nil` is the default so it has ;;; no effect, but if I copy my Emacs configuration file to a new ;;; computer I can simply replace all occurrences of `:ensure nil` to ;;; `:ensure t` and install all used packages after restarting Emacs, ;;; and then replace it back to `:ensure nil` to avoid auto upgrading ;;; next time. ;;; Directory with local Emacs lisp files ;;; ------------------------------------- ;;; I add a directory to the lisp search path where I can add my own ;;; lisp code and (now less often) downloaded lisp code which is not ;;; available through [MELPA](https://melpa.org). Then I initialize ;;; secure downloading from GNU and MELPA archives of Emacs packages. (let ((path (expand-file-name "~/.emacs.d/lisp"))) (if (file-accessible-directory-p path) (add-to-list 'load-path path t))) ;;; Add MELPA package list ;;; ---------------------- ;;; You can install many Emacs packages from [MELPA](https://melpa.org) ;;; repository. To add MELPA to the package list add the following to your ;;; `~/.emacs.d/init.el` file (require 'package) (setq package-archives '(("gnu" . "https://elpa.gnu.org/packages/") ("melpa-stb" . "https://stable.melpa.org/packages/") ("melpa" . "https://melpa.org/packages/")) tls-checktrust t tls-program '("gnutls-cli --x509cafile %t -p %p %h") gnutls-verify-error t) (package-initialize) (require 'use-package) ;;; This also turns on checking TLS certificates (in both possible modes) ;;; with `tls-program` set to only the first value from the default value ;;; (for more info ;;; see ;;; [Your Text Editor Is Malware](https://glyph.twistedmatrix.com/2015/11/editor-malware.html)). ;;; Now you can list available packages by running `M-x list-packages`. ;;; Mark packages you want to install by pressing `i` and later press `x` ;;; to install all marked packages (the necessary dependencies will be ;;; installed automatically). ;;; Note: The last line above requires installing package named ;;; `use-package` to work. ;;; Buffer, file, and window selection enhancements ;;; ---------------------------------------------- ;;; Use more efficient buffer/file selection (use-package counsel :ensure nil :init (setq ivy-use-virtual-buffers t ivy-magic-tilde nil) (recentf-mode 1) :bind (("C-c r" . ivy-resume) ("C-c i" . counsel-imenu) ("C-c g" . counsel-git) ("C-c j" . counsel-git-grep) ("C-c L" . counsel-locate) ("M-x" . counsel-M-x) ("C-x C-f" . counsel-find-file) ("C-x b" . ivy-switch-buffer) ("C-s" . swiper)) :config (ivy-mode 1) (counsel-mode 1)) ;;; Use more more efficient changing windows (use-package ace-window :ensure nil :bind ("C-x o" . ace-window)) (use-package windmove :ensure nil :demand :bind (("H-J" . windmove-down) ("H-K" . windmove-up) ("H-H" . windmove-left) ("H-L" . windmove-right)) :config (windmove-default-keybindings)) (use-package spaces :ensure nil ;; customize mode-line-format to add: "(" sp-current-space ")" :bind ("C-c b" . sp-switch-space)) ;;; Allow for Undo/Redo of window manipulations (such as C-x 1) (winner-mode 1) ;;; Remind of keys than can follow in a key sequence (use-package which-key :ensure nil :config (which-key-mode)) (use-package avy :ensure nil :bind ("C-:" . avy-goto-char-timer)) (use-package treemacs :ensure nil :bind ("C-c t" . treemacs-toggle)) ;;; Editing enhancements ;;; --------------------- ;;; Context aware insertion of pairs of parenthesis (use-package smartparens :ensure nil :defer) ;;; Edit with multiple cursors (use-package multiple-cursors :ensure nil :bind (("C-c n" . mc/mark-next-like-this) ("C-c p" . mc/mark-previous-like-this))) ;;; Appearance ;;; ---------- (setq inhibit-startup-screen t) (set-scroll-bar-mode 'right) (menu-bar-mode 0) (tool-bar-mode 0) (defun set-frame-font-inconsolata (size &optional frames) "Set font to Inconsolata:pixelsize=SIZE:antialias=true:autohint=false. Argument FRAMES has the same meaning as for `set-frame-font'" (interactive "n[Inconsolata] size: ") (set-frame-font (format "Inconsolata:pixelsize=%d:antialias=true:autohint=true" size) nil frames)) (defun set-frame-font-go-mono (size &optional frames) "Set font to Go mono:pixelsize=SIZE:antialias=true:autohint=false. Argument FRAMES has the same meaning as for `set-frame-font'" (interactive "n[Go mono] size: ") (set-frame-font (format "Go mono:pixelsize=%d:antialias=true:autohint=true" size) nil frames)) (eval-after-load 'firebelly-theme '(custom-theme-set-faces 'firebelly '(font-lock-comment-delimiter-face ((t (:foreground "#505050")))))) (use-package powerline :ensure nil :defer) (defun my-make-frame-function(frame) (with-selected-frame frame ;; needed for spacemacs powerline colors to be applied properly (when (not (featurep 'apropospriate-light-theme)) (load-theme 'apropospriate-light) (when (require 'powerline nil t) (powerline-center-theme))))) (defun my-light-theme () "Switch to apropospriate-light theme." (interactive) (when (load-theme 'apropospriate-light) (enable-theme 'apropospriate-light) (disable-theme 'sanityinc-tomorrow-night))) (defun my-dark-theme () "Switch to apropospriate-dark dark theme." (interactive) (when (load-theme 'sanityinc-tomorrow-night) (enable-theme 'sanityinc-tomorrow-night) (disable-theme 'apropospriate-light))) (when window-system (my-make-frame-function (selected-frame))) (add-hook 'after-make-frame-functions 'my-make-frame-function) ;;; Convenience functions, aliases, and key bindings ;;; --------------------------------- ;; Convenience functions and aliases (defun am () "Change dictionary to american." (interactive) (setq ispell-local-dictionary "american")) (defun pl () "Change dictionary to polish." (interactive) (setq ispell-local-dictionary "polish")) (defalias 'fi 'set-frame-font-inconsolata) (defalias 'fm 'set-frame-font-go-mono) (defalias 'st 'magit-status) (defalias 'ir 'ispell-region) (defalias 'md 'markdown-mode) ;; Bind keys (global-set-key "\C-ck" 'compile) (global-set-key "\C-cq" 'bury-buffer) (global-set-key "\C-cs" 'shell) (use-package magit :ensure nil :bind ("C-c m" . magit-status)) ;;; Using C/C++ under Emacs ;;; ----------------------- ;;; The following Emacs packages [from MELPA](#add-melpa-package-list) ;;; need to be installed: [cmake-ide](https://melpa.org/#/cmake-ide), ;;; [company](https://melpa.org/#/company), and ;;; [rtags](https://melpa.org/#/rtags). Package `cmake-ide` ;;; automatically configures other C++ Emacs packages (here `company` ;;; and `rtags`) when you open a C/C++ file from a project which uses ;;; [cmake](https://cmake.org) to build. (setq-default c-basic-offset 8) (setq c-default-style '((java-mode . "java") (awk-mode . "awk") (other . "k&r")) company-async-timeout 5 ; completion may be slow rtags-completions-enabled t) (use-package rtags ;; need to install all three: rc rdm rp for jump to definition to work :ensure nil :defer :config (rtags-enable-standard-keybindings nil "C-c R")) (use-package cmake-ide :ensure nil :after cc-mode :init :config (cmake-ide-setup)) (defun my-c-c++-mode-hook-fn () (set (make-local-variable 'company-backends) '(company-rtags)) (company-mode) (local-set-key (kbd "M-.") 'rtags-find-symbol-at-point) (local-set-key (kbd "M-,") 'rtags-location-stack-back) (local-set-key "\C-i" 'my-indent-or-complete) (local-set-key (kbd "") 'my-indent-or-complete) (local-set-key "\C-\M-i" 'my-indent-or-complete)) (add-hook 'c-mode-hook 'my-c-c++-mode-hook-fn) (add-hook 'c++-mode-hook 'my-c-c++-mode-hook-fn) ;;; Function `my-indent-or-complete` is defined above in section ;;; [Using Go under Emacs](#using-go-under-emacs). ;;; Now: ;;; 1. Install [clang](http://clang.llvm.org/) compiler or more accurately ;;; `libclang` library (package `libclang-dev` or may be newer ;;; `libclang-X.Y-dev` under Debian) which is required by `rtags`. ;;; 2. Install `rtags` server with (it assumes first that you do have ;;; `llvm-config-3.8` instead of `llvm-config` thus the extra option is ;;; needed and second that you want to install it in `/opt/rtags` ;;; instead of default `/usr/local`): ;;; ``` ;;; $ git clone --recursive https://github.com/Andersbakken/rtags.git ;;; $ cd rtags ;;; $ mkdir build ;;; $ cd build ;;; $ cmake -DLIBCLANG_LLVM_CONFIG_EXECUTABLE=llvm-config-3.8 -DCMAKE_INSTALL_PREFIX=/opt/rtags .. ;;; $ make ;;; ``` ;;; And as root ;;; ``` ;;; # make install ;;; # ln -s /opt/rtags/bin/rc /usr/local/bin/rc ;;; # ln -s /opt/rtags/bin/rdm /usr/local/bin/rdm ;;; ``` ;;; 3. Usefull `rtags` functions (use `C-c r C-h` to see these and other key bindings) ;;; | Key | Function ;;; |-----------|---------- ;;; | `C-c r .` | `rtags-find-symbol-at-point` ;;; | `C-c r [` | `rtags-location-stack-back` ;;; | `C-c r ,` | `rtags-find-references-at-point` ;;; | `C-c r /` | `rtags-find-all-references-at-point` ;;; | | `rtags-find-references-current-file` ;;; | | `rtags-find-references-current-dir` ;;; | `C-c r v` | `rtags-find-virtuals-at-point` ;;; | `C-c r ;` | `rtags-find-file` (in the current project no metter in which directory) ;;; Lisp and Emacs lisp modes ;;; ------------------------- ;; in emacs 25.1: M-. runs xref-find-definitions, M-, jumps back (global-set-key (kbd "C-c e l") 'find-library) (setq slime-default-lisp 'sbcl) (use-package paredit :ensure nil :defer) (use-package rainbow-delimiters :ensure nil :defer) (defun my-emacs-lisp-mode-hook-fn () (set (make-local-variable 'lisp-indent-function) 'lisp-indent-function) (paredit-mode 1) (show-paren-mode 1) (rainbow-delimiters-mode 1)) (defun my-lisp-mode-hook-fn () (set (make-local-variable 'lisp-indent-function) 'common-lisp-indent-function) (paredit-mode 1) (show-paren-mode 1) (rainbow-delimiters-mode 1)) (add-hook 'emacs-lisp-mode-hook 'my-emacs-lisp-mode-hook-fn) (add-hook 'lisp-mode-hook 'my-lisp-mode-hook-fn) ;;; JS mode ;;; ------- (setq js-indent-level 8) ;;; Using Go under Emacs ;;; -------------------- ;;; I use the following setup for the [go-mode] in my `~/.emacs.d/init.el`. This ;;; adds syntax highlighting but without fontifing names of called ;;; functions, autocompletion and [eldoc] support, auto formatting of the ;;; code on save with adding of missing imports ([goimports]). ;;; It is quite long as I define three interactive functions: ;;; 1. `my-indent-or-complete` which is bind to `TAB` key and ;;; (contextually) either completes the symbol at point or indents the ;;; line, ;;; 2. `my-go-electric-brace` which is bind to `{` key and inserts an ;;; indented pair of braces (if previous character is a space, ;;; otherwise it inserts single opening brace), ;;; 3. `my-godoc-package` which is bind to `C-c P` key and display ;;; documentation for a package choosen from a list of installed ;;; packages. ;;; [go-mode]: https://github.com/dominikh/go-mode.el ;;; [eldoc]: http://emacswiki.org/emacs/ElDoc ;;; [goimports]: https://godoc.org/golang.org/x/tools/cmd/goimports (defun my-indent-or-complete () "Complete or indent if nothing to complete." (interactive) (if (or (looking-at "\\w") (looking-back "^\\|\s")) (indent-for-tab-command) (company-complete))) (defun my-go-electric-brace () "Insert an opening brace may be with the closing one. If there is a space before the brace also adds new line with properly indented closing brace and moves cursor to another line inserted between the braces between the braces." (interactive) (if (not (looking-back " ")) (insert "{") (insert "{") (newline) (indent-according-to-mode) (save-excursion (newline) (insert "}") (indent-according-to-mode)))) (defun my-go-list-packages () "Return list of Go packages." (split-string (with-temp-buffer (shell-command "go list ... 2>/dev/null" (current-buffer)) (buffer-substring-no-properties (point-min) (point-max))) "\n")) (defun my-godoc-package () "Display godoc for given package (with completion)." (interactive) (godoc (ivy-read "Godoc package: " (my-go-list-packages)))) (use-package flycheck :ensure nil :defer) (use-package go-eldoc :ensure nil :defer) (use-package company-go :ensure nil :defer) (use-package go-guru :ensure nil :defer) (use-package go-mode :ensure nil :init (setq gofmt-command "goimports" ; use goimports instead of gofmt go-fontify-function-calls nil ; fontifing names of called functions is too much for me company-idle-delay nil) :bind (:map go-mode-map ("M-." . go-guru-definition) ("C-c d" . godoc-at-point) ("C-c g" . godoc) ("C-c h" . go-guru-hl-identifier) ("C-c P" . my-godoc-package) ("{" . my-go-electric-brace) ("C-i" . my-indent-or-complete) ("C-M-i" . my-indent-or-complete)) :config ;; run gofmt/goimports when saving the file (add-hook 'before-save-hook 'gofmt-before-save) (defun my-go-mode-hook-fn () (go-eldoc-setup) (set (make-local-variable 'company-backends) '(company-go)) (company-mode) (smartparens-mode 1) (flycheck-mode 1) (setq imenu-generic-expression '(("type" "^type *\\([^ \t\n\r\f]*\\)" 1) ("func" "^func *\\(.*\\) {" 1)))) (add-hook 'go-mode-hook 'my-go-mode-hook-fn)) ;; Go/speedbar integration (eval-after-load 'speedbar '(speedbar-add-supported-extension ".go")) ;;; Now, in go buffers you can use `M-.` to jump to the definition of ;;; the identifier at point (use `M-,` to jump back as for normal tags ;;; in Emacs 25.1) and you can also use `C-c C-d` for a short ;;; description of the identifier at point (actually it is constantly ;;; displayed in the mode line by enabled Go [eldoc] support). You can ;;; use `C-c d` for a longer description of the identifier at point. ;;; For this to work you have to ;;; 1. Install [from MELPA](#add-melpa-package-list) the following Emacs ;;; packages: [go-mode], [company-go], [go-eldoc], and [go-guru]. ;;; 2. Install Go compiler. Under Debian you install `golang-go` package ;;; (but in Debian 9 Stretch it is 1.7 while in Debian 8 Jessie it is ;;; 1.3.3 compared to the current 1.9, so you may ;;; consider ;;; [downloading the current version of Go](https://golang.org/dl/)). Otherwise ;;; search for the package for your system or otherwise ;;; see [Getting started](https://golang.org/doc/install). ;;; 3. Install [godef](https://godoc.org/github.com/rogpeppe/godef) ;;; can be installed with ;;; ``` ;;; $ go get github.com/rogpeppe/godef ;;; ``` ;;; 4. Install [goimports] which can be installed from Debian package ;;; `golang-go.tools` or with ;;; ``` ;;; $ go get golang.org/x/tools/cmd/goimports ;;; ``` ;;; 5. Install [gocode](https://github.com/nsf/gocode) which can be ;;; installed from Debian package `gocode` or with ;;; ``` ;;; $ go get -u github.com/nsf/gocode ;;; ``` ;;; 5. Install [go guru] with ;;; ``` ;;; $ go get golang.org/x/tools/cmd/guru ;;; ``` ;;; 6. Add your `$GOPATH/bin` to your `PATH` environment variable (or copy ;;; the `godef`, `goimports`, `gocode`, and `guru` executables from ;;; `$GOPATH/bin` to some directory which is in your `PATH`). ;;; See also ;;; [Writing Go in Emacs](http://dominik.honnef.co/posts/2013/03/writing_go_in_emacs/) ;;; for more info. ;;; [company-go]: https://melpa.org/#/company-go ;;; [go-eldoc]: https://melpa.org/#/go-eldoc ;;; [go-guru]: https://melpa.org/#/go-guru ;;; Using Python under Emacs ;;; ------------------------ (use-package company-jedi :ensure nil :defer) (defun my-python-mode-hook-fn () (set (make-local-variable 'company-backends) '(company-jedi)) (company-mode) (smartparens-mode 1) (local-set-key (kbd "M-.") 'jedi:goto-definition) (local-set-key (kbd "M-,") 'jedi:goto-definition-pop-marker) (local-set-key "\C-i" 'my-indent-or-complete)) (add-hook 'python-mode-hook 'my-python-mode-hook-fn) ;;; Function `my-indent-or-complete` is defined above in section ;;; [Using Go under Emacs](#using-go-under-emacs). ;;; Yasnippet and abbrev mode ;;; ------------------------- (setq-default abbrev-mode 1) (use-package yasnippet :ensure nil :init (yas-global-mode 1) :bind (:map yas-minor-mode-map ("C-c & t" . yas-describe-tables) ("C-c & &" . org-mark-ring-goto))) ;;; PHP ;;; --- (use-package php-mode :ensure nil :defer) (use-package company-php :ensure nil :defer) (defun my-php-mode-hook-fn() (when (require 'company-php nil t) (set (make-local-variable 'company-backends) '(company-ac-php-backend)) (company-mode t))) (add-hook 'php-mode-hook 'my-php-mode-hook-fn) ;;; web-mode ;;; -------- (defun my-web-mode-hook-fn() (cond ((string= web-mode-engine "php") (my-php-mode-hook-fn)))) (use-package web-mode :ensure nil :init (add-hook 'web-mode-hook 'my-web-mode-hook-fn) (add-to-list 'auto-mode-alist '("\\.php\\'" . web-mode)) :bind (:map web-mode-map ("C-i" . my-indent-or-complete))) ;;; css-mode ;;; -------- (use-package rainbow-mode :ensure nil :defer) (add-hook 'css-mode-hook 'rainbow-mode) ;;; Org mode ;;; -------- (use-package org-bullets :ensure nil :defer) (use-package org :ensure nil :init (setq org-default-notes-file "~/org/notes.org" org-highlight-latex-and-related '(latex) org-bullets-bullet-list '("●" "○" "✸" "✿") org-ellipsis "…" org-catch-invisible-edits 'smart gnuplot-program "pyxplot") (defun my-org-timer-done () (shell-command "echo Timer timed out; date &")) :bind (("C-c a" . org-agenda) ("C-c B" . org-iswitchb) ("C-c c" . org-capture) ("C-c l" . org-store-link)) :config (add-hook 'org-timer-done-hook 'my-org-timer-done) (add-hook 'org-mode-hook 'org-bullets-mode) (require 'ox-beamer)) ;;; Switching buffers ;;; ----------------- ;;; Set keys from H-a to H-z to switch to buffers from a register from a to z (defalias 'pr 'point-to-register) (require 'cl) (let ((character ?a)) (while (<= character ?z) (let ((func-name-symbol (make-symbol (format "my-switch-to-register-%c" character)))) (global-set-key (kbd (format "H-%c" character)) (eval (list 'defun func-name-symbol '() (format "switch to buffer of register %c" character) '(interactive) `(let ((r (get-register ,character))) (if (and (markerp r) (marker-buffer r)) (switch-to-buffer (marker-buffer r)) (jump-to-register ,character))))))) (incf character))) ;;; Workaround for security vulnerability in Emacs >= 21.1 and < 25.3 ;;; ----------------------------------------------------------------- ;;; ;;; See [Changes in Emacs 25.3](https://www.gnu.org/software/emacs/news/NEWS.25.3) (eval-after-load "enriched" '(defun enriched-decode-display-prop (start end &optional param) (list start end))) ;;; Rest ;;; ---- (defun my-eww-scale-adjust () "Slightly bigger font but text shorter than text." (interactive) (text-scale-adjust 0) (text-scale-adjust 1) (eww-toggle-fonts) (split-window-right) (eww-toggle-fonts) (other-window 1) (sleep-for 1) (delete-window)) ;;; Use separate custom file ;;; ------------------------ (setq custom-file "~/.emacs.d/custom.el") (load custom-file)