my-emacs-d/configuration.org

* Emacs configuration

** Set up the package archives

#+BEGIN_SRC emacs-lisp
(require 'package)
(add-to-list 'package-archives
             '("gnu" . "http://elpa.gnu.org/packages/"))
(add-to-list 'package-archives
             '("melpa-stable" . "https://stable.melpa.org/packages/") t)
(add-to-list 'package-archives
             '("melpa" . "https://melpa.org/packages/") t)
(add-to-list 'package-archives
             '("marmalade" . "http://marmalade-repo.org/packages/") t)
(add-to-list 'package-archives
             '("org" . "http://orgmode.org/elpa/") t)
(package-initialize)
#+END_SRC

** Configure ~use-package~ and preload ~bind-key~

#+BEGIN_SRC emacs-lisp
(unless (package-installed-p 'use-package)
  (package-refresh-contents)
  (package-install 'use-package))

(require 'use-package)

(customize-set-variable 'use-package-always-ensure t)
(customize-set-variable 'use-package-verbose t)

(use-package bind-key)
#+END_SRC

** Set up my personal keymap

I set it up early so I can use it in ~use-package~ calls immediately.

#+BEGIN_SRC emacs-lisp
(defvar gpolonkai/pers-map (make-sparse-keymap)
  "My own, personal, keymap!")
(define-prefix-command 'gpolonkai/pers-map)
(define-key ctl-x-map "t" 'gpolonkai/pers-map)
(define-key global-map (kbd "C-t") 'gpolonkai/pers-map)
#+END_SRC

** I really don’t want to type more than I really must…

#+BEGIN_SRC emacs-lisp
(defalias 'yes-or-no-p 'y-or-n-p)
#+END_SRC

** Set UTF-8 as the default encoding

Just to make sure, although most Linux DE does this for me.

#+BEGIN_SRC emacs-lisp
(set-language-environment "UTF-8")
(set-default-coding-systems 'utf-8)
#+END_SRC

* Set personal information

** Who am I?

#+BEGIN_SRC emacs-lisp
(setq user-full-name "Gergely Polonkai"
      user-mail-address "gergely@polonkai.eu")
#+END_SRC

* Add some directories to ~load-path~

** My own (version controlled) ~lisp~ directory

#+BEGIN_SRC emacs-lisp
(add-to-list 'load-path (expand-file-name
                         (convert-standard-filename "lisp/")
                         user-emacs-directory))
(add-to-list 'load-path (expand-file-name
                         (convert-standard-filename "lisp/nyan-prompt")
                         user-emacs-directory))
#+END_SRC

** The local site-lisp

…if it exists.

#+BEGIN_SRC emacs-lisp
(let ((site-lisp-dir "/usr/local/share/emacs/site-lisp"))
  (when (file-directory-p site-lisp-dir)
    (dolist (elt (directory-files site-lisp-dir))
      (unless (or (string= elt ".") (string= elt ".."))
        (add-to-list 'load-path (expand-file-name elt site-lisp-dir))))))
#+END_SRC

* Load some prerequisites

** Load ~xdg-paths~

#+BEGIN_SRC emacs-lisp
(load "xdg-paths")
#+END_SRC

** Load the tango dark theme

#+BEGIN_SRC emacs-lisp
  (load-theme 'tango-dark t)
#+END_SRC

* Custom commands and functions

** Utility functions

*** Check if something is ~nil~ or a list of strings

#+BEGIN_SRC emacs-lisp
(defun nil-or-list-of-strings-p (var)
  "Return t if VAR is either nil or a list holding only strings."
  (or (null var)
      (not (null (delq nil
            (mapcar (lambda (x) (and (stringp x) x)) var))))))
#+END_SRC

*** Get the number at point

#+BEGIN_SRC emacs-lisp
(defun get-number-at-point ()
  (interactive)
  (skip-chars-backward "0123456789.-")
  (or (looking-at "[0123456789.-]+")
      (error "No number at point"))
  (string-to-number (match-string 0)))
#+END_SRC

*** Round number at point to the given decimals

#+BEGIN_SRC emacs-lisp
(defun round-number-at-point-to-decimals (decimal-count)
  (interactive "NDecimal count: ")
  (let ((mult (expt 10 decimal-count)))
    (replace-match (number-to-string
              (/
               (fround
                (*
                 mult
                 (get-number-at-point)))
                mult)))))
#+END_SRC

*** Make a backup filename under ~user-emacs-cache-directory~

Taken from [[http://ergoemacs.org/emacs/emacs_set_backup_into_a_directory.html][Xah’s site]].

#+BEGIN_SRC emacs-lisp
(defun xah/backup-file-name (fpath)
    "Return a new file path for FPATH under `user-emacs-cache-directory'"
    (let* ((backup-root-dir (expand-file-name "backup" user-emacs-cache-directory))
           (file-path (replace-regexp-in-string "[A-Za-z]:" "" fpath))
           (backup-file-path (replace-regexp-in-string "//" "/" (concat backup-root-dir file-path "~"))))
      (make-directory (file-name-directory backup-file-path) (file-name-directory backup-file-path))
      backup-file-path))
#+END_SRC

*** Run a function on a region

#+BEGIN_SRC emacs-lisp
(defun func-region (start end func)
  "Run a function over the region between START and END in current buffer."
  (save-excursion
    (let ((text (delete-and-extract-region start end)))
      (insert (funcall func text)))))
#+END_SRC

** Check if we are running under Termux

We need to do things differently, if so.

#+BEGIN_SRC emacs-lisp
(defun termux-p ()
  "Check if Emacs is running under Termux."
  (string-match-p
   (regexp-quote "/com.termux/")
   (expand-file-name "~")))
#+END_SRC

** Misc text manipulation functions

*** Delete the current line

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/delete-current-line ()
  "Kill the whole line on which point is."
  (interactive)

  (beginning-of-line)
  (kill-line 1))
#+END_SRC

*** Duplicate current line

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/duplicate-line()
  "Duplicate line at point."

  (interactive)

  (save-excursion
    (move-beginning-of-line 1)
    (kill-line)
    (yank)
    (open-line 1)
    (forward-line 1)
    (yank)))
#+END_SRC

*** Toggle case of character at point

Based on [[http://ergoemacs.org/emacs/modernization_upcase-word.html][Xah’s toggle letter case defun version 2015-12-22]]

#+BEGIN_SRC emacs-lisp
(defun toggle-char-case (arg-move-point)
  "Toggle the case of the char after point.

If prefix argument ARG-MOVE-POINT is non-nil, move point after the char."
  (interactive "P")
  (let ((case-fold-search nil))
    (cond
     ((looking-at "[[:lower:]]") (upcase-region (point) (1+ (point))))
     ((looking-at "[[:upper:]]") (downcase-region (point) (1+ (point)))))
    (cond
     (arg-move-point (right-char)))))
#+END_SRC

*** Open a new line below

Copied from http://whattheemacsd.com/editing-defuns.el-01.html

#+BEGIN_SRC emacs-lisp
(defun open-line-below ()
  "Open a new line below point."

  (interactive)

  (end-of-line)
  (newline)
  (indent-for-tab-command))
#+END_SRC

*** Open a new line above

#+BEGIN_SRC emacs-lisp
(defun open-line-above ()
  "Open a new line above point."

  (interactive)

  (beginning-of-line)
  (newline)
  (forward-line -1)
  (indent-for-tab-command))
#+END_SRC

*** TODO Kill or copy the whole line

Got from Xah’s site (TODO is for adding a link here.)

#+BEGIN_SRC emacs-lisp
(defun æ-kill-or-copy-whole-line (kill)
  "Kill or copy the whole line point is on.

If KILL is non-nil, the line gets killed.  Otherwise, it gets just
copied to the kill ring."
  (interactive "P")

  (if kill
      (kill-whole-line)
    (let ((beginning (progn (beginning-of-line) (point)))
          (end (progn (end-of-line) (point))))
      (copy-region-as-kill beginning end))))
#+END_SRC

*** Enclose region in a specific character

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/enclose-region (character &optional start end)
  "Enclose region between CHARACTER.

If region is empty and neither START nor END is set, simply inserts CHARACTER
two times and moves point between them.

If character is present in `insert-pair-alist', this function will enclose
region in the corresponding pair.  In this case, CHARACTER must be the opening
member of the pair."

  (interactive "cWhat character? \nr")

  (let ((open character)
        (close character)
        (pair (assq character insert-pair-alist)))
    (if pair
        (if (nth 2 pair)
            (setq open (nth 1 pair) close (nth 2 pair))
          (setq open (nth 0 pair) close (nth 1 pair))))
    (unless (and open close)
      (setq open character
            close character))
    (unless (use-region-p)
      (setq start (point) end (point)))
    (save-excursion
      (goto-char end)
      (insert-char close)

      (goto-char start)
      (insert-char open))
    (unless (use-region-p)
      (forward-char))))
#+END_SRC

*** Convert camelCase to snake_case

#+BEGIN_SRC emacs-lisp
(defun camel-to-snake-case (arg)
  "Convert a camel case (camelCase or CamelCase) word to snake case (snake_case).

If the prefix argument ARG is non-nil, convert the text to uppercase."
  (interactive "p")
  (progn
    (let ((start (region-beginning))
          (end (region-end))
          (case-fold-search nil)
          (had-initial-underscore nil))
      (goto-char start)
      (when (looking-at "_") (setq had-initial-underscore t))
      (while (re-search-forward "\\([A-Z]\\)" end t)
        (replace-match "_\\1")
        (setq end (1+ end)))
      (if arg
          (upcase-region start end)
        (downcase-region start end))
      (goto-char start)
      (unless had-initial-underscore (delete-char 1)))))
#+END_SRC

*** Insert two spaces after specific characters

#+BEGIN_SRC emacs-lisp
(defun org-space-key (&optional arg)
  "Insert two spaces after a period.

ARG will be passed down verbatim to `self-insert-command'"
  (interactive "p")

  (when (looking-back "[.!?…]" nil)
    (call-interactively 'self-insert-command arg))
  (call-interactively 'self-insert-command arg))
#+END_SRC

*** Fill or unfill a paragraph

From http://pages.sachachua.com/.emacs.d/Sacha.html

#+BEGIN_SRC emacs-lisp
(defun sachachua/fill-or-unfill-paragraph (&optional unfill region)
  "Fill (or unfill, if UNFILL is non-nil) paragraph (or REGION)."
  (interactive (progn
                 (barf-if-buffer-read-only)
                 (list (if current-prefix-arg 'unfill) t)))
  (let ((fill-column (if unfill (point-max) fill-column)))
    (fill-paragraph nil region)))
#+END_SRC

*** Swap occurences of strings

Copied from http://emacs.stackexchange.com/a/27170/507

#+BEGIN_SRC emacs-lisp
(defun so/query-swap-strings (from-string
                              to-string
                              &optional delimited start end)
  "Swap occurrences of FROM-STRING and TO-STRING.

DELIMITED, START, and END are passed down verbatim to `perform-replace'."
  (interactive
   (let ((common
          (query-replace-read-args
           (concat "Query swap"
                   (if current-prefix-arg
                       (if (eq current-prefix-arg '-) " backward" " word")
                     "")
                   (if (use-region-p) " in region" ""))
           nil)))
     (list (nth 0 common) (nth 1 common) (nth 2 common)
           (if (use-region-p) (region-beginning))
           (if (use-region-p) (region-end)))))
  (perform-replace
   (concat "\\(" (regexp-quote from-string) "\\)\\|" (regexp-quote to-string))
   `(replace-eval-replacement replace-quote
                              (if (match-string 1)
                                  ,to-string
                                ,from-string))
   t t delimited nil nil start end))
#+END_SRC

** Navigation

*** Move to different beginnings of the current line

Inspired by Bozhidar Batsov's [[http://emacsredux.com/blog/2013/05/22/smarter-navigation-to-the-beginning-of-a-line/][solution]].

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/move-to-beginning-of-line ()
  "Move to different beginnings of the line.

These are, in order:

- beginning of the visual line if `visual-line-mode' is active,
- the first non-whitespace (indentation),
- the actual beginning of the line.

This function will jump between the first character and the
indentation if used multiple times."
  (interactive)
  (let ((last-pos (point)))
    (when visual-line-mode
      (beginning-of-visual-line))
    (when (= (point) last-pos)
      (back-to-indentation))
    (when (= (point) last-pos)
      (beginning-of-line))
    (when (and (eq major-mode 'org-mode)
               (= (point) last-pos))
      (org-beginning-of-line))
    (when (= (point) last-pos)
      (back-to-indentation))))
#+END_SRC

*** Move to the different ends of the current line

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/move-to-end-of-line ()
  "Move to the end of the line.

If `visual-line-mode' is active, jump to the end of the visual
line first.  Then jump to the actual end of the line."
  (interactive)
  (let ((last-pos (point)))
    (when visual-line-mode
      (end-of-visual-line))
    (when (= (point) last-pos)
      (end-of-line))
    (when (and (eq major-mode 'org-mode)
               (= (point) last-pos))
      (org-end-of-line))))
#+END_SRC

** File manipulation

*** Rename the current file

Copied from http://whattheemacsd.com/file-defuns.el-01.html

#+BEGIN_SRC emacs-lisp
(defun rename-current-buffer-file ()
  "Renames current buffer and file it is visiting."
  (interactive)

  (let ((name (buffer-name))
        (filename (buffer-file-name)))
    (if (not (and filename (file-exists-p filename)))
        (error "Buffer '%s' is not visiting a file!" name)
      (let ((new-name (read-file-name "New name: " filename)))
        (if (get-buffer new-name)
            (error "A buffer named '%s' already exists!" new-name)
          (rename-file filename new-name 1)
          (rename-buffer new-name)
          (set-visited-file-name new-name)
          ; TODO: this is suspicious for me…
          (set-buffer-modified-p nil)
          (message "File '%s' successfully renamed to '%s'"
                   name (file-name-nondirectory new-name)))))))
#+END_SRC

*** Delete the current file

Copied from http://whattheemacsd.com/file-defuns.el-02.html

#+BEGIN_SRC emacs-lisp
(defun delete-current-buffer-file ()
  "Remove file connected to current buffer and kill the buffer."
  (interactive)

  (let ((filename (buffer-file-name))
        (name (buffer-name))
        (buffer (current-buffer)))
    (if (not (and filename (file-exists-p filename)))
        (kill-buffer buffer)
      (when (yes-or-no-p "Are you sure you want to remove this file? ")
        (delete-file filename)
        (kill-buffer buffer)
        (message "File '%s' successfully removed" filename)))))
#+END_SRC

*** Allow reopening the previously closed file

#+BEGIN_SRC emacs-lisp
(defvar gpolonkai/last-killed-buffer-file-name
  nil
  "The last killed buffer.

Used by `gpolonkai/save-killed-buffer-filename' and `gpolonkai/undo-buffer-kill'.")

(defun gpolonkai/save-killed-buffer-filename ()
  "Save the filename of the killed buffer in `gpolonkai/last-killed-buffer-file-name'."
  (let ((filename (buffer-file-name)))
   (unless filename
    (setq gpolonkai/last-killed-buffer-file-name (buffer-file-name)))))

(add-hook 'kill-buffer-hook 'gpolonkai/save-killed-buffer-filename)

(defun gpolonkai/undo-buffer-kill ()
  "Undo killing the last buffer.

Esentially it visits the file again."
  (interactive)
  (if gpolonkai/last-killed-buffer-file-name
      (progn
        (find-file gpolonkai/last-killed-buffer-file-name)
        (setq gpolonkai/last-killed-buffer-file-name nil))
    (message "The buffer last killed didn’t visit a file.")))
#+END_SRC

*** Open this file as another user

#+BEGIN_SRC emacs-lisp
(defun open-this-file-as-other-user (user)
  "Edit current file as USER, using `tramp' and `sudo'.

If the current buffer is not visiting a file, prompt for a file
name."
  (interactive "sEdit as user (default: root): ")
  (when (string= "" user)
    (setq user "root"))
  (let* ((filename (or buffer-file-name
                       (read-file-name (format "Find file (as %s): "
                                               user))))
         (tramp-path (concat (format "/sudo:%s@localhost:" user) filename)))
    (if buffer-file-name
        (find-alternate-file tramp-path)
      (find-file tramp-path))))
#+END_SRC

*** Open my own ~init.el~

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/visit-init-file ()
  "Open the init file."
  (interactive)
  (find-file-other-window (expand-file-name "configuration.org" user-emacs-directory)))
#+END_SRC

*** Open my Org-mode index file

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/visit-org-index ()
  "Visit the root of Org-mode notes."
  (interactive)
  (find-file-other-window (concat (file-name-as-directory org-directory)
                                  "index.org")))
#+END_SRC

** Frame manipulation

*** Hidden modeline mode

To temporarily hide the mode line.

Copied from http://emacs-doctor.com/emacs-strip-tease.html

#+BEGIN_SRC emacs-lisp
(defvar hidden-mode-line-mode nil)
(defvar hide-mode-line nil)

(define-minor-mode hidden-mode-line-mode
  "Minor mode to hide the mode-line in the current buffer."
  :init-value nil
  :global nil
  :variable hidden-mode-line-mode
  :group 'editing-basics
  (if hidden-mode-line-mode
      (setq hide-mode-line mode-line-format
            mode-line-format nil)
    (setq mode-line-format hide-mode-line
          hide-mode-line nil))
  (force-mode-line-update)
  (redraw-display)
  (when (and (called-interactively-p 'interactive)
             hidden-mode-line-mode)
    (run-with-idle-timer
     0 nil 'message
     (concat "Hidden Mode Line Mode enabled.  "
             "Use M-x hidden-mode-line-mode to make mode-line appear."))))
#+END_SRC

** Window manipulation

*** Transpose windows

#+BEGIN_SRC emacs-lisp
(defun transpose-windows (arg)
  "Transpose the buffers shown in two windows."
  (interactive "p")
  (let ((selector (if (>= arg 0) 'next-window 'previous-window)))
    (while (/= arg 0)
      (let ((this-win (window-buffer))
            (next-win (window-buffer (funcall selector))))
        (set-window-buffer (selected-window) next-win)
        (set-window-buffer (funcall selector) this-win)
        (select-window (funcall selector)))
      (setq arg (if (plusp arg) (1- arg) (1+ arg))))))
#+END_SRC

*** Toggle window split between horizontal and vertical

#+BEGIN_SRC emacs-lisp
(defun toggle-window-split ()
  (interactive)
  (if (= (count-windows) 2)
      (let* ((this-win-buffer (window-buffer))
             (next-win-buffer (window-buffer (next-window)))
             (this-win-edges (window-edges (selected-window)))
             (next-win-edges (window-edges (next-window)))
             (this-win-2nd (not (and (<= (car this-win-edges)
                                         (car next-win-edges))
                                     (<= (cadr this-win-edges)
                                         (cadr next-win-edges)))))
             (splitter
              (if (= (car this-win-edges)
                     (car (window-edges (next-window))))
                  'split-window-horizontally
                'split-window-vertically)))
        (delete-other-windows)
        (let ((first-win (selected-window)))
          (funcall splitter)
          (if this-win-2nd (other-window 1))
          (set-window-buffer (selected-window) this-win-buffer)
          (set-window-buffer (next-window) next-win-buffer)
          (select-window first-win)
          (if this-win-2nd (other-window 1))))
    (error "This works only for two windows!")))
#+END_SRC

*** Scroll up or down in a specific window

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/scroll-window-up (window)
  "Scroll WINDOW up as `scroll-up-command' would."
  (interactive)
  (save-selected-window
    (select-window window)
    (scroll-up)))

(defun gpolonkai/scroll-window-down (window)
  "Scroll WINDOW down as `scroll-down-command' would."
  (interactive)
  (save-selected-window
    (select-window window)
    (scroll-down)))
#+END_SRC

*** Bury a window

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/bury-window (window)
  "Quit WINDOW without killing it."
  (interactive)
  (quit-window nil window))
#+END_SRC

** ~c-mode~ related

*** Copy the prototype of the current function

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/copy-func-prototype ()
  "Copy the current function's prototype to the kill ring."

  (interactive)

  (save-excursion
    (beginning-of-defun)
    (let ((protocopy-begin (point)))
      (forward-list)
      (let ((protocopy-end (point)))
        (kill-ring-save protocopy-begin protocopy-end)))))
#+END_SRC

** Programming related

*** Check if we are inside a string

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/prog-in-string-p ()
  "Return t if point is inside a string."
  (nth 3 (syntax-ppss)))
#+END_SRC

*** Check if we are inside a comment

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/prog-in-comment-p ()
  "Return t if point is inside a comment."
  (nth 4 (syntax-ppss)))
#+END_SRC

** ~python-mode~ related

*** Add a docstring to the current thing

…be it a function, class, or a module

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/python-add-docstring ()
  "Add a Python docstring to the current thing.

If point is inside a function, add docstring to that.  If point
is in a class, add docstring to that.  If neither, add docstring
to the beginning of the file."
  (interactive)
  (save-restriction
    (widen)
    (beginning-of-defun)
    (if (not (looking-at-p "\\(def\\|class\\) "))
        (progn
          (goto-char (point-min))
          (back-to-indentation)
          (forward-char)
          (while (gpolonkai/prog-in-comment-p)
            (forward-line)
            (back-to-indentation)
            (forward-char)))
      (search-forward ":")
      (while (or (gpolonkai/prog-in-string-p)
                 (gpolonkai/prog-in-comment-p))
        (search-forward ":")))
    (if (eq 1 (count-lines 1 (point)))
        (open-line-above)
      (open-line-below))
    (insert "\"\"\"")
    (open-line-below)
    (insert "\"\"\"")
    (open-line-above)))
#+END_SRC

** ~idm~ (ID manager) related functions

*** Get specific fields from a record in ~idm~

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/idm-record-get-field (record field)
  "Get FIELD of an id-manager RECORD."
  (let ((funcname (intern (concat "idm-record-" (symbol-name field)))))
    (when (fboundp funcname)
      (funcall funcname record))))

(defun gpolonkai/idm-get-field-for-account (account field)
  "Get id-manager password for ACCOUNT."
  (let ((db (idm-load-db))
        (lookup-record nil))
    (dolist (record (funcall db 'get-all-records) password)
      (when (string= account (idm-record-name record))
        (setq lookup-record (gpolonkai/idm-record-get-field record field))))
    lookup-record))

(defmacro gpolonkai/idm-get-password-for-account (account)
  `(gpolonkai/idm-get-field-for-account ,account 'password))

(defmacro gpolonkai/idm-get-id-for-account (account)
  `(gpolonkai/idm-get-field-for-account ,account 'account-id))
#+END_SRC

** Jinja related

*** Mark a string as translatable

#+BEGIN_SRC emacs-lisp
(defun jinja-mark-translatable (begin end)
  (interactive (if (use-region-p)
                   (list (region-beginning) (region-end))
                 (list (point-min) (point-max))))
  (save-excursion
    (goto-char end)
    (insert "{% endtrans %}")
    (goto-char begin)
    (insert "{% trans %}")))
#+END_SRC

*** URL-ify and de-URL-ify region

These functions URL-encode/decode a text.  Might be helpful when embedding/extracting data to/from
HTML.

#+BEGIN_SRC emacs-lisp
(defun hex-region (start end)
  "urlencode the region between START and END in current buffer."
  (interactive "r")
  (func-region start end #'url-hexify-string))

(defun unhex-region (start end)
  "de-urlencode the region between START and END in current buffer."
  (interactive "r")
  (func-region start end #'url-unhex-string))
#+END_SRC

** Automatically zone out after 60 seconds

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/zone-enable ()
  "Enable zoning out."
  (interactive)
  (zone-when-idle 60)
  (message "I will zone out after idling for 60 seconds."))
#+END_SRC

** Utility functions for editing Zim wiki files

#+BEGIN_SRC emacs-lisp
(defun zim-timestamp ()
  (with-temp-buffer
    (insert (format-time-string "%Y-%m-%dT%H:%M:%S%z"))
    (forward-char -2)
    (insert ":")
    (buffer-string)))

(defun insert-zim-timestamp ()
  (interactive)
  (insert (zim-timestamp)))

(defun insert-zim-header ()
  (interactive)
  (save-excursion
    (goto-char (point-min))
    (insert
     (concat "Content-Type: text/x-zim-wiki\n"
             "Wiki-Format: zim 0.4\n"
             "Creation-Date: " (zim-timestamp) "\n\n"))))
#+END_SRC

** Utility functions for EDiff

EDiff and Org-mode files don’t play nice together

From [[http://article.gmane.org/gmane.emacs.orgmode/75222][gmane.emacs.orgmode]]

#+BEGIN_SRC emacs-lisp
(defun f-ediff-org-showhide (buf command &rest cmdargs)
  "If buffer BUF exists and in `org-mode', execute COMMAND with CMDARGS."
  (when buf
    (when (eq (buffer-local-value 'major-mode (get-buffer buf)) 'org-mode)
      (save-excursion
        (set-buffer buf)
        (apply command cmdargs)))))

(defun f-ediff-org-unfold-tree-element ()
  "Unfold tree at diff location."
  (f-ediff-org-showhide ediff-buffer-A 'org-reveal)
  (f-ediff-org-showhide ediff-buffer-B 'org-reveal)
  (f-ediff-org-showhide ediff-buffer-C 'org-reveal))

(defun f-ediff-org-fold-tree ()
  "Fold tree back to top level."
  (f-ediff-org-showhide ediff-buffer-A 'hide-sublevels 1)
  (f-ediff-org-showhide ediff-buffer-B 'hide-sublevels 1)
  (f-ediff-org-showhide ediff-buffer-C 'hide-sublevels 1))
#+END_SRC

** Leave ~isearch~ at the other end of the matched string

Taken from [[http://endlessparentheses.com/leave-the-cursor-at-start-of-match-after-isearch.html][endless parentheses]]

#+BEGIN_SRC emacs-lisp
(defun isearch-exit-other-end ()
  "Exit isearch, at the opposite end of the string."
  (interactive)

  (isearch-exit)
  (goto-char isearch-other-end))
#+END_SRC

** Mark the current match after leaving ~isearch~

Taken from [[http://emacs.stackexchange.com/a/31321/507][here]].

#+BEGIN_SRC emacs-lisp
(defun isearch-exit-mark-match ()
  "Exit isearch and mark the current match."
  (interactive)
  (isearch-exit)
  (push-mark isearch-other-end)
  (activate-mark))
#+END_SRC

** Make the slash (~/~) key act like ~C-j~ in some Helm views

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/helm-ff-slash-dir-complete ()
  "Make forward slash (/) do completion in helm."
  (interactive)
  (if (and (or
            (equal "magit-status" (assoc-default 'name (helm-get-current-source)))
            (equal "Find Files" (assoc-default 'name (helm-get-current-source)))
            (equal "helm-mode-insert-file" (assoc-default 'name (helm-get-current-source))))
           (stringp (helm-get-selection))
           (file-directory-p (helm-get-selection)))
      (helm-execute-persistent-action)
    (insert "/")))
#+END_SRC

** Turn the cursor to purple if Yasnippet’s TAB function would fire

Taken from [[http://pages.sachachua.com/.emacs.d/Sacha.html][Sacha Chua’s config]].

#+BEGIN_SRC emacs-lisp
;; TODO: 'cursor-color is sometimes nil, but why?
(setq default-cursor-color (or (frame-parameter nil 'cursor-color) "#ffd85c"))
(setq yasnippet-can-fire-cursor-color "purple")

;; It will test whether it can expand, if yes, cursor color -> purple.
(defun yasnippet-can-fire-p (&optional field)
  "Check if the word before point can be expanded with yasnippet.

TODO: What is FIELD for?"
  (interactive)
  (setq yas--condition-cache-timestamp (current-time))
  (let (templates-and-pos)
    (unless (and yas-expand-only-for-last-commands
                 (not (member last-command yas-expand-only-for-last-commands)))
      (setq templates-and-pos (if field
                                  (save-restriction
                                    (narrow-to-region (yas--field-start field)
                                                      (yas--field-end field))
                                    (yas--templates-for-key-at-point))
                                (yas--templates-for-key-at-point))))
    (and templates-and-pos (first templates-and-pos))))

(defun sachachua/change-cursor-color-when-can-expand (&optional field)
  "Change cursor color if the text before point can be expanded with yasnippet.

TODO: What is FIELD for?"
  (interactive)
  (when (eq last-command 'self-insert-command)
    (set-cursor-color (if (sachachua/can-expand)
                          yasnippet-can-fire-cursor-color
                        default-cursor-color))))

(defun sachachua/can-expand ()
  "Return t if right after an expandable thing."
  (or (abbrev--before-point) (yasnippet-can-fire-p)))
#+END_SRC

** Filter out tasks from the Org agenda if they have a specific priority

The whole idea comes from [[https://blog.aaronbieber.com/2016/09/24/an-agenda-for-life-with-org-mode.html][here]], which i use almost verbatim.  This is also the reason it has the
~air-~ prefix.

#+BEGIN_SRC emacs-lisp
(defun air-org-skip-subtree-if-priority (priority)
  "Skip an agenda subtree if it has a priority of PRIORITY.

PRIORITY may be one of the characters ?A, ?B, or ?C."
  (let ((subtree-end (save-excursion (org-end-of-subtree t)))
        (pri-value (* 1000 (- org-lowest-priority priority)))
        (pri-current (org-get-priority (thing-at-point 'line t))))
    (if (= pri-value pri-current)
        subtree-end
      nil)))
#+END_SRC

** Filter out habits from the Org agenda

#+BEGIN_SRC emacs-lisp
(defun air-org-skip-subtree-if-habit ()
  "Skip an agenda entry if it has a STYLE property equal to \"habit\"."
  (let ((subtree-end (save-excursion (org-end-of-subtree t))))
    (if (string= (org-entry-get nil "STYLE") "habit")
        subtree-end
      nil)))
#+END_SRC

** Filter out entries from the Org agenda with a specific state

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/org-skip-subtree-if-state (state)
  "Skip an agenda entry if its state is STATE."
  (let ((subtree-end (save-excursion (org-end-of-subtree t))))
    (if (string= (org-get-todo-state) state)
        subtree-end
      nil)))
#+END_SRC

** Wrapper around ~org-agenda~ to open my own custom list

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/org-agenda-list (&optional arg)
  (interactive "P")
  (org-agenda arg "c"))
#+END_SRC

* UI preferences

** Tweak window chrome

Turn off the scroll bar (that’s why Nyan-cat is here), the toolbar (I don’t really use it), and
the menu bar (I rarely use it, and in those rare occasions I can simply turn it on.)

Also, maximise the frame.

#+BEGIN_SRC emacs-lisp
(tool-bar-mode 0)
(menu-bar-mode 0)
(when window-system
  (scroll-bar-mode -1))

(set-frame-parameter nil 'fullscreen 'maximized)
#+END_SRC

** Set the default font and configure font resizing

Before this can be used, make sure the [[https://zhm.github.io/symbola/][Symbola]] font is installed.

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/set-font-size (frame)
  (set-face-attribute 'default frame :font "Hack-12")
  (set-frame-font "Hack-12" t frame))

(defun --set-emoji-font (frame)
  "Adjust the font setting of FRAME so Emacs can display Emoji properly."
  (when (fboundp 'set-fontset-font)
    (set-fontset-font t 'symbol
                      (font-spec :family "Symbola")
                      frame 'prepend)))

(add-hook 'after-make-frame-functions 'gpolonkai/set-font-size)
(add-hook 'after-make-frame-functions '--set-emoji-font)

(gpolonkai/set-font-size nil)
(--set-emoji-font nil)
#+END_SRC

* Set up global minor modes provided by Emacs

** Pretty lambdas

Because we can.

#+BEGIN_SRC emacs-lisp
(global-prettify-symbols-mode t)
#+END_SRC

And set up all the pretty symbols.

#+BEGIN_SRC emacs-lisp
;; Add some symbols to be prettified
(setq prettify-symbols-alist
      '(("lambda" . 955)    ; λ
        ("function" . 402)  ; ƒ
        ("->" . 8594)       ; →
        ("=>" . 8658)       ; ⇒
        ("map" . 8614)      ; ↦
        ("not" . 172))      ; ¬

      ;; …and some pairs to complete
      ;; TODO: maybe add-to-list is a better way to do it
      insert-pair-alist '(
                          (40 41)      ; ()
                          (91 93)      ; []
                          (123 125)    ; {}
                          (60 62)      ; <>
                          (34 34)      ; ""
                          (39 39)      ; ''
                          (96 39)      ; `'
                          (8220 8221)  ; “”
                          (8222 8221)  ; „”
                          (8216 8217)  ; ‘’
                          (8249 8250)  ; ‹›
                          (8250 8249)  ; ›‹
                          (171 187)    ; «»
                          (187 171))   ; »«

      ;; Set the frame title to the current file name
      frame-title-format '((:eval (concat system-name
                                          ": "
                                          (if (buffer-file-name)
                                              (abbreviate-file-name
                                               (buffer-file-name))
                                            "%b")))))
#+END_SRC

** Treat soft line breaks as hard ones in textual modes

#+BEGIN_SRC emacs-lisp
(add-hook 'text-mode-hook (lambda () (visual-line-mode t)))
#+END_SRC

* Enable disabled commands

Because I’m a rock star like that.

#+BEGIN_SRC emacs-lisp
(put 'downcase-region 'disabled nil)
(put 'upcase-region 'disabled nil)
(put 'erase-buffer 'disabled nil)
(put 'narrow-to-region 'disabled nil)
(put 'narrow-to-page 'disabled nil)
(put 'set-goal-column 'disabled nil)
(put 'scroll-left 'disabled nil)
(put 'dired-find-alternate-file 'disabled nil)
(put 'Info-edit 'disabled nil)
(put 'list-timers 'disabled nil)
#+END_SRC

* Load some built-in libraries

** ~thingatpt~

#+BEGIN_SRC emacs-lisp
(use-package thingatpt
  :ensure nil)
#+END_SRC

** Calendar

#+BEGIN_SRC emacs-lisp
(use-package calendar
  :ensure nil
  :init
  (setq calendar-week-start-day 1
        calendar-latitude 47.4
        calendar-longitude 19.0
        calendar-location-name "Budapest, Hungary"
        calendar-time-zone 60
        calendar-standard-time-zone-name "CET"
        calendar-daylight-time-zone-name "CEST"))
#+END_SRC

*** Add the SysAdmin day to the calendar

Because I’m a sysadmin, too.

#+BEGIN_SRC emacs-lisp
(add-to-list 'holiday-other-holidays '(holiday-float 7 5 -1 "SysAdmin Day") t)
(add-to-list 'holiday-other-holidays '(holiday-fixed 10 21 "Reptile Awareness Day") t)
#+END_SRC

** nXML

#+BEGIN_SRC emacs-lisp
(use-package nxml-mode
  :ensure nil
  :config
  (setq nxml-attribute-indent 4
        nxml-child-indent 2
        nxml-outline-child-indent 4))
#+END_SRC

** ~recentf~

#+BEGIN_SRC emacs-lisp
(use-package recentf
  :ensure nil
  :config
  (run-at-time nil (* 5 60) 'recentf-save-list)
  (add-to-list 'recentf-exclude (concat user-emacs-directory "elpa")))
#+END_SRC

** ~files~

#+BEGIN_SRC emacs-lisp
(use-package files
  :ensure nil
  :config
  (setq make-backup-file-name-function 'xah/backup-file-name))
#+END_SRC

** ~whitespace~

~whitespace-mode~ is turned on by default, and can be toggled with ~F10~.

#+BEGIN_SRC emacs-lisp
(defun prevent-whitespace-mode-for-some ()
  "Prevent whitespace-mode from running in some modes."
  (and
   (not (derived-mode-p 'magit-mode))
   (not (derived-mode-p 'org-mode))))

(use-package whitespace
  :demand
  :config
  (add-function :before-while whitespace-enable-predicate 'prevent-whitespace-mode-for-some)
  (global-whitespace-mode 1)
  (setq whitespace-line-column 100)
  :bind
  (([f10] . whitespace-mode)
   ([(shift f10)] . global-whitespace-mode)
   :map gpolonkai/pers-map
   ("w" . whitespace-cleanup)))
#+END_SRC

** ~eshell~

This is a function to delete a character, or close ~eshell~ if there’s nothing to delete.  Taken
from [[https://ryuslash.org/posts/C-d-to-close-eshell.html][here]].

#+BEGIN_SRC emacs-lisp
(defun eshell-C-d ()
  "Either call `delete-char' interactively or quit."
  (interactive)

  (condition-case err
      (call-interactively #'delete-char)
    (error (if (and (eq (car err) 'end-of-buffer)
                    (looking-back eshell-prompt-regexp nil))
               (kill-buffer)
             (signal (car err) (cdr err))))))
#+END_SRC

Function to bind it locally to =C-d=.

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/eshell-set-c-d-locally ()
  (local-set-key (kbd "C-d") #'eshell-C-d))
#+END_SRC

Now set up eshell.

#+BEGIN_SRC emacs-lisp
(use-package eshell
  :bind
  (:map gpolonkai/pers-map
   ("e" . eshell))
  :hook
  (eshell-mode . gpolonkai/eshell-set-c-d-locally))
#+END_SRC

** ~saveplace~

#+BEGIN_SRC emacs-lisp
;; Save place
(use-package saveplace
  :config'
  (if (version< emacs-version "25.0")
      (setq-default save-place t)
    (save-place-mode 1))
  (setq save-place-file (expand-file-name ".places" user-emacs-directory)))
#+END_SRC

** ID manager

Manage credentials, AKA password manager.

#+BEGIN_SRC emacs-lisp
(use-package id-manager
  :config
  (setq idm-database-file (expand-file-name "idm-db.gpg" user-emacs-directory))
  :bind
  (:map gpolonkai/pers-map
   ("i" . idm-open-list-command)))
#+END_SRC

** EDiff

#+BEGIN_SRC emacs-lisp
(use-package ediff
  :init
  (setq-default ediff-merge-split-window-function 'split-window-horizontally
                ediff-split-window-function 'split-window-vertically
                ediff-window-setup-function 'ediff-setup-windows-plain))
#+END_SRC

** Automatically revert changed files

…unless they are modified, of course.

#+BEGIN_SRC emacs-lisp
(use-package autorevert
  :config
  (global-auto-revert-mode 1))
#+END_SRC

** Eww

For in-Emacs browsing needs.

#+BEGIN_SRC emacs-lisp
(use-package eww
  :config
  (setq eww-search-prefix "https://www.google.com/?q="))
#+END_SRC

** Electric indent mode

#+BEGIN_SRC emacs-lisp
(use-package electric
  :config
  ;; This seems to be the default, but let’s make sure…
  (electric-indent-mode 1))
#+END_SRC

** Save history

#+BEGIN_SRC emacs-lisp
(use-package savehist
  :config
  (savehist-mode 1))
#+END_SRC

** Web jump

#+BEGIN_SRC emacs-lisp
(use-package webjump
  :bind
  (:map gpolonkai/pers-map
   ("j" . webjump)))
#+END_SRC

** Which function am I in?

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/activate-which-func-mode ()
  (if (fboundp 'which-function-mode)
      (which-function-mode)
    (which-func-mode)))
#+END_SRC

#+BEGIN_SRC emacs-lisp
(use-package which-func
  :config
  (setq which-func-unknown "∅")
  :hook
  (prog-mode . gpolonkai/activate-which-func-mode))
#+END_SRC

** Fortune cookies

The cookies are from the Hungarian version an ancient MS-DOS based program called ~TAGLINE~.

#+BEGIN_SRC emacs-lisp
(use-package cookie1
  :demand t
  :config
  (setq cookie-file (concat user-emacs-directory "fortune-cookies.txt"))
  :bind
  (:map gpolonkai/pers-map
   ("k" . cookie)))
#+END_SRC

** Browse URL functionality in Termux

#+BEGIN_SRC emacs-lisp
(when (termux-p)
  (use-package browse-url
    :ensure nil
    :config
    (advice-add 'browse-url-default-browser :override
                (lambda (url &rest args)
                  (start-process-shell-command
                   "open-url"
                   nil
                   (concat "am start -a android.intent.action.VIEW --user 0 -d "
                           url))))))
#+END_SRC

** Dired customisation

#+BEGIN_SRC emacs-lisp
(use-package dired
  :ensure nil
  :config
  (customize-set-variable 'dired-dwim-target t)
  (customize-set-variable 'wdired-create-parent-directories t)
  (customize-set-variable 'wdired-allow-to-change-permissions t)
  :bind
  (:map dired-mode-map
   ("RET" . dired-find-alternate-file)
   ("^" . (lambda () (interactive) (find-alternate-file "..")))
   ("W" . wdired-change-to-wdired-mode)))

(use-package dired-x
  :ensure nil)
#+END_SRC

** Actionable URLs

#+BEGIN_SRC emacs-lisp
(use-package goto-addr
  :hook ((compilation-mode . goto-address-mode)
         (prog-mode . goto-address-prog-mode)
         (eshell-mode . goto-address-mode)
         (shell-mode . goto-address-mode))
  :bind
  (:map goto-address-highlight-keymap
   ("<RET>" . goto-address-at-point)
   ("M-<RET>" . newline))
  :commands (goto-address-prog-mode goto-address-mode))
#+END_SRC

** Do things at midnight

By default, it closes a bunch of unused buffers.  I might add some more things there later.

#+BEGIN_SRC emacs-lisp
(use-package midnight
  :ensure nil
  :config
  (setq clean-buffer-list-kill-never-buffer-names '("*scratch*"
                                                    "*Messages*"
                                                    "*dashboard*"))
  (midnight-mode t))
#+END_SRC

** Show line numbers

I don’t usually like to see them, but there are occasions when they can be useful.

#+BEGIN_SRC emacs-lisp
(use-package display-line-numbers
  :bind
  (:map gpolonkai/pers-map
   ("C-n" . display-line-numbers-mode)))
#+END_SRC

** Check for spelling errors

#+BEGIN_SRC emacs-lisp
(use-package ispell
  :config
  (customize-set-variable 'ispell-dictionary "en_GB")
  (customize-set-variable 'ispell-program-name "/usr/bin/aspell")
  :hook
  (mail-send . ispell-message)
  (message-send . ispell-message))
#+END_SRC

* ~use-package~ packages

** Automatically upgrade packages every week

#+BEGIN_SRC emacs-lisp
(use-package auto-package-update
  :config
  (setq auto-package-update-interval 7
        auto-package-update-delete-old-versions t)
  ;; Let’s do this in after-init-hook, as use-package invocations may modify
  ;; the list of installed packages
  :hook
  (after-init . auto-package-update-maybe))
#+END_SRC

** Nyanyanyanyanya

*** Nyan-cat style position marker

#+BEGIN_SRC emacs-lisp
(use-package nyan-mode
  :init
  (setq-default nyan-animate-nyancat t
                nyan-wavy-trail t)
  :config
  (customize-set-variable 'nyan-bar-length 20)
  (nyan-mode t))
#+END_SRC

*** Nyan prompt in EShell

#+BEGIN_SRC emacs-lisp
(use-package nyan-prompt
  :ensure nil)
#+END_SRC

*** Zone out with Nyancat

Unfortunately, this works only in a graphical mode.

#+BEGIN_SRC emacs-lisp
(use-package zone-nyan
  :after
  zone
  :config
  (setq-default zone-nyan-hide-progress t)
  (setq zone-programs (vconcat zone-programs [zone-nyan])))
#+END_SRC

** De-light some minor modes

#+BEGIN_SRC emacs-lisp
(use-package delight)
#+END_SRC

** Eye candy

*** Moody mode-line

#+BEGIN_SRC emacs-lisp
(use-package moody
  :config
  (moody-replace-mode-line-buffer-identification)
  (moody-replace-vc-mode)
  (customize-set-variable 'moody-mode-line-height 18)
  (set-face-attribute 'mode-line nil :box nil :foreground "#7e7486")
  (set-face-attribute 'mode-line-inactive nil :box nil))
#+END_SRC

*** Minions

#+BEGIN_SRC emacs-lisp
(use-package minions
  :config
  (minions-mode 1))
#+END_SRC

*** Spinner, e.g. to display running background tasks

#+BEGIN_SRC emacs-lisp
(use-package spinner)
#+END_SRC

*** Beacon

Highlight point.  Sometimes it’s not easy to see.

#+BEGIN_SRC emacs-lisp
(use-package beacon
  :demand
  :config
  (beacon-mode 1)
  :bind
  (:map gpolonkai/pers-map
   ("b" . beacon-blink)))
#+END_SRC

*** Display the status of the last command in the fringe of EShell

#+BEGIN_SRC emacs-lisp
(use-package eshell-fringe-status
  :hook
  (eshell-mode . eshell-fringe-status-mode))
#+END_SRC

*** Extras for the EShell prompt

#+BEGIN_SRC emacs-lisp
(use-package eshell-prompt-extras
  :config
  (with-eval-after-load "esh-opt"
    (autoload 'epe-theme-lambda "eshell-prompt-extras")
    (setq eshell-highlight-prompt nil
          eshell-prompt-function 'epe-theme-lambda)
    (when (featurep 'nyan-prompt)
      (nyan-prompt-enable))))
#+END_SRC

*** Show form feeds as a horizontal line

#+BEGIN_SRC emacs-lisp
(use-package form-feed
  :hook
  (emacs-lisp-mode . form-feed-mode)
  (compilation-mode . form-feed-mode)
  (help-mode . form-feed-mode))
#+END_SRC

** Highlight the current line

#+BEGIN_SRC emacs-lisp
(use-package hl-line
  :config
  (when window-system
    (global-hl-line-mode)))
#+END_SRC

** GNU Globals

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/cond-enable-ggtags-mode ()
  (when (derived-mode-p 'c-mode 'c++-mode 'java-mode)
    (ggtags-mode t)))

(use-package ggtags
  :hook
  (c-mode-common . gpolonkai/cond-enable-ggtags-mode))
#+END_SRC

** Multiple cursors

Because one is never enough.

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/no-blink-matching-paren ()
  (setq blink-matching-paren nil))

(defun gpolonkai/blink-matching-paren ()
  (setq blink-matching-paren t))

(use-package multiple-cursors
  :init
  (defvar gpolonkai/mc-prefix-map (make-sparse-keymap)
    "Prefix keymap for multiple-cursors")
  (define-prefix-command 'gpolonkai/mc-prefix-map)
  (define-key global-map (kbd "C-c m") 'gpolonkai/mc-prefix-map)
  :hook
  (multiple-cursors-mode-enabled . gpolonkai/no-blink-matching-paren)
  (multiple-cursors-mode-disabled . gpolonkai/blink-matching-paren)
  :bind (:map gpolonkai/mc-prefix-map
         ("t" . mc/mark-all-like-this)
         ("m" . mc/mark-all-like-this-dwim)
         ("l" . mc/edit-lines)
         ("e" . mc/edit-ends-of-lines)
         ("a" . mc/edit-beginnings-of-lines)
         ("n" . mc/mark-next-like-this)
         ("p" . mc/mark-previous-like-this)
         ("s" . mc/mark-sgml-tag-pair)
         ("d" . mc/mark-all-like-this-in-defun)))
#+END_SRC

*** Incremental search for multiple cursors

#+BEGIN_SRC emacs-lisp
(use-package phi-search)

(use-package phi-search-mc
  :config
  (phi-search-mc/setup-keys))
#+END_SRC

*** Some extras

#+BEGIN_SRC emacs-lisp
(use-package mc-extras
  :demand
  :bind
  (:map mc/keymap
   ("C-c m =" . mc/compare-chars)))
#+END_SRC

*** Add extra cursors via ~ace-jump~

#+BEGIN_SRC emacs-lisp
(use-package ace-mc
  :bind
  (:map gpolonkai/mc-prefix-map
   ("SPC" . ace-mc-add-multiple-cursors)
   ("C-SPC" . ace-mc-add-single-cursor)))
#+END_SRC

** Magit

#+BEGIN_SRC emacs-lisp
(use-package magit
  :init
  (setq magit-auto-revert-mode nil
        magit-last-seen-setup-instructions "1.4.0"
        magit-push-always-verify nil)
  :bind
  (:map ctl-x-map
   ("g" . magit-status))
  :hook
  (git-commit-mode . turn-on-flyspell))

#+END_SRC

** Make Magit work with Git forges

#+BEGIN_SRC emacs-lisp
(use-package forge)
#+END_SRC

** Zone

#+BEGIN_SRC emacs-lisp
(use-package zone
  :demand
  :config
  (zone-when-idle 60)
  :bind
  (:map gpolonkai/pers-map
   ("zi" . gpolonkai/zone-enable)
   ("zq" . zone-leave-me-alone)))
#+END_SRC

** Origami

#+BEGIN_SRC emacs-lisp
(use-package origami
  :demand
  :config
  (define-prefix-command 'origami-mode-map)
  (define-key ctl-x-map (kbd "z") 'origami-mode-map)
  (global-origami-mode)
  :bind
  (:map origami-mode-map
   ("o" . origami-open-node)
   ("O" . origami-open-node-recursively)
   ("c" . origami-close-node)
   ("C" . origami-close-node-recursively)
   ("a" . origami-toggle-node)
   ("A" . origami-recursively-toggle-node)
   ("R" . origami-open-all-nodes)
   ("M" . origami-close-all-nodes)
   ("v" . origami-show-only-node)
   ("k" . origami-previous-fold)
   ("j" . origami-forward-fold)
   ("x" . origami-reset)))
#+END_SRC

** Smart parens

#+BEGIN_SRC emacs-lisp
(use-package smartparens
  :demand
  :config
  (show-smartparens-global-mode t)
  :hook
  (prog-mode . turn-on-smartparens-strict-mode)
  (markdown-mode . turn-on-smartparens-strict-mode)
  :bind
  (([f9] . smartparens-strict-mode)
   ("C-c s u" . sp-unwrap-sexp)
   ("C-c s k" . sp-kill-sexp)))
#+END_SRC

** Projectile

#+BEGIN_SRC emacs-lisp
(use-package projectile
  :delight '(:eval (concat " [" projectile-project-name "]"))
  :pin melpa-stable
  :config
  (projectile-mode t)
  :bind
  (:map projectile-mode-map
   ("C-c p" . projectile-command-map)))
#+END_SRC

*** Repository-based ToDo management with Org mode

#+BEGIN_SRC emacs-lisp
(use-package org-projectile)
#+END_SRC

*** …and the same with Helm

#+BEGIN_SRC emacs-lisp
(use-package org-projectile-helm)
#+END_SRC

** Text object manipulation

From the package description:

#+BEGIN_QUOTE
Text objects are textual patterns like a line, a top level definition, a word, a sentence or any
other unit of text. When objed-mode is enabled, certain editing commands (configurable) will
activate objed and enable its modal editing features.
#+END_QUOTE

#+BEGIN_SRC emacs-lisp
(use-package objed
  :demand t
  :bind
  (:map global-map
   ("M-SPC" . objed-activate)))
#+END_SRC

** Ace window

Besides its standard functionality, I also make add key bindings for burying or scrolling another
window.

#+BEGIN_SRC emacs-lisp
(use-package ace-window
  :config
  (setq aw-background nil
        aw-dispatch-always t)
  (add-to-list 'aw-dispatch-alist
               '(?s gpolonkai/scroll-window-up " Scroll window up")
               t)
  (add-to-list 'aw-dispatch-alist
               '(?S gpolonkai/scroll-window-down " Scroll window down")
               t)
  (add-to-list 'aw-dispatch-alist
               '(?q gpolonkai/bury-window " Bury (quit) window")
               t)
  :bind
  (:map ctl-x-map
   ("o" . ace-window)))
#+END_SRC

** Golden ratio

#+BEGIN_SRC emacs-lisp
(use-package golden-ratio
  :config
  (add-to-list 'golden-ratio-extra-commands 'ace-window)
  (golden-ratio-mode t))
#+END_SRC

** Avy

#+BEGIN_SRC emacs-lisp
(use-package avy
  :demand
  :config
  (avy-setup-default)
  (defadvice avy-goto-line (around avy-fci activate)
    (let ((fci-was-on (if (boundp 'fci-mode) fci-mode nil)))
      (when fci-was-on
        (fci-mode -1))
      ad-do-it
      (when fci-was-on
        (fci-mode 1))))
  :bind
  (("M-g c" . avy-goto-char)
   ("M-g C" . avy-goto-char-2)
   ("M-g f" . avy-goto-line)
   ("M-g w" . avy-goto-word-1)
   ("M-g e" . avy-goto-word-0)))
#+END_SRC

** Focus mode

It is similar to narrow mode, except the narrowing part; it dims everything outside of the current
context.

#+BEGIN_SRC emacs-lisp
(use-package focus
  :bind
  (([f8] . focus-mode)))
#+END_SRC

** Command logging mode

For occasional screen casting recordings.

#+BEGIN_SRC emacs-lisp
(use-package command-log-mode)
#+END_SRC

** Emamux

For controlling tmux from within Emacs.

#+BEGIN_SRC emacs-lisp
(use-package emamux)
#+END_SRC

** Use StackExchange sites in an Emacs window

#+BEGIN_SRC emacs-lisp
(use-package sx
  :demand
  :bind
  (:map gpolonkai/pers-map
   ("qi" . sx-inbox)
   ("qs" . sx-search)))
#+END_SRC

** Goto last change

#+BEGIN_SRC emacs-lisp
(use-package goto-last-change
  :bind
  (("M-g /" . goto-last-change)))
#+END_SRC

** Rainbow mode

To highlight colours based on their name or hex code.

#+BEGIN_SRC emacs-lisp
(use-package rainbow-mode
  :hook
  (css-mode . rainbow-mode)
  (scss-mode . rainbow-mode)
  (sass-mode . rainbow-mode))
#+END_SRC

** Zygospore

Toggle other windows for maximum focus.  When focus is no longer needed, they can be toggled back.
~C-x 1~ is conveniently bound to it.

#+BEGIN_SRC emacs-lisp
(use-package zygospore
  :bind
  (:map ctl-x-map
   ("1" . zygospore-toggle-delete-other-windows)))
#+END_SRC

** Kanban board

#+BEGIN_SRC emacs-lisp
(use-package kanban)
#+END_SRC

** Highlight dired buffer by file size, modified time, git status

#+BEGIN_SRC emacs-lisp
(use-package dired-k
  :bind
  (:map dired-mode-map
   ("K" . dired-k)))
#+END_SRC

** Show number of matches in the mode line while searching

#+BEGIN_SRC emacs-lisp
(use-package anzu
  :delight
  :config
  (global-anzu-mode 1))
#+END_SRC

** Gradually expand region

#+BEGIN_SRC emacs-lisp
(use-package expand-region
  :bind
  (:map gpolonkai/pers-map
   ("x" . er/expand-region)))
#+END_SRC

** Read and Edit MediaWiki pages in an Emacs window

#+BEGIN_SRC emacs-lisp
(use-package mediawiki
  :after
  id-manager
  :config
  (add-to-list 'mediawiki-site-alist
               '("WikEmacs"
                 "http://wikemacs.org/wiki/"
                 (gpolonkai/idm-get-id-for-account "WikEmacs")
                 (gpolonkai/idm-get-password-for-account "WikEmacs"))))
#+END_SRC

** Display unread GitHub notification count in the mode line

#+BEGIN_SRC emacs-lisp
(use-package github-notifier
  :after
  id-manager
  :config
  (setq github-notifier-token (gpolonkai/idm-get-password-for-account "GitHub"))
  (github-notifier-mode))
#+END_SRC

** Interact with GitHub gists

#+BEGIN_SRC emacs-lisp
(use-package gist)
#+END_SRC

** An Emacs Dashboard

#+BEGIN_SRC emacs-lisp
(use-package dashboard
  :after
  projectile
  :config
  (add-to-list 'dashboard-items '(projects . 5) t)
  (dashboard-setup-startup-hook))
#+END_SRC

** Hungarian holidays in the Calendar

#+BEGIN_SRC emacs-lisp
(use-package hungarian-holidays
  :config
  (hungarian-holidays-add))
#+END_SRC

** FlySpell

For all your spell-checking needs.

#+BEGIN_SRC emacs-lisp
(use-package flyspell
  :hook
  (prog-mode . flyspell-prog-mode)
  (text-mode . flyspell-mode))
#+END_SRC

** Delete all the whitespace

#+BEGIN_SRC emacs-lisp
(use-package hungry-delete
  :config
  (global-hungry-delete-mode))
#+END_SRC

** Send alerts to a notification system

#+BEGIN_SRC emacs-lisp
(use-package alert
  :config
  (setq alert-default-style
        (if (termux-p)
            (progn
              ;; TODO Remove this as soon as my PR gets merged
              ;; https://github.com/jwiegley/alert/pull/41
              (unless (fboundp 'alert-termux-notify)
                (defcustom alert-termux-command (executable-find "termux-notification")
                  "Path to the termux-notification command.
This is found in the termux-api package, and it requires the Termux
API addon app to be installed."
                  :type 'file
                  :group 'alert)

                (defun alert-termux-notify (info)
                  "Send INFO using termux-notification.
Handles :TITLE and :MESSAGE keywords from the
INFO plist."
                  (if alert-termux-command
                      (let ((args (nconc
                                   (when (plist-get info :title)
                                     (list "-t" (alert-encode-string (plist-get info :title))))
                                   (list "-c" (alert-encode-string (plist-get info :message))))))
                        (apply #'call-process alert-termux-command nil
                               (list (get-buffer-create " *termux-notification output*") t)
                               nil args))
                    (alert-message-notify info)))

                (alert-define-style 'termux :title "Notify using termux"
                                    :notifier #'alert-termux-notify))
              'termux)
          'libnotify)))
#+END_SRC

** Replace the GUI popup menu with something more efficient

#+BEGIN_SRC emacs-lisp
(use-package ace-popup-menu
  ;; Unfortunately, avy-menu (used by this package) is not compatible with minions.  I just
  ;; disable it for now.
  :disabled t
  :config
  (ace-popup-menu-mode 1))
#+END_SRC

** I’m an achiever!

#+BEGIN_SRC emacs-lisp
(use-package achievements
  :demand
  :config
  (achievements-mode 1)
  :bind
  (:map gpolonkai/pers-map
   ("C-a" . achievements-list-achievements)))
#+END_SRC

** Secretaria

Because even secretaries need a secretary today.

#+BEGIN_SRC emacs-lisp
(use-package secretaria
  :after
  alert
  :hook
  ;; use this for getting a reminder every 30 minutes of those tasks
  ;; scheduled for today and which have no time of day defined.
  (after-init . secretaria-unknown-time-always-remind-me))
#+END_SRC

** The Silver Searcher

#+BEGIN_SRC emacs-lisp
(use-package ag
  :after projectile
  :bind
  (:map projectile-mode-map
   ("C-c p C-a" . ag-project)))
#+END_SRC

** A fancier ~narrow-mode~

#+BEGIN_SRC emacs-lisp
(use-package fancy-narrow
  :config
  (fancy-narrow-mode))
#+END_SRC

** Undo tree

#+BEGIN_SRC emacs-lisp
(use-package undo-tree)
#+END_SRC

** All the icons!

Should the fonts be missing, run ~(all-the-icons-install-fonts)~.  It’s not run automatically, as it
requires connecting to a website and download a pretty large font file.

#+BEGIN_SRC emacs-lisp
(use-package all-the-icons)
#+END_SRC

** NeoTree, if Dired is not an option

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/neo-set-theme ()
  (customize-set-variable 'neo-theme (if (display-graphic-p) 'icons 'arrow)))

(use-package neotree
  :after
  all-the-icons
  :bind
  (([f5] . neotree-toggle))
  :hook
  (neo-enter . gpolonkai/neo-set-theme))
#+END_SRC

** Waka-waka

This will be replaced with something self-hosted, eventually.

#+BEGIN_SRC emacs-lisp
(use-package wakatime-mode
  :init
  (setq-default wakatime-cli-path (executable-find "wakatime"))
  :config
  (global-wakatime-mode t))
#+END_SRC

** Jump to character, word, line

#+BEGIN_SRC emacs-lisp
(use-package ace-jump-mode
  :bind
  (:map gpolonkai/pers-map
   ("SPC" . ace-jump-mode)))
#+END_SRC

** Command frequency meter

#+BEGIN_SRC emacs-lisp
(use-package keyfreq
  :demand
  :init
  (setq keyfreq-file (expand-file-name
                      "keyfreq"
                      user-emacs-directory))
  (setq keyfreq-file-lock (expand-file-name
                           "keyfreq.lock"
                           user-emacs-directory))
  :config
  (keyfreq-mode 1)
  (keyfreq-autosave-mode 1)
  :bind
  (:map gpolonkai/pers-map
   ("C-f" . keyfreq-show)))
#+END_SRC

** EditorConfig

[[http://editorconfig.org/][EditorConfig]] is a nice tool to unify, well, configuration of different editors.

#+BEGIN_SRC emacs-lisp
(use-package editorconfig
  :config
  (editorconfig-mode t))
#+END_SRC

** occur-like folding in the current buffer

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/toggle-loccur ()
  "Toggle `loccur-mode'.

If `loccur-mode' is not active, starts it (which, in turn, will ask for the
pattern to look for).  If it is active, it will disable it."
  (interactive)
  (if loccur-mode
      (loccur-mode nil)
    (call-interactively 'loccur)))

(use-package loccur
  :bind
  (:map gpolonkai/pers-map
   ("C-o" . gpolonkai/toggle-loccur)))
#+END_SRC

** More fine-tuned autosaving
:PROPERTIES:
:SOURCE:   https://www.reddit.com/r/emacs/comments/9vmljb/what_do_you_have_bound_to_mn_and_mp/e9elldc/
:END:

First, a function that turns off auto-saving for remote files.

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/dont-autosave-remote ()
  (when (and buffer-file-name (not (file-remote-p buffer-file-name)))
    (real-auto-save-mode)))
#+END_SRC

Then configure ~real-auto-save-mode~

#+BEGIN_SRC emacs-lisp
(use-package real-auto-save
  :demand t
  :hook
  (text-mode . gpolonkai/dont-autosave-remote)
  (prog-mode . gpolonkai/dont-autosave-remote))
#+END_SRC

** Help merging ~pacsave~ and ~pacnew~ files

#+BEGIN_SRC emacs-lisp
(use-package pacfiles-mode
  :commands pacfiles)
#+END_SRC

** Mailing with mu4e

#+BEGIN_SRC emacs-lisp
(use-package mu4e
  :after helm
  :ensure nil
  :config
  (require 'org-mu4e)
  (setq mu4e-contexts
        `( ,(make-mu4e-context
             :name "Private"
             :enter-func (lambda () (mu4e-message "Entering Private Context"))
             :leave-func (lambda () (mu4e-message "Leaving Private Context"))
             :match-func (lambda (msg)
                           (when msg
                             (mu4e-message-contact-field-matches msg
                               :to "gergely@polonkai.eu")))
             :vars '((user-mail-address . "gergely@polonkai.eu")
                     (mu4e-maildir . "~/.cache/mail/Polonkai")
                     (mu4e-sent-folder . "/[Gmail].Sendur p&APM-stur")
                     (mu4e-drafts-folder . "/[Gmail].Dr&APY-g")
                     (mu4e-trash-folder . "/[Gmail].Rusl")
                     (mu4e-refile-folder . "/[Gmail].Dr&APY-g")))
           ,(make-mu4e-context
             :name "GT2"
             :enter-func (lambda () (mu4e-message "Entering GT2 Context"))
             :leave-func (lambda () (mu4e-message "Leaving GT2 Context"))
             :match-func (lambda (msg)
                           (when msg
                             (or
                              (mu4e-message-contact-field-matches msg
                                :to "gergo@gt2.io")
                              (mu4e-message-contact-field-matches msg
                                                                  :to "gergo@benchmarked.games"))))
             :vars '((user-mail-address . "gergo@benchmarked.games")
                     (mu4e-maildir . "~/.cache/mail/GT2")
                     (mu4e-sent-folder . "/[Gmail].Sent Mail")
                     (mu4e-drafts-folder . "/[Gmail].Drafts")
                     (mu4e-trash-folder . "/[Gmail].Trash")
                     (mu4e-refile-folder . "/[Gmail].Drafts"))))
        org-mu4e-link-query-in-headers-mode nil)
  :custom
  (mu4e-completing-read-function 'helm-comp-read)
  (mu4e-context-policy 'pick-first)
  :bind
  (:map gpolonkai/pers-map
   ("m m" . mu4e)
   ("m i" . mu4e~headers-jump-to-maildir)
   ("m c" . mu4e-compose-new)
   ("m s" . mu4e-headers-search)))
#+END_SRC

** ViM’s ~ci~ functionality

#+BEGIN_SRC emacs-lisp
(use-package ciel
  :bind
  (:map global-map
   ("C-c i" . ciel-ci)
   ("C-c o" . ciel-co)))
#+END_SRC

** Access files in Docker containers using TRAMP

#+BEGIN_SRC emacs-lisp
(use-package docker-tramp)
#+END_SRC

** Display a line at ~fill-column~

#+BEGIN_SRC emacs-lisp
(use-package fill-column-indicator
  :hook
  (prog-mode . fci-mode))
#+END_SRC

* Make programming a bit easier

** Electric case

Insert ~snake_case~ and ~camelCase~ without using the Shift key.  It is automatically enabled in C
mode.

#+BEGIN_SRC emacs-lisp
(use-package electric-case
  :hook
  (c-mode . electric-case-c-init))
#+END_SRC

** Electric operator

Automatically add spaces around operators.

#+BEGIN_SRC emacs-lisp
(use-package electric-operator
  :config
  ;; Apply electric-operator-mode to vala-mode, too
  (apply #'electric-operator-add-rules-for-mode 'vala-mode
         (electric-operator-get-rules-for-mode 'prog-mode))
  :hook
  (c-mode-common . electric-operator-mode)
  (python-mode . electric-operator-mode))
#+END_SRC

** Yasnippets

#+BEGIN_SRC emacs-lisp
(use-package yasnippet
  :demand
  :config
  (yas-global-mode 1)
  :hook
  (post-command . sachachua/change-cursor-color-when-can-expand))
#+END_SRC

*** Extra snippets for Vala

#+BEGIN_SRC emacs-lisp
(use-package vala-snippets
  :after
  yasnippet)
#+END_SRC

*** Miscellanous extra snippets

#+BEGIN_SRC emacs-lisp
(use-package yasnippet-snippets)
#+END_SRC

** Colourful delimiters

#+BEGIN_SRC emacs-lisp
(use-package rainbow-delimiters
  :hook
  (prog-mode . rainbow-delimiters-mode))
#+END_SRC

** REST Client

#+BEGIN_SRC emacs-lisp
(use-package restclient)
#+END_SRC

** Highlight current symbol

A big help during refactoring.

#+BEGIN_SRC emacs-lisp
(use-package auto-highlight-symbol
  :config
  (global-auto-highlight-symbol-mode t))
#+END_SRC

** Make ReallyLongCamelCaseWords more readable

#+BEGIN_SRC emacs-lisp
(use-package glasses
  :delight " 👓"
  :hook
  (prog-mode . glasses-mode))
#+END_SRC

** GObject boilerplate generator

#+BEGIN_SRC emacs-lisp
(use-package gobgen)
#+END_SRC

** Insert specific licenses in the current buffer

#+BEGIN_SRC emacs-lisp
(use-package xlicense
  :bind
  (:map gpolonkai/pers-map
   ("L" . insert-license)))
#+END_SRC

** Highlight TODO, FIXME, and XXX

#+BEGIN_SRC emacs-lisp
(use-package hl-todo)
#+END_SRC

* Python related setup and ~use-package~ calls

Because, well, that’s my job now.  Of course it gets a dedicated section.

** Set up pretty symbols for Python

Because they are fancy.

- not: ¬
- in: ∈
- def: ƒ

Maybe add ∉ for ~not in~ later, if possible.

#+BEGIN_SRC emacs-lisp
(add-hook 'python-mode-hook
          (lambda ()
            (add-to-list 'prettify-symbols-alist
                         '("not" . 172))
            (add-to-list 'prettify-symbols-alist
                         '("in" . 8712))
            (add-to-list 'prettify-symbols-alist
                         '("def" . 402))))
#+END_SRC

** Automatically load the virtualenv if there is one

#+BEGIN_SRC emacs-lisp
(use-package auto-virtualenv
  :hook
  (python-mode . auto-virtualenv-set-virtualenv)
  (projectile-after-switch-project . auto-virtualenv-set-virtualenv))
#+END_SRC

** Anaconda mode

#+BEGIN_SRC emacs-lisp
(use-package anaconda-mode
  :hook
  (python-mode . anaconda-mode)
  (python-mode . anaconda-eldoc-mode))
#+END_SRC

** PipEnv

Because it’s great.

#+BEGIN_SRC emacs-lisp
(use-package pipenv
  :hook
  (python-mode . pipenv-mode)
  :init
  (setq pipenv-projectile-after-switch-function #'pipenv-projectile-after-switch-extended))
#+END_SRC

** Automatically insert Sphinx-style docstrings

#+BEGIN_SRC emacs-lisp
(use-package sphinx-doc
  :hook
  (python-mode . sphinx-doc-mode))
#+END_SRC

* C mode

Because that’s still my favourite language.

** Set up my own C style

#+BEGIN_SRC emacs-lisp
(defconst my-c-style
  '((c-tab-always-indent        . t)
    (c-comment-only-line-offset . 4)
    (c-hanging-braces-alist     . ((substatement-open after)
                                   (brace-list-open)))
    (c-hanging-colons-alist     . ((member-init-intro before)
                                   (inher-intro)
                                   (case-label after)
                                   (label after)
                                   (access-label after)))
    (c-cleanup-list             . (scope-operator
                                   empty-defun-braces
                                   defun-close-semi))
    (c-offsets-alist             . ((arglist-close . +)
                                    (arglist-intro . +)
                                    (substatement-open . 0)
                                    (case-label . 4)
                                    (block-open . 0)
                                    (knr-argdecl-intro . -)
                                    (comment-intro . 0)
                                    (member-init-intro . ++)))
    (c-echo-syntactic-information-p . t))
  "My C Programming Style.")
(c-add-style "PERSONAL" my-c-style)
#+END_SRC

** Some common initialisation for C mode

#+BEGIN_SRC emacs-lisp
(add-hook 'c-mode-common-hook
          (lambda ()
            (local-set-key (kbd "C-c o") 'ff-find-other-file)
            (c-set-style "PERSONAL")
            (setq tab-width 4
                  indent-tabs-mode nil)
            (c-toggle-auto-newline 1)))
(add-hook 'c-initialization-hook
          (lambda ()
            (define-key c-mode-base-map (kbd "C-m") 'c-context-line-break)))
#+END_SRC

** Set indentation levels to the same as the tab width

#+BEGIN_SRC emacs-lisp
(defvaralias 'c-basic-offset 'tab-width)
(defvaralias 'cperl-indent-level 'tab-width)
#+END_SRC

* Web development

** Web mode

#+BEGIN_SRC emacs-lisp
(use-package web-mode
  :mode "\\.html?\\'"
  :config
  (setq web-mode-enable-auto-indentation nil)
  (setq web-mode-enable-engine-detection t))
#+END_SRC

** Emmet mode

#+BEGIN_SRC emacs-lisp
(use-package emmet-mode
  :config
  (setq emmet-self-closing-tag-style "")
  :hook
  (web-mode . emmet-mode)
  (css-mode . emmet-mode))
#+END_SRC

** Query HTML tags by CSS selectors

#+BEGIN_SRC emacs-lisp
(use-package enlive)
#+END_SRC

* FlyCheck

#+BEGIN_SRC emacs-lisp
(use-package flycheck
  :config
  (global-flycheck-mode))
#+END_SRC

** FlyCheck for pkg-config files

#+BEGIN_SRC emacs-lisp
(use-package flycheck-pkg-config)
#+END_SRC

* Org mode

This is a big one; I use a lot of customisation here.

#+BEGIN_SRC emacs-lisp
(use-package org
  :demand
  :init
  (require 'xdg-paths)
  (defface org-checkbox-todo-text
    '((t (:inherit org-todo)))
    "Face for the text part of an unchecked org-mode checkbox.")
  (defface org-checkbox-done-text
    '((t (:inherit org-done)))
    "Face for the text part of a checked org-mode checkbox.")
  (font-lock-add-keywords
   'org-mode
   `(("^[ \t]*\\(?:[-+*]\\|[0-9]+[).]\\)[ \t]+\\(\\(?:\\[@\\(?:start:\\)?[0-9]+\\][ \t]*\\)?\\[\\(?: \\|\\([0-9]+\\)/\\2\\)\\][^\n]*\n\\)" 1 'org-checkbox-todo-text prepend))
   'append)
  (font-lock-add-keywords
   'org-mode
   `(("^[ \t]*\\(?:[-+*]\\|[0-9]+[).]\\)[ \t]+\\(\\(?:\\[@\\(?:start:\\)?[0-9]+\\][ \t]*\\)?\\[\\(?:X\\|\\([0-9]+\\)/\\2\\)\\][^\n]*\n\\)" 12 'org-checkbox-done-text prepend))
   'append)
  (setq org-directory (expand-file-name "NextCloud/orgmode" user-documents-directory))
  (setq-default org-crypt-key "B0740C4C"
                org-default-notes-file (expand-file-name "notes.org" org-directory)
                org-agenda-files `(,org-directory)
                org-ellipsis "…#"
                org-startup-folded 'content
                org-log-done 'time
                org-src-preserve-indentation t
                org-log-into-drawer t
                org-tags-column 0
                org-startup-indented t
                org-special-ctrl-a/e t
                org-return-follows-link t
                org-src-fontify-natively t
                org-time-stamp-formats '("<%Y-%m-%d>" . "<%Y-%m-%d %H:%M>")
                org-todo-keywords '((sequence "TODO(t)"
                                              "DOING(w@/!)"
                                              "BLOCKED(b@/!)"
                                              "SOMEDAY(s!)"
                                              "|"
                                              "CANCELED(c@/!)"
                                              "REVIEW(r@/!)"
                                              "DONE(d@/!)"))
                org-todo-keyword-faces '(
                                         ("SOMEDAY" . (:foreground "goldenrod"))
                                         ("CANCELED" . (:foreground "#228b22" :strike-through t)))
                org-goto-interface 'outline-path-completion
                org-goto-max-level 10
                org-html-checkbox-type 'unicode
                org-html-checkbox-types
                '((unicode (on . "<span class=\"task-done\">☑</span>")
                           (off . "<span class=\"task-todo\">☐</span>")
                           (trans . "<span class=\"task-in-progress\">▣</span>")))
                org-src-window-setup 'current-window
                org-pretty-entities t
                org-pretty-entities-include-sub-superscripts t
                org-use-speed-commands t
                org-speed-commands-user '(("m" . org-mark-subtree))
                org-hide-leading-stars t
                org-enforce-todo-dependencies t
                org-catch-invisible-edits 'show
                org-log-reschedule 'time
                org-log-redeadline 'note
                org-refile-targets '((org-agenda-files :maxlevel . 3))
                org-refile-use-outline-path 'file
                org-outline-path-complete-in-steps nil
                org-refile-allow-creating-parent-nodes 'confirm
                org-agenda-custom-commands '(("c" "Simple agenda view" ((tags "PRIORITY=\"A\""
                                                                              ((org-agenda-skip-function '(org-agenda-skip-entry-if 'todo 'done))
                                                                               (org-agenda-overriding-header "High priority unfinished tasks")))
                                                                        (agenda "")
                                                                        (alltodo ""
                                                                                 ((org-agenda-skip-function
                                                                                   '(or (air-org-skip-subtree-if-habit)
                                                                                        (air-org-skip-subtree-if-priority ?A)
                                                                                        (gpolonkai/org-skip-subtree-if-state "SOMEDAY")
                                                                                        (org-agenda-skip-if nil '(scheduled deadline))))
                                                                                  (org-agenda-overriding-header "ALL normal priority tasks"))))
                                              ((org-agenda-compact-blocks t)))))
  :config
  ;; Load the markdown exporter
  (require 'ox-md)

  ;; Make sure we have 'org-capture-templates` defined
  (unless (boundp 'org-capture-templates)
    (setq org-capture-templates nil))

  ;; Set up capture templates for blog posts and GT2 related notes
  (add-to-list 'org-capture-templates
               '("p" "Blog post" entry
                 (file+olp+datetree (lambda () (concat org-directory "blog.org")))
                 "* %^{Title}  :blog:\n   :PROPERTIES:\n   :on: %T\n   :END:\n   %i%?"))
  (add-to-list 'org-capture-templates
               '("g" "GT2 note" entry
                 (file+headline (lambda () (concat org-directory "gt2-notes.org")) "Captures")
                 "** %^{Title}\n   :PROPERTIES:\n   :on: %T\n   :END:\n   %i%?"))
  (add-to-list 'org-capture-templates
               '("c" "Item to current Clocked Task" item
                 (clock)
                 "%i%?"
                 :empty-lines 1))
  (add-to-list 'org-capture-templates
               '("K" "Kill-ring to Current Clocked Task" plain
                 (clock)
                 "%c"
                 :immediate-finish t
                 :empty-lines 1))
  (add-to-list 'org-capture-templates
               '("R" "Region to Current Clocked Task" plain
                 (clock)
                 "%i"
                 :immediate-finish t
                 :empty-lines 1))
  :hook
  (ediff-select . f-ediff-org-unfold-tree-element)
  (ediff-unselect . f-ediff-org-fold-tree)
  :bind
  (:map gpolonkai/pers-map
   ("a" . gpolonkai/org-agenda-list)
   ("C" . org-capture)
   ("l" . org-store-link)
   :map org-mode-map
   ("SPC" . org-space-key)
   ("C-c l" . org-toggle-link-display)
   ("C-a" . gpolonkai/move-to-beginning-of-line)
   ("C-e" . gpolonkai/move-to-end-of-line)
   ("C-c h" . outline-previous-heading)
   ("C-c ;" . org-toggle-timestamp-type)))
#+END_SRC

** Show a random ToDo every hour

#+BEGIN_SRC emacs-lisp
(use-package org-random-todo
  :demand
  :config
  ;; Don’t bug me too often…
  (setq org-random-todo-how-often 3600)
  :bind
  (:map gpolonkai/pers-map
   ("r" . org-random-todo)))
#+END_SRC

** Citations and cross-references for Org

#+BEGIN_SRC emacs-lisp
(use-package org-ref
  :after
  org
  :config
  (setq org-ref-bibliography-notes (concat user-documents-directory
                                           (convert-standard-filename
                                            "/orgmode/bibliography-notes"))
        org-ref-default-bibliography '((concat user-documents-directory
                                               (convert-standard-filename
                                                "/orgmode/references.bib")))
        org-ref-pdf-directory (concat user-documents-directory
                                      (convert-standard-filename
                                       "/orgmode/bibtex-pdfs"))))
#+END_SRC

And set up a function to open PDF files with the system pdf viewer, using ~xdg-open~.

An alternative could be
#+BEGIN_EXAMPLE
(setq bibtex-completion-pdf-open-function 'org-open-file))
#+END_EXAMPLE

#+BEGIN_SRC emacs-lisp
(setq bibtex-completion-pdf-open-function
  (lambda (fpath)
    (start-process "xdg-open" "*open*" "open" fpath)))
#+END_SRC

** Load CalDAV entries from NextCloud

#+BEGIN_SRC emacs-lisp
(use-package org-caldav
  :after org
  :config
  (setq
   org-caldav-url "https://cloud.polonkai.eu/remote.php/dav/calendars/gergely"
   org-caldav-calendar-id "org"
   org-caldav-inbox (expand-file-name "cloud-calendar.org" org-directory)
   org-caldav-files nil))
#+END_SRC

** Improved list management

#+BEGIN_SRC emacs-lisp
(use-package org-autolist
  :hook
  (org-mode . org-autolist-mode))
#+END_SRC

** Write messages with Org-mode

#+BEGIN_SRC emacs-lisp
(use-package org-msg
  :config
  (customize-set-variable 'org-msg-options "html-postamble:nil H:5 num:nil ^:{} toc:nil")
  (customize-set-variable 'org-msg-startup "hidestars indent inlineimages")
  (customize-set-variable 'org-msg-greeting-fmt "\nHello,\n\n")
  (customize-set-variable 'org-msg-greeting-fmt-mailto nil)
  (customize-set-variable 'org-msg-signature "

Best,

,#+begin_signature
-- *Gergely Polonkai* \\\\
,#+end_signature")
  (org-msg-mode))
#+END_SRC

** Sticky headers so i always know where i am

#+BEGIN_SRC emacs-lisp
(use-package org-sticky-header
  :config
  (customize-set-variable 'org-sticky-header-full-path 'full)
  :hook
  (org-mode . org-sticky-header-mode))
#+END_SRC

* Git & Co.

** Git status on the fringe

In graphical modes we use ~git-gutter-fringe~, and ~git-gutter~ otherwise.

#+BEGIN_SRC emacs-lisp
;; Git gutter
;; If we are in text-only mode, there is no fringe.
(let ((gitgutter-package
       (if (display-graphic-p)
           "git-gutter-fringe"
         "git-gutter")))
  (eval `(use-package ,gitgutter-package
    :demand
    :config
    (global-git-gutter-mode t)
    :bind
    (:map gpolonkai/pers-map
     ("gg" . git-gutter:update-all-windows)
     ("gn" . git-gutter:next-hunk)
     ("gp" . git-gutter:previous-hunk)))))
#+END_SRC

** Git messenger

AKA blame current line.

#+BEGIN_SRC emacs-lisp
(use-package git-messenger
  :bind
  (:map gpolonkai/pers-map
   ("gm" . git-messenger:popup-message)))
#+END_SRC

** Git time machine

See previous versions of the current file.

#+BEGIN_SRC emacs-lisp
(use-package git-timemachine
  :bind
  (([f6] . git-timemachine-toggle)))
#+END_SRC

* Company & Co.

#+BEGIN_SRC emacs-lisp
(use-package company
  :delight " 🏢"
  :config
  (setq company-idle-delay nil
        company-frontends '(company-pseudo-tooltip-frontend
                            company-echo-metadata-frontend)
        company-dabbrev-downcase nil)
  (put 'company-clang-arguments 'safe-local-variable #'nil-or-list-of-strings-p)
  (global-company-mode))
#+END_SRC

** Company completion based on local C headers

#+BEGIN_SRC emacs-lisp
(use-package company-c-headers)
#+END_SRC

** Company mode in the shell

#+BEGIN_SRC emacs-lisp
(use-package company-shell)
#+END_SRC

** REST Client completion via Company

#+BEGIN_SRC emacs-lisp
(use-package company-restclient)
#+END_SRC

** Insert Emoji with Company

#+BEGIN_SRC emacs-lisp
(use-package company-emoji
  :after
  company
  :init
  (--set-emoji-font nil)
  :config
  (add-to-list 'company-backends 'company-emoji))
#+END_SRC

** Anaconda backend for Company

#+BEGIN_SRC emacs-lisp
(use-package company-anaconda
  :after
  company
  :config
  (add-to-list 'company-backends 'company-anaconda))
#+END_SRC

** Web mode (~web-mode~ and ~emmet-mode~, too) backend for Company

#+BEGIN_SRC emacs-lisp
(use-package company-web
  :config
  (require 'company-web-html))
#+END_SRC

* Helm & Co.

** Helm

#+BEGIN_SRC emacs-lisp
(use-package helm
  :init
  (require 'helm-config)
  (setq helm-M-x-fuzzy-match t
        helm-buffers-fuzzy-matching t
        helm-recentf-fuzzy-match t)
  :config
  (helm-mode t)
  :bind
  (("M-x" . helm-M-x)
   :map ctl-x-map
   ("C-f" . helm-find-files)
   ("b" . helm-mini)
   :map helm-map
   ("/" . gpolonkai/helm-ff-slash-dir-complete)))
#+END_SRC

** Helm-style swooping

#+BEGIN_SRC emacs-lisp
(use-package helm-swoop
  :bind
  (("M-i" . helm-swoop)))
#+END_SRC

** GNU Globals with Helm

#+BEGIN_SRC emacs-lisp
(defun gpolonkai/enable-helm-gtags-mode ()
  (helm-gtags-mode t))

(use-package helm-gtags
  :init
  (setq-default helm-gtags-auto-update t
                helm-gtags-ignore-case t
                helm-gtags-path-style 'relative)
  :hook
  (c-mode . gpolonkai/enable-helm-gtags-mode)
  :bind
  (:map helm-gtags-mode-map
   ("M-t" . helm-gtags-find-tag)
   ("M-r" . helm-gtags-find-rtag)
   ("M-s" . helm-gtags-find-symbol)
   ("M-g M-p" . helm-gtags-parse-file)
   ("C-c <" . helm-gtags-previous-history)
   ("C-c >" . helm-gtags-next-history)
   ("M-," . helm-gtags-pop-stack)))
#+END_SRC

** Ag with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-ag
  :bind
  (:map gpolonkai/pers-map
   ("s" . helm-do-ag)))
#+END_SRC

** Company with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-company
  :after
  company
  helm
  :bind
  (:map company-mode-map
   ("C-c j" . helm-company)
   :map company-active-map
   ("C-c j" . helm-company)))
#+END_SRC

** Projectile with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-projectile
  :init
  (setq projectile-completion-system 'helm)
  :config
  (helm-projectile-on))
#+END_SRC

** FlyCheck with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-flycheck)
#+END_SRC

** FlySpell with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-flyspell
  :demand
  :bind
  (:map flyspell-mode-map
   ("C-M-i" . helm-flyspell-correct)))
#+END_SRC

** Search GitHub starred repos with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-github-stars
  :init
  (setq-default helm-github-stars-username "gergelypolonkai"))
#+END_SRC

** Smex with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-smex
  :bind
  (("M-S-x" . helm-smex)))
#+END_SRC

** Describe bindings with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-descbinds)
#+END_SRC

** Describe modes with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-describe-modes)
#+END_SRC

** REST Client with Helm

#+BEGIN_SRC emacs-lisp
(use-package restclient-helm)
#+END_SRC

** C Yasnippets with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-c-yasnippet
  :demand t
  :config
  (setq helm-yas-space-match-any-greedy t)
  :bind
  (("C-c y" . helm-yas-complete)))
#+END_SRC

** Git hunks with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-hunks)
#+END_SRC

** PyDoc with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-pydoc)
#+END_SRC

** BibTex with Helm

#+BEGIN_SRC emacs-lisp
(use-package helm-bibtex
  :after
  org
  :config
  (setq bibtex-completion-bibliography (concat user-documents-directory
                                               (convert-standard-filename
                                                "/orgmode/references.bib"))
        bibtex-completion-library-path (concat user-documents-directory
                                               (convert-standard-filename
                                                "/orgmode/bibtex-pdfs"))
        bibtex-completion-notes-path (concat user-documents-directory
                                             (convert-standard-filename
                                              "/orgmode/bibliography/helm-bibtex-notes"))
        bibtex-completion-pdf-open-function 'org-open-file))
#+END_SRC

* Mode specific ~use-package~ calls

** JavaScript

#+BEGIN_SRC emacs-lisp
(use-package js2-mode
  :pin melpa-stable
  :mode "\\.js\\'")
#+END_SRC

** TypeScript

#+BEGIN_SRC emacs-lisp
(use-package typescript-mode
  :mode "\\.ts\\'")
#+END_SRC

** CoffeeScript

#+BEGIN_SRC emacs-lisp
(use-package coffee-mode
  :mode "\\.coffee\\'")
#+END_SRC

** JSON

#+BEGIN_SRC emacs-lisp
(use-package json-mode
  :mode "\\.json\\'")
#+END_SRC

** YAML

#+BEGIN_SRC emacs-lisp
(use-package yaml-mode
  :mode (("\\.yml\\'" . yaml-mode)
         ("\\.yaml\\'" . yaml-mode))
  :init
  (add-to-list 'auto-mode-alist '("\\.yml\\'" . yaml-mode)))
#+END_SRC

** Markdown

#+BEGIN_SRC emacs-lisp
(use-package markdown-mode
  :mode (("\\.md\\'" . markdown-mode)
         ("\\.markdown\\'" . markdown-mode)))
#+END_SRC

** Less

#+BEGIN_SRC emacs-lisp
(use-package less-css-mode
  :mode "\\.less\\'")
#+END_SRC

** Sass

#+BEGIN_SRC emacs-lisp
(use-package sass-mode
  :mode "\\.sass\\'")
#+END_SRC

** Vala

#+BEGIN_SRC emacs-lisp
(use-package vala-mode
  :mode "\\.vala\\'")
#+END_SRC

** Dockerfile

#+BEGIN_SRC emacs-lisp
(use-package dockerfile-mode)
#+END_SRC

** ~.gitconfig~

#+BEGIN_SRC emacs-lisp
(use-package gitconfig-mode)
#+END_SRC

** ~.gitignore~

#+BEGIN_SRC emacs-lisp
(use-package gitignore-mode)
#+END_SRC

** ~po-mode~

#+BEGIN_SRC emacs-lisp
(use-package po-mode
  :ensure nil
  :mode "\\.po\\'")
#+END_SRC

** C#

#+BEGIN_SRC emacs-lisp
(use-package csharp-mode
  :mode "\\.cs\\'")
#+END_SRC

** Gherkin (BDD) feature files

#+BEGIN_SRC emacs-lisp
(use-package feature-mode
  :mode "\\.feature\\'")
#+END_SRC

** PlantUML

Before using this, make sure the latest PlantUML JAR file is downloaded into the downloads
directory.  It is available from [[http://plantuml.com/download][here]].

#+BEGIN_SRC emacs-lisp
(use-package plantuml-mode
  :init
  (setq plantuml-jar-path
        (expand-file-name
         ;; Make sure we have a download location even if XDG is not working
         (cond
          ((xdg-user-dir "DOWNLOAD")
           (concat (xdg-user-dir "DOWNLOAD") "/plantuml.jar"))
          (t
           "~/Downloads/plantuml.jar"))))
  (defvaralias 'org-plantuml-jar-path 'plantuml-jar-path)
  :config
  (org-babel-do-load-languages
   'org-babel-load-languages
   '((plantuml . t))))
#+END_SRC

** For editing CSV files

#+BEGIN_SRC emacs-lisp
(use-package csv-mode
  :mode "\\.csv\\'")
#+END_SRC

** The Go programming language

#+BEGIN_SRC emacs-lisp
(use-package go-mode
  :mode "\\.go\\'")
#+END_SRC

** Meson build system

#+BEGIN_SRC emacs-lisp
(use-package meson-mode
  :mode "\\.meson\\'")
#+END_SRC

* Games

** Gnu Go

#+BEGIN_SRC emacs-lisp
(use-package gnugo)
#+END_SRC

* Last, but not least, key bindings!

#+BEGIN_SRC emacs-lisp
(bind-keys
 :map global-map
 ("M-(" . gpolonkai/enclose-region)
 ("<C-return>" . open-line-below)
 ("<C-S-return>" . open-line-above)
 ("M-t" . nil) ;; Remove the old keybinding
 ("M-t c" . transpose-chars)
 ("M-t w" . transpose-words)
 ("M-t l" . transpose-lines)
 ("M-t e" . transpose-sexps)
 ("M-t s" . transpose-sentences)
 ("M-t p" . transpose-paragraphs)
 ("M-t W" . transpose-windows)
 ("C-a" . gpolonkai/move-to-beginning-of-line)
 ("C-e" . gpolonkai/move-to-end-of-line)
 ("M-q" . sachachua/fill-or-unfill-paragraph)
 ("C-c r" . round-number-at-point-to-decimals)
 ("C-s" . isearch-forward-regexp)
 ("C-r" . isearch-backward-regexp)
 ("C-M-s" . isearch-forward)
 ("C-M-r" . isearch-backward)
 ("C-~" . toggle-char-case)
 :map ctl-x-map
 ("C-y" . gpolonkai/duplicate-line)
 ("_" . maximize-window)
 ("C-r" . rename-current-buffer-file)
 ("C-d" . delete-current-buffer-file)
 ("|" . toggle-window-split)
 ("k" . kill-this-buffer)
 ("M-k" . gpolonkai/undo-buffer-kill)
 ("C-b" . bury-buffer)
 ("/" . repeat)
 :map isearch-mode-map
 ("<C-return>" . isearch-exit-other-end)
 ("<S-return>" . isearch-exit-mark-match)
 :map gpolonkai/pers-map
 ("h" . hidden-mode-line-mode)
 ("C-i e" . "gergely@polonkai.eu")
 ("C-i w" . "http://gergely.polonkai.eu/")
 ("C-p" . package-list-packages)
 ("o i" . gpolonkai/visit-init-file)
 ("o o" . gpolonkai/visit-org-index)
 ("u" . browse-url-at-point)
 ("M-C" . clean-buffer-list)
 ("C-c" . calc)
 ("c i" . org-clock-in)
 ("c I" . org-clock-in-last)
 ("c o" . org-clock-out)
 ("c g" . org-clock-goto))
#+END_SRC

** TODO These fail to work using ~bind-keys~, but why?

#+BEGIN_SRC emacs-lisp
(define-key 'help-command (kbd "C-l") 'find-library)
(define-key 'help-command (kbd "C-f") 'find-function)
(define-key 'help-command (kbd "C-k") 'find-function-on-key)
(define-key 'help-command (kbd "C-v") 'find-variable)
#+END_SRC

* And finally, server mode

Sometimes i start an ~emacsclient~ process, like for editing a commit message or something
similar.  As my startup time is pretty long, waiting for everything to complete is undesirable.

#+BEGIN_SRC emacs-lisp
(require 'server)
(unless (server-running-p)
  (server-start))
#+END_SRC