#+TITLE: Personal DOOM Emacs Configuration #+AUTHOR: Sravan Balaji #+AUTO_TANGLE: t #+STARTUP: showeverything * Table of Contents :TOC_3:noexport: - [[#welcome][Welcome]] - [[#configuration-files][Configuration Files]] - [[#initel][init.el]] - [[#input][Input]] - [[#completion][Completion]] - [[#user-interface][User Interface]] - [[#editor][Editor]] - [[#emacs][Emacs]] - [[#terminal][Terminal]] - [[#checkers][Checkers]] - [[#tools][Tools]] - [[#os][OS]] - [[#languages][Languages]] - [[#email][Email]] - [[#apps][Apps]] - [[#config][Config]] - [[#configel][config.el]] - [[#user-configuration][User Configuration]] - [[#user-interface-1][User Interface]] - [[#org-mode][Org Mode]] - [[#markdown][Markdown]] - [[#projectile][Projectile]] - [[#prettier-formatter][Prettier Formatter]] - [[#cdlatex][CDLaTeX]] - [[#file-extension-mode-association][File Extension Mode Association]] - [[#automatically-revert-buffers-for-changed-files][Automatically Revert Buffers For Changed Files]] - [[#rainbow-mode][Rainbow Mode]] - [[#debugging][Debugging]] - [[#shell][Shell]] - [[#packagesel][packages.el]] - [[#packages][Packages]] * Welcome My personal configuration of [[https://github.com/hlissner/doom-emacs][DOOM Emacs]], written as an [[https://orgmode.org][Org Mode]] document. * Configuration Files ** init.el This file controls which Doom modules are enabled and what order they load in. Remember to run =doom sync= after modifying it! #+BEGIN_SRC emacs-lisp :tangle init.el ;;; init.el -*- lexical-binding: t; -*- #+END_SRC *NOTE* Press =SPC h d h= (or =C-h d h= for non-vim users) to access Doom's documentation. There you'll find a "Module Index" link where you'll find a comprehensive list of Doom's modules and what flags they support. *NOTE* Move your cursor over a module's name (or its flags) and press =K= (or =C-c c k= for non-vim users) to view its documentation. This works on flags as well (those symbols that start with a plus). Alternatively, press =gd= (or =C-c c d=) on a module to browse its directory (for easy access to its source code). *** Input #+BEGIN_SRC emacs-lisp :tangle init.el (doom! :input ;;bidi ; (tfel ot) thgir etirw uoy gnipleh ;;chinese ;;japanese ;;layout ; auie,ctsrnm is the superior home row #+END_SRC *** Completion #+BEGIN_SRC emacs-lisp :tangle init.el :completion company ; the ultimate code completion backend ;;helm ; the *other* search engine for love and life ;;ido ; the other *other* search engine... ;;ivy ; a search engine for love and life vertico ; the search engine of the future #+END_SRC *** User Interface #+BEGIN_SRC emacs-lisp :tangle init.el :ui ;;deft ; notational velocity for Emacs doom ; what makes DOOM look the way it does doom-dashboard ; a nifty splash screen for Emacs ;;doom-quit ; DOOM quit-message prompts when you quit Emacs ;;(emoji +unicode) ; 🙂 hl-todo ; highlight TODO/FIXME/NOTE/DEPRECATED/HACK/REVIEW ;;hydra indent-guides ; highlighted indent columns ligatures ; ligatures and symbols to make your code pretty again ;;minimap ; show a map of the code on the side modeline ; snazzy, Atom-inspired modeline, plus API nav-flash ; blink cursor line after big motions ;;neotree ; a project drawer, like NERDTree for vim ophints ; highlight the region an operation acts on (popup +defaults) ; tame sudden yet inevitable temporary windows ;;tabs ; a tab bar for Emacs treemacs ; a project drawer, like neotree but cooler ;;unicode ; extended unicode support for various languages vc-gutter ; vcs diff in the fringe vi-tilde-fringe ; fringe tildes to mark beyond EOB ;;window-select ; visually switch windows workspaces ; tab emulation, persistence & separate workspaces ;;zen ; distraction-free coding or writing #+END_SRC *** Editor #+BEGIN_SRC emacs-lisp :tangle init.el :editor (evil +everywhere) ; come to the dark side, we have cookies file-templates ; auto-snippets for empty files fold ; (nigh) universal code folding (format +onsave) ; automated prettiness ;;god ; run Emacs commands without modifier keys ;;lispy ; vim for lisp, for people who don't like vim multiple-cursors ; editing in many places at once ;;objed ; text object editing for the innocent ;;parinfer ; turn lisp into python, sort of ;;rotate-text ; cycle region at point between text candidates snippets ; my elves. They type so I don't have to word-wrap ; soft wrapping with language-aware indent #+END_SRC *** Emacs #+BEGIN_SRC emacs-lisp :tangle init.el :emacs dired ; making dired pretty [functional] electric ; smarter, keyword-based electric-indent ibuffer ; interactive buffer management undo ; persistent, smarter undo for your inevitable mistakes vc ; version-control and Emacs, sitting in a tree #+END_SRC *** Terminal #+BEGIN_SRC emacs-lisp :tangle init.el :term eshell ; the elisp shell that works everywhere ;;shell ; simple shell REPL for Emacs ;;term ; basic terminal emulator for Emacs vterm ; the best terminal emulation in Emacs #+END_SRC *** Checkers #+BEGIN_SRC emacs-lisp :tangle init.el :checkers syntax ; tasing you for every semicolon you forget (spell +flyspell +hunspell +everywhere) ; tasing you for misspelling mispelling grammar ; tasing grammar mistake every you make #+END_SRC *** Tools #+BEGIN_SRC emacs-lisp :tangle init.el :tools ;;ansible ;;biblio ; Writes a PhD for you (citation needed) (debugger +lsp) ; FIXME stepping through code, to help you add bugs ;;direnv (docker +lsp) ;;editorconfig ; let someone else argue about tabs vs spaces ein ; tame Jupyter notebooks with emacs (eval +overlay) ; run code, run (also, repls) ;;gist ; interacting with github gists lookup ; navigate your code and its documentation lsp ; M-x vscode magit ; a git porcelain for Emacs make ; run make tasks from Emacs ;;pass ; password manager for nerds pdf ; pdf enhancements ;;prodigy ; FIXME managing external services & code builders ;;rgb ; creating color strings ;;taskrunner ; taskrunner for all your projects ;;terraform ; infrastructure as code ;;tmux ; an API for interacting with tmux ;;tree-sitter ; syntax and parsing, sitting in a tree... ;;upload ; map local to remote projects via ssh/ftp #+END_SRC *** OS #+BEGIN_SRC emacs-lisp :tangle init.el :os (:if IS-MAC macos) ; improve compatibility with macOS tty ; improve the terminal Emacs experience #+END_SRC *** Languages #+BEGIN_SRC emacs-lisp :tangle init.el :lang ;;agda ; types of types of types of types... ;;beancount ; mind the GAAP (cc +lsp) ; C > C++ == 1 ;;clojure ; java with a lisp ;;common-lisp ; if you've seen one lisp, you've seen them all ;;coq ; proofs-as-programs ;;crystal ; ruby at the speed of c ;;csharp ; unity, .NET, and mono shenanigans data ; config/data formats ;;(dart +flutter) ; paint ui and not much else ;;dhall ;;elixir ; erlang done right ;;elm ; care for a cup of TEA? emacs-lisp ; drown in parentheses ;;erlang ; an elegant language for a more civilized age ;;ess ; emacs speaks statistics ;;factor ;;faust ; dsp, but you get to keep your soul ;;fortran ; in FORTRAN, GOD is REAL (unless declared INTEGER) ;;fsharp ; ML stands for Microsoft's Language ;;fstar ; (dependent) types and (monadic) effects and Z3 ;;gdscript ; the language you waited for ;;(go +lsp) ; the hipster dialect ;;(graphql +lsp) ; Give queries a REST ;;(haskell +lsp) ; a language that's lazier than I am ;;hy ; readability of scheme w/ speed of python ;;idris ; a language you can depend on (json +lsp) ; At least it ain't XML ;;(java +lsp) ; the poster child for carpal tunnel syndrome (javascript +lsp) ; all(hope(abandon(ye(who(enter(here)))))) ;;(julia +lsp) ; a better, faster MATLAB ;;kotlin ; a better, slicker Java(Script) (latex +cdlatex +lsp) ; writing papers in Emacs has never been so fun ;;lean ; for folks with too much to prove ;;ledger ; be audit you can be ;;lua ; one-based indices? one-based indices (markdown +grip) ; writing docs for people to ignore ;;nim ; python + lisp at the speed of c ;;nix ; I hereby declare "nix geht mehr!" ;;ocaml ; an objective camel (org +dragndrop +jupyter +pretty) ; organize your plain life in plain text ;;php ; perl's insecure younger brother ;;plantuml ; diagrams for confusing people more ;;purescript ; javascript, but functional (python +lsp) ; beautiful is better than ugly ;;qt ; the 'cutest' gui framework ever ;;racket ; a DSL for DSLs ;;raku ; the artist formerly known as perl6 ;;rest ; Emacs as a REST client ;;rst ; ReST in peace ;;(ruby +rails) ; 1.step {|i| p "Ruby is #{i.even? ? 'love' : 'life'}"} (rust +lsp) ; Fe2O3.unwrap().unwrap().unwrap().unwrap() ;;scala ; java, but good ;;(scheme +guile) ; a fully conniving family of lisps (sh +fish +lsp) ; she sells {ba,z,fi}sh shells on the C xor ;;sml ;;solidity ; do you need a blockchain? No. ;;swift ; who asked for emoji variables? ;;terra ; Earth and Moon in alignment for performance. web ; the tubes (yaml +lsp) ; JSON, but readable ;;zig ; C, but simpler #+END_SRC *** Email #+BEGIN_SRC emacs-lisp :tangle init.el :email ;;(mu4e +org +gmail) ;;notmuch ;;(wanderlust +gmail) #+END_SRC *** Apps #+BEGIN_SRC emacs-lisp :tangle init.el :app ;;calendar ;;emms ;;everywhere ; *leave* Emacs!? You must be joking ;;irc ; how neckbeards socialize ;;(rss +org) ; emacs as an RSS reader ;;twitter ; twitter client https://twitter.com/vnought #+END_SRC *** Config #+BEGIN_SRC emacs-lisp :tangle init.el :config ;;literate (default +bindings +smartparens)) #+END_SRC ** config.el Place your private configuration here! Remember, you do not need to run =doom sync= after modifying this file! Here are some additional functions/macros that could 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. You can also try =gd= (or =C-c c d=) to jump to their definition and see how they are implemented. #+BEGIN_SRC emacs-lisp :tangle config.el ;;; $DOOMDIR/config.el -*- lexical-binding: t; -*- #+END_SRC *** User Configuration Some functionality uses this to identify you, e.g. GPG configuration, email clients, file templates and snippets. #+BEGIN_SRC emacs-lisp :tangle config.el (setq user-full-name "Sravan Balaji") #+END_SRC *** User Interface **** Fonts Doom exposes five (optional) variables for controlling fonts in Doom. Here are the three important ones: - =doom-font= - =doom-variable-pitch-font= - =doom-big-font= -- used for =doom-big-font-mode=; use this for presentations or streaming. They all accept either a font-spec, font string ("Input Mono-12"), or xlfd font string. You generally only need these two: #+BEGIN_EXAMPLE (setq doom-font (font-spec :family "monospace" :size 12 :weight 'semi-light) doom-variable-pitch-font (font-spec :family "sans" :size 13)) #+END_EXAMPLE Set regular, variable pitch, and big fonts. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-font (font-spec :family "MonaspiceNe NF" :size 14) doom-variable-pitch-font (font-spec :family "MonaspiceNe NF" :size 14) doom-big-font (font-spec :family "MonaspiceNe NF" :size 24) doom-unicode-font (font-spec :family "MonaspiceNe NF" :size 14)) #+END_SRC Enable *bold* and /italic/ text. #+BEGIN_SRC emacs-lisp :tangle config.el (after! doom-themes (setq doom-themes-enable-bold t doom-themes-enable-italic t)) #+END_SRC Make comments and keywords /italicized/. #+BEGIN_SRC emacs-lisp :tangle config.el (custom-set-faces! '(font-lock-comment-face :slant italic) '(font-lock-keyword-face :slant italic)) #+END_SRC **** Theme 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 :tangle config.el (setq doom-theme 'dracula-pro-pro) #+END_SRC **** Opacity #+BEGIN_SRC emacs-lisp :tangle config.el (doom/set-frame-opacity 95) #+END_SRC **** Line Numbers 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 :tangle config.el (setq display-line-numbers-type t) #+END_SRC **** Tab Width #+BEGIN_SRC emacs-lisp :tangle config.el (setq-default tab-width 4) #+END_SRC **** Highlight Indent Guides #+BEGIN_SRC emacs-lisp :tangle config.el (setq highlight-indent-guides-method 'fill) (setq highlight-indent-guides-responsive 'stack) (setq highlight-indent-guides-delay 0) #+END_SRC **** Modeline If non-nil, cause imenu to see ~doom-modeline~ declarations. This is done by adjusting ~lisp-imenu-generic-expression~ to include support for finding ~doom-modeline-def-*~ forms. Must be set before loading doom-modeline. #+BEGIN_SRC emacs-lisp :tangle config.el ;; (setq doom-modeline-support-imenu t) #+END_SRC How tall the mode-line should be. It's only respected in GUI. If the actual char height is larger, it respects the actual height. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-height 30) #+END_SRC How wide the mode-line bar should be. It's only respected in GUI. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-bar-width 4) #+END_SRC Whether to use hud instead of default bar. It's only respected in GUI. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-hud nil) #+END_SRC The limit of the window width. If ~window-width~ is smaller than the limit, some information won't be displayed. It can be an integer or a float number. `nil' means no limit." #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-window-width-limit 85) #+END_SRC How to detect the project root. nil means to use ~default-directory~. The project management packages have some issues on detecting project root. e.g. ~projectile~ doesn't handle symlink folders well, while ~project~ is unable to handle sub-projects. You can specify one if you encounter the issue. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-project-detection 'auto) #+END_SRC Determines the style used by ~doom-modeline-buffer-file-name~. Given ~/Projects/FOSS/emacs/lisp/comint.el auto => emacs/lisp/comint.el (in a project) or comint.el truncate-upto-project => ~/P/F/emacs/lisp/comint.el truncate-from-project => ~/Projects/FOSS/emacs/l/comint.el truncate-with-project => emacs/l/comint.el truncate-except-project => ~/P/F/emacs/l/comint.el truncate-upto-root => ~/P/F/e/lisp/comint.el truncate-all => ~/P/F/e/l/comint.el truncate-nil => ~/Projects/FOSS/emacs/lisp/comint.el relative-from-project => emacs/lisp/comint.el relative-to-project => lisp/comint.el file-name => comint.el buffer-name => comint.el<2> (uniquify buffer name) If you are experiencing the laggy issue, especially while editing remote files with tramp, please try ~file-name~ style. Please refer to https://github.com/bbatsov/projectile/issues/657. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-buffer-file-name-style 'auto) #+END_SRC Whether display icons in the mode-line. While using the server mode in GUI, should set the value explicitly. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-icon t) #+END_SRC Whether display the icon for ~major-mode~. It respects ~doom-modeline-icon~. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-major-mode-icon t) #+END_SRC Whether display the colorful icon for ~major-mode~. It respects ~all-the-icons-color-icons~. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-major-mode-color-icon t) #+END_SRC Whether display the icon for the buffer state. It respects ~doom-modeline-icon~. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-buffer-state-icon t) #+END_SRC Whether display the modification icon for the buffer. It respects ~doom-modeline-icon~ and ~doom-modeline-buffer-state-icon~. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-buffer-modification-icon t) #+END_SRC Whether to use unicode as a fallback (instead of ASCII) when not using icons. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-unicode-fallback nil) #+END_SRC Whether display the buffer name. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-buffer-name t) #+END_SRC Whether display the minor modes in the mode-line. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-minor-modes nil) #+END_SRC If non-nil, a word count will be added to the selection-info modeline segment. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-enable-word-count t) #+END_SRC Major modes in which to display word count continuously. Also applies to any derived modes. Respects ~doom-modeline-enable-word-count~. If it brings the sluggish issue, disable ~doom-modeline-enable-word-count~ or remove the modes from ~doom-modeline-continuous-word-count-modes~. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-continuous-word-count-modes '(markdown-mode gfm-mode org-mode)) #+END_SRC Whether display the buffer encoding. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-buffer-encoding t) #+END_SRC Whether display the indentation information. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-indent-info t) #+END_SRC If non-nil, only display one number for checker information if applicable. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-checker-simple-format t) #+END_SRC The maximum number displayed for notifications. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-number-limit 99) #+END_SRC The maximum displayed length of the branch name of version control. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-vcs-max-length 12) #+END_SRC Whether display the workspace name. Non-nil to display in the mode-line. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-workspace-name t) #+END_SRC Whether display the perspective name. Non-nil to display in the mode-line. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-persp-name t) #+END_SRC If non nil the default perspective name is displayed in the mode-line. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-display-default-persp-name nil) #+END_SRC If non nil the perspective name is displayed alongside a folder icon. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-persp-icon t) #+END_SRC Whether display the `lsp' state. Non-nil to display in the mode-line. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-lsp t) #+END_SRC Whether display the GitHub notifications. It requires ~ghub~ package. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-github nil) #+END_SRC The interval of checking GitHub. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-github-interval (* 30 60)) #+END_SRC Whether display the modal state icon. Including ~evil~, ~overwrite~, ~god~, ~ryo~ and ~xah-fly-keys~, etc. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-modal-icon t) #+END_SRC Whether display the mu4e notifications. It requires ~mu4e-alert~ package. Also enable the start of mu4e-alert. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-mu4e nil) ;; (mu4e-alert-enable-mode-line-display) #+END_SRC Whether display the gnus notifications. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-gnus t) #+END_SRC Whether gnus should automatically be updated and how often (set to 0 or smaller than 0 to disable) #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-gnus-timer 2) #+END_SRC Whether groups should be excluded when gnus automatically being updated. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-gnus-excluded-groups '("dummy.group")) #+END_SRC Whether display the IRC notifications. It requires ~circe~ or ~erc~ package. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-irc nil) #+END_SRC Function to stylize the irc buffer names. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-irc-stylize 'identity) #+END_SRC Whether display the environment version. Or for individual languages. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-env-version t) (setq doom-modeline-env-enable-python t) (setq doom-modeline-env-enable-ruby t) (setq doom-modeline-env-enable-perl t) (setq doom-modeline-env-enable-go t) (setq doom-modeline-env-enable-elixir t) (setq doom-modeline-env-enable-rust t) #+END_SRC Change the executables to use for the language version string. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-env-python-executable "python") ; or `python-shell-interpreter' (setq doom-modeline-env-ruby-executable "ruby") (setq doom-modeline-env-perl-executable "perl") (setq doom-modeline-env-go-executable "go") (setq doom-modeline-env-elixir-executable "iex") (setq doom-modeline-env-rust-executable "rustc") #+END_SRC What to display as the version while a new one is being loaded. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-env-load-string "...") #+END_SRC Hooks that run before/after the modeline version string is updated. #+BEGIN_SRC emacs-lisp :tangle config.el (setq doom-modeline-before-update-env-hook nil) (setq doom-modeline-after-update-env-hook nil) #+END_SRC *** Org Mode 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! **** Directory #+BEGIN_SRC emacs-lisp :tangle config.el (setq org-directory "~/org/") #+END_SRC **** Babel Tangle Keybinding #+BEGIN_SRC emacs-lisp :tangle config.el (map! :leader :desc "Org babel tangle" "m B" #'org-babel-tangle) #+END_SRC **** Auto Tangle #+BEGIN_SRC emacs-lisp :tangle config.el (use-package! org-auto-tangle :defer t :hook (org-mode . org-auto-tangle-mode) :config (setq org-auto-tangle-default t) ) #+END_SRC **** Source Code Indentation #+BEGIN_SRC emacs-lisp :tangle config.el (setq org-src-preserve-indentation nil org-edit-src-content-indentation 0) #+END_SRC **** Hide Emphasis Markers #+BEGIN_SRC emacs-lisp :tangle config.el (setq org-hide-emphasis-markers t) #+END_SRC **** Ellipsis #+BEGIN_SRC emacs-lisp :tangle config.el (setq org-ellipsis " ▼ ") #+END_SRC **** Fonts #+BEGIN_SRC emacs-lisp :tangle config.el (after! org-faces (defun org-colors-dracula () "Enable Dracula colors for Org headers." (interactive) (dolist (face '((org-level-1 1.7 "#8be9fd" ultra-bold) (org-level-2 1.6 "#bd93f9" extra-bold) (org-level-3 1.5 "#50fa7b" bold) (org-level-4 1.4 "#ff79c6" semi-bold) (org-level-5 1.3 "#9aedfe" normal) (org-level-6 1.2 "#caa9fa" normal) (org-level-7 1.1 "#5af78e" normal) (org-level-8 1.0 "#ff92d0" normal))) (set-face-attribute (nth 0 face) nil :font doom-variable-pitch-font :weight (nth 3 face) :height (nth 1 face) :foreground (nth 2 face))) (set-face-attribute 'org-table nil :font doom-font :weight 'normal :height 1.0 :foreground "#bfafdf")) ;; Load our desired org-colors-* theme on startup (org-colors-dracula)) #+END_SRC **** Superstar #+BEGIN_SRC emacs-lisp :tangle config.el (setq org-superstar-headline-bullets-list '("◉" "●" "○" "◆" "●" "○" "◆")) (setq org-superstar-item-bullet-alist '((?+ . ?➤) (?- . ?✦))) ; changes +/- symbols in item lists (add-hook! org-mode (org-superstar-mode)) #+END_SRC *** Markdown #+BEGIN_SRC emacs-lisp :tangle config.el (custom-set-faces '(markdown-header-face ((t (:inherit font-lock-function-name-face :weight bold :family "variable-pitch")))) '(markdown-header-face-1 ((t (:inherit markdown-header-face :height 1.8)))) '(markdown-header-face-2 ((t (:inherit markdown-header-face :height 1.4)))) '(markdown-header-face-3 ((t (:inherit markdown-header-face :height 1.2))))) #+END_SRC *** Projectile #+BEGIN_SRC emacs-lisp :tangle config.el (setq projectile-project-search-path '("~/Git/" "~/.config/" "~/.dotfiles/")) #+END_SRC *** Prettier Formatter #+BEGIN_SRC emacs-lisp :tangle config.el (add-hook! 'web-mode-hook 'prettier-js-mode) #+END_SRC *** CDLaTeX #+BEGIN_SRC emacs-lisp :tangle config.el (map! :map cdlatex-mode-map :i "TAB" #'cdlatex-tab) #+END_SRC *** File Extension Mode Association #+BEGIN_SRC emacs-lisp :tangle config.el (add-to-list 'auto-mode-alist '("\\.m\\'" . octave-mode)) #+END_SRC *** Automatically Revert Buffers For Changed Files Revert buffers when the underlying file has changed #+BEGIN_SRC emacs-lisp :tangle config.el (global-auto-revert-mode 1) (setq global-auto-revert-non-file-buffers t) #+END_SRC *** Rainbow Mode #+BEGIN_SRC emacs-lisp :tangle config.el (define-globalized-minor-mode global-rainbow-mode rainbow-mode (lambda () (rainbow-mode 1))) (global-rainbow-mode 1) #+END_SRC *** Debugging **** Keybindings #+BEGIN_SRC emacs-lisp :tangle config.el (map! :map dap-mode-map :leader :prefix ("d" . "dap") ;; basics :desc "dap next" "n" #'dap-next :desc "dap step in" "i" #'dap-step-in :desc "dap step out" "o" #'dap-step-out :desc "dap continue" "c" #'dap-continue :desc "dap hydra" "h" #'dap-hydra :desc "dap debug restart" "r" #'dap-debug-restart :desc "dap debug" "s" #'dap-debug ;; debug :prefix ("dd" . "Debug") :desc "dap debug recent" "r" #'dap-debug-recent :desc "dap debug last" "l" #'dap-debug-last ;; eval :prefix ("de" . "Eval") :desc "eval" "e" #'dap-eval :desc "eval region" "r" #'dap-eval-region :desc "eval thing at point" "s" #'dap-eval-thing-at-point :desc "add expression" "a" #'dap-ui-expressions-add :desc "remove expression" "d" #'dap-ui-expressions-remove :prefix ("db" . "Breakpoint") :desc "dap breakpoint toggle" "b" #'dap-breakpoint-toggle :desc "dap breakpoint condition" "c" #'dap-breakpoint-condition :desc "dap breakpoint hit count" "h" #'dap-breakpoint-hit-condition :desc "dap breakpoint log message" "l" #'dap-breakpoint-log-message) #+END_SRC **** Python #+BEGIN_SRC emacs-lisp :tangle config.el (after! dap-mode (setq dap-python-debugger 'debugpy)) #+END_SRC *** Shell #+BEGIN_SRC emacs-lisp :tangle config.el (setq shell-file-name (executable-find "bash")) #+END_SRC #+BEGIN_SRC emacs-lisp :tangle config.el (setq-default vterm-shell (executable-find "fish")) (setq-default explicit-shell-file-name (executable-find "fish")) #+END_SRC ** 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: #+BEGIN_EXAMPLE (package! some-package) #+END_EXAMPLE 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/raxod502/straight.el#the-recipe-format #+BEGIN_EXAMPLE (package! another-package :recipe (:host github :repo "username/repo")) #+END_EXAMPLE 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=: #+BEGIN_EXAMPLE (package! this-package :recipe (:host github :repo "username/repo" :files ("some-file.el" "src/lisp/*.el"))) #+END_EXAMPLE If you'd like to disable a package included with Doom, you can do so here with the =:disable= property: #+BEGIN_EXAMPLE (package! builtin-package :disable t) #+END_EXAMPLE 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: #+BEGIN_EXAMPLE (package! builtin-package :recipe (:nonrecursive t)) (package! builtin-package-2 :recipe (:repo "myfork/package")) #+END_EXAMPLE 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 raxod502/straight.el#279) #+BEGIN_EXAMPLE (package! builtin-package :recipe (:branch "develop")) #+END_EXAMPLE Use =:pin= to specify a particular commit to install. #+BEGIN_EXAMPLE (package! builtin-package :pin "1a2b3c4d5e") #+END_EXAMPLE Doom's packages are pinned to a specific commit and updated from release to release. The =unpin!= macro allows you to unpin single packages... #+BEGIN_EXAMPLE (unpin! pinned-package) #+END_EXAMPLE ...or multiple packages #+BEGIN_EXAMPLE ;(unpin! pinned-package another-pinned-package) #+END_EXAMPLE ...Or *all* packages (NOT RECOMMENDED; will likely break things) #+BEGIN_EXAMPLE ;(unpin! t) #+END_EXAMPLE #+BEGIN_SRC emacs-lisp :tangle packages.el ;; -*- no-byte-compile: t; -*- ;;; $DOOMDIR/packages.el #+END_SRC *** Packages #+BEGIN_SRC emacs-lisp :tangle packages.el (package! org-auto-tangle) (package! git-modes) (package! vimrc-mode) (package! prettier-js) (package! rainbow-mode) (package! systemd) (package! pkgbuild-mode) (package! lua-mode) #+END_SRC