common/home/doomemacs/config.org

394 lines
12 KiB
Org Mode
Raw Normal View History

2023-02-05 01:43:01 -08:00
#+TITLE: Doom Emacs Configuration File
Execute ~doom sync~ after modifying this file to tangle it to ~config.el~.
The following block of comments is from the default configuration.
#+begin_src emacs-lisp :tangle no
;;; $DOOMDIR/config.el -*- lexical-binding: t; -*-
;; Place your private configuration here! Remember, you do not need to run 'doom
;; sync' after modifying this file!
2023-02-05 01:43:01 -08:00
;; Whenever you reconfigure a package, make sure to wrap your config in an
;; `after!' block, otherwise Doom's defaults may override your settings. E.g.
;;
;; (after! PACKAGE
;; (setq x y))
;;
;; The exceptions to this rule:
;;
;; - Setting file/directory variables (like `org-directory')
;; - Setting variables which explicitly tell you to set them before their
;; package is loaded (see 'C-h v VARIABLE' to look up their documentation).
;; - Setting doom variables (which start with 'doom-' or '+').
;;
;; Here are some additional functions/macros that will help you configure Doom.
;;
;; - `load!' for loading external *.el files relative to this one
;; - `use-package!' for configuring packages
;; - `after!' for running code after a package has loaded
;; - `add-load-path!' for adding directories to the `load-path', relative to
;; this file. Emacs searches the `load-path' when you load packages with
;; `require' or `use-package'.
;; - `map!' for binding new keys
;;
;; To get information about any of these functions/macros, move the cursor over
;; the highlighted symbol at press 'K' (non-evil users must press 'C-c c k').
;; This will open documentation for it, including demos of how they are used.
;; Alternatively, use `C-h o' to look up a symbol (functions, variables, faces,
;; etc).
;;
;; You can also try 'gd' (or 'C-c c d') to jump to their definition and see how
;; they are implemented.
#+end_src
* User specific settings
Some functionality uses this to identify you, e.g. GPG configuration, email
clients, file templates and snippets. It is optional. This could be changed to
rely on system environment variables.
#+begin_src emacs-lisp
(setq
user-full-name "Leni Ven"
user-mail-address "leniv@stanford.edu")
#+end_src
If you use ~org~ and don't want your org files in the default location below,
change ~org-directory~. It must be set before org loads!
#+begin_src emacs-lisp
(setq org-directory "~/org/")
#+end_src
* Interface
** Key Bindings
2023-02-05 01:43:01 -08:00
Modifications to the default key bindings
2023-02-05 01:43:01 -08:00
#+begin_src emacs-lisp
(setq doom-localleader-key ",") ; Spacemacs like comma major mode
2023-01-30 21:25:46 -08:00
(map! :leader ; "SPC b 0" kills window and buffer
:desc "Kill buffer and window"
"b 0" #'kill-buffer-and-window)
2023-01-30 21:25:46 -08:00
(map! :leader ; "SPC :" executes command
:desc "Execute shell command"
"!" #'shell-command)
(map! :leader ; "SPC SPC" becomes M-x
:desc "Execute extended command (emacs M-x)"
"SPC" #'execute-extended-command)
(map! :leader ; "SPC :" becomes M-:
:desc "Evaluate expression (emacs M-:)"
":" #'eval-expression)
(after! magit
(map! :localleader
(:map git-commit-mode-map
"c" #'with-editor-finish)
(:map git-commit-mode-map
"q" #'with-editor-cancel)
))
(after! org
(map! :localleader
(:map org-mode-map
2023-02-05 01:13:53 -08:00
"X" #'org-latex-preview)
))
2023-02-05 01:43:01 -08:00
#+end_src
2023-02-05 01:43:01 -08:00
** Font settings
Doom exposes five (optional) variables for controlling fonts in Doom:
- ~doom-font~ -- the primary font to use
- ~doom-variable-pitch-font~ -- a non-monospace font (where applicable)
- ~doom-big-font~ -- used for ~doom-big-font-mode~; use this for
presentations or streaming.
- ~doom-unicode-font~ -- for unicode glyphs
- ~doom-serif-font~ -- for the ~fixed-pitch-serif~ face
See ~C-h v doom-font~ for documentation and more examples of what they
accept.
If you or Emacs can't find your font, use ~M-x describe-font~ to look them up,
~M-x eval-region~ to execute ELisp code, and ~M-x doom/reload-font~ to refresh
your font settings. If Emacs still can't find your font, it likely wasn't
installed correctly. Font issues are rarely Doom issues!
There are two ways to load a theme. Both assume the theme is installed and
available. You can either set ~doom-theme~ or manually load a theme with the
~load-theme~ function.
#+begin_src emacs-lisp
(setq
2023-01-30 21:25:46 -08:00
default-font "Source Code Pro"
default-font-size 14.0
doom-font (font-spec
:family default-font
:size default-font-size
:weight 'semi-light)
doom-variable-pitch-font (font-spec
:family default-font
:size (+ default-font-size 1.0))
doom-unicode-font (font-spec
:family default-font
:size default-font-size)
2023-02-05 01:43:01 -08:00
doom-theme 'doom-lantern)
#+end_src
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
** Splash Screen
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
#+begin_src emacs-lisp
2023-01-30 21:25:46 -08:00
(defun sun-position-banner ()
(let* (
(sunrise '(
"⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢰⡆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀"
"⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀"
"⠀⠀⠀⣤⣄⠀⠀⠀⠀⢾⡀⠀⠀⠸⠇⠀⠀⢀⡷⠀⠀⠀⠀⣠⣤⠀⠀⠀"
"⠀⠀⠀⠈⠻⣷⣄⠀⠀⠈⠁⠀⠀⣀⣀⠀⠀⠈⠁⠀⠀⣠⣾⠟⠁⠀⠀⠀"
"⠀⠀⠀⠀⠀⠈⠁⠀⠀⢀⣴⣾⣿⣿⣿⣿⣷⣦⡀⠀⠀⠈⠁⠀⠀⠀⠀⠀"
"⠀⠀⢠⣤⣀⠀⠀⠀⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⠀⠀⠀⣀⣤⡄⠀⠀"
"⠀⠀⠀⠀⠁⠀⠀⣼⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀⠀⠈⠀⠀⠀⠀"
"⢠⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⡄"
"⠈⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠉⠁"))
(longest-line (apply #'max (mapcar #'length sunrise))))
(put-text-property
(point)
(dolist (line sunrise (point))
(insert (+doom-dashboard--center
+doom-dashboard--width
(concat line (make-string (max 0 (- longest-line (length line))) 32)))
"\n"))
'face 'doom-dashboard-banner)))
(setq +doom-dashboard-ascii-banner-fn #'sun-position-banner)
2023-02-05 01:43:01 -08:00
#+end_src
* Display and Indentation Styles
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
** Line numbers
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
This determines the style of line numbers in effect. If set to ~nil~, line
numbers are disabled. For relative line numbers, set this to ~relative~.
#+begin_src emacs-lisp
(setq display-line-numbers-type 'relative)
2023-01-30 23:31:40 -08:00
(global-display-line-numbers-mode)
2023-02-05 01:43:01 -08:00
#+end_src
** Whitespace mode
2023-01-30 23:31:40 -08:00
2023-02-05 01:43:01 -08:00
#+begin_src emacs-lisp
2023-01-30 21:25:46 -08:00
(use-package! whitespace
:config
(setq
whitespace-style '(face tabs tab-mark spaces space-mark trailing newline newline-mark)
whitespace-line-column 80
whitespace-display-mappings
'(
(space-mark 32 [183] [46]) ; 32 SPACE 「 」, 183 MIDDLE DOT 「·」, 46 FULL STOP 「.」
(newline-mark 10 [172 10]) ; 10 LINE FEED, 172 Not Sign「¬」
(tab-mark 9 [10141 9] [92 9]) ; 9 TAB, 10141 Triangle-headed rightwards arrow 「➝」
))
(global-whitespace-mode +1)
)
2023-02-05 01:43:01 -08:00
#+end_src
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
** Indentation Style Hooks
#+begin_src emacs-lisp
(defun custom/common-program-hook ()
2023-01-30 21:25:46 -08:00
(setq
whitespace-style '(face spaces tabs newline trailing space-mark tab-mark newline-mark)
whitespace-line-column 80)
(display-fill-column-indicator-mode)
2023-01-30 21:25:46 -08:00
;;(whitespace-mode)
(setq
indent-tabs-mode t
indent-line-function 'tab-to-tab-stop
tab-width 2)
(indent-tabs-mode)
(smart-tabs-mode-enable)
)
(defun custom/common-richtext-hook ()
(setq whitespace-style '(face spaces tabs newline trailing space-mark tab-mark newline-mark))
2023-02-05 01:13:53 -08:00
(setq whitespace-line-column nil)
)
(defun custom/lisp-family-hook ()
(custom/common-program-hook)
(setq
indent-line-function 'tab-to-tab-stop
tab-width 4)
2023-01-30 21:25:46 -08:00
(indent-tabs-mode)
)
(add-hook 'text-mode-hook #'custom/common-richtext-hook)
(add-hook 'lisp-mode-hook #'custom/lisp-family-hook)
(add-hook 'lisp-data-mode-hook #'custom/lisp-family-hook)
2023-02-05 01:43:01 -08:00
#+end_src
* Package-specific Settings
2023-02-05 01:43:01 -08:00
** Smart Tabs
#+begin_src emacs-lisp
2023-01-30 21:25:46 -08:00
(use-package! smart-tabs-mode
:config
2023-02-05 01:13:53 -08:00
(print! "Configuring smart-tabs-mode")
2023-01-30 21:25:46 -08:00
(smart-tabs-insinuate
'c 'c++
'java
'javascript))
(setq-default
indent-tabs-mode t
indent-line-function 'tab-to-tab-stop
tab-width 2)
2023-02-05 01:43:01 -08:00
#+end_src
2023-02-05 01:43:01 -08:00
** Format
2023-02-05 01:43:01 -08:00
#+begin_src emacs-lisp
2023-01-30 21:45:43 -08:00
(after! format
2023-02-05 01:13:53 -08:00
(print! "Configuring (after! format ...)")
2023-01-30 21:45:43 -08:00
'(not
emacs-lisp-mode
2023-02-05 01:43:01 -08:00
sql-mode ; Broken
;; tex related modes are broken
2023-01-30 21:45:43 -08:00
tex-mode
2023-02-05 01:43:01 -08:00
latex-mode
bibtex-mode
))
2023-01-30 21:45:43 -08:00
2023-02-05 01:43:01 -08:00
#+end_src
** Spell
#+begin_src emacs-lisp
2023-02-05 01:13:53 -08:00
(after! flyspell
(print! "Configuring (after! flyspell ...)")
(setq flyspell-default-dictionary "english"))
2023-01-30 21:25:46 -08:00
2023-02-05 01:43:01 -08:00
#+end_src
** LSP
File path is removed from breadcrumb since it is provided by ~doom-modeline~ and
since it clutters the header-line.
#+begin_src emacs-lisp
2023-02-05 01:13:53 -08:00
(after! lsp-mode
(print! "Configuring (after! lsp-mode ...)")
(setq
lsp-headerline-breadcrumb-enable t
lsp-headerline-breadcrumb-enable-symbol-numbers nil
lsp-headerline-breadcrumb-segments '(symbols)
))
2023-02-05 01:43:01 -08:00
#+end_src
** LilyPond
Add the necessary hooks for LilyPond mode.
#+begin_src emacs-lisp
2023-01-30 21:25:46 -08:00
(use-package! lilypond-mode
:init
2023-02-05 01:43:01 -08:00
(print! "Initializing LilyPond-mode")
2023-01-30 21:25:46 -08:00
(add-to-list 'auto-mode-alist '("\\.ly\\'" . LilyPond-mode))
:config
2023-01-30 23:31:40 -08:00
(add-hook 'LilyPond-mode-hook #'custom/common-program-hook)
2023-01-30 21:25:46 -08:00
)
2023-02-05 01:43:01 -08:00
#+end_src
** LaTeX
The target indentation style of ~LaTeX~ is as follows:
#+begin_src tex :tangle no
\begin{enumerate}[1.]
\item Some item 1. Note that item is not indented.
Item 1 continued. 1 level of indentation.
\item
\begin{tikzpicture}[
xscale=2,yscale=3
]
\node[dot] (x) at (0,0);
\node[dot] (y) at (0,1);
\draw (x) -- (y)
\node[midway,fill=white] {$f$};
\end{tikzpicture}
\end{enumerate}
#+end_src
#+begin_src emacs-lisp
2023-01-30 21:25:46 -08:00
(after! latex
2023-02-05 01:13:53 -08:00
(print! "Configuring (after! latex ...)")
2023-01-30 21:25:46 -08:00
(add-hook 'tex-mode-hook #'custom/common-program-hook)
(add-hook 'LaTeX-mode-hook #'custom/common-program-hook)
2023-02-05 01:43:01 -08:00
(setq-default TeX-electric-sub-and-superscript nil))
#+end_src
2023-02-05 01:43:01 -08:00
* Package Loading
These packages are loaded into ~packages.el~. The following comments are provided by default.
#+begin_src emacs-lisp :tangle no
;; -*- no-byte-compile: t; -*-
;;; $DOOMDIR/packages.el
;; To install a package with Doom you must declare them here and run 'doom sync'
;; on the command line, then restart Emacs for the changes to take effect -- or
;; use 'M-x doom/reload'.
;; To install SOME-PACKAGE from MELPA, ELPA or emacsmirror:
;(package! some-package)
;; To install a package directly from a remote git repo, you must specify a
;; `:recipe'. You'll find documentation on what `:recipe' accepts here:
;; https://github.com/radian-software/straight.el#the-recipe-format
;(package! another-package
; :recipe (:host github :repo "username/repo"))
;; If the package you are trying to install does not contain a PACKAGENAME.el
;; file, or is located in a subdirectory of the repo, you'll need to specify
;; `:files' in the `:recipe':
;(package! this-package
; :recipe (:host github :repo "username/repo"
; :files ("some-file.el" "src/lisp/*.el")))
;; If you'd like to disable a package included with Doom, you can do so here
;; with the `:disable' property:
;(package! builtin-package :disable t)
;; You can override the recipe of a built in package without having to specify
;; all the properties for `:recipe'. These will inherit the rest of its recipe
;; from Doom or MELPA/ELPA/Emacsmirror:
;(package! builtin-package :recipe (:nonrecursive t))
;(package! builtin-package-2 :recipe (:repo "myfork/package"))
;; Specify a `:branch' to install a package from a particular branch or tag.
;; This is required for some packages whose default branch isn't 'master' (which
;; our package manager can't deal with; see radian-software/straight.el#279)
;(package! builtin-package :recipe (:branch "develop"))
;; Use `:pin' to specify a particular commit to install.
;(package! builtin-package :pin "1a2b3c4d5e")
;; Doom's packages are pinned to a specific commit and updated from release to
;; release. The `unpin!' macro allows you to unpin single packages...
;(unpin! pinned-package)
;; ...or multiple packages
;(unpin! pinned-package another-pinned-package)
;; ...Or *all* packages (NOT RECOMMENDED; will likely break things)
;(unpin! t)
#+end_src
#+begin_src emacs-lisp :tangle packages.el
(package! whitespace)
(package! smart-tabs-mode)
#+end_src