mirror of
https://github.com/doomemacs/doomemacs
synced 2025-08-19 13:43:36 -05:00
This update may potentially break your usage of add-hook! if you pass the :local or :append properties to it. This is how they used to work: (add-hook! :append 'some-mode-hook #'do-something) Thsoe properties must now follow the hooks, e.g. (add-hook! 'some-mode-hook :append #'do-something) Other changes: - Various add-hook calls have been renamed to add-hook! because I incorrectly assumed `defun` always returned its definition's symbol, when in fact, its return value is "undefined" (so sayeth the documentation). This should fix #1597. - This update adds the ability to add multiple functions to hooks without a list: (add-hook! 'some-mode-hook #'do-something #'do-something-else) - The indentation logic has been changed so that consecutive function symbols at indented at the same level as the first argument, but forms are indent like a defun. (add-hook! 'some-mode-hook #'do-something #'do-something-else) (add-hook! 'some-mode-hook (message "Hello"))
:ui doom
This module modifies Emacs' user interface.
Doom's look is loosely inspired by Atom's One Dark theme, and is largely contained in the] plugin.
- A colorscheme inspired by Atom's One Dark theme (now available in a separate plugin: doom-themes)
- A custom folded-region indicator for
hideshow - "Thin bar" fringe bitmaps for
git-gutter-fringe - File-visiting buffers are slightly brighter (powered by solaire-mode)
Table of Contents TOC
Configuration
Changing theme
Although this module uses the doom-one theme by default, doom-themes offers a number of alternatives:
- doom-one: doom-themes' flagship theme, inspired by Atom's One Dark themes
- doom-vibrant: a more vibrant version of doom-one
- doom-molokai: based on Textmate's monokai
- doom-nova: adapted from Nova
- doom-one-light: light version of doom-one
- doom-peacock: based on Peacock from daylerees' themes
- doom-tomorrow-night: by Chris Kempson
This can be changed by changing the doom-theme variable, e.g.
(setq doom-theme 'doom-molokai)
Changing fonts
core/core-ui.el has four relevant variables:
-
doom-font - the default font to use in Doom Emacs.
-
doom-big-font - the font to use when
doom-big-font-modeis enabled. -
doom-variable-font - the font to use when
variable-pitch-modeis active (or where thevariable-pitchface is used). -
doom-unicode-font - the font used to display unicode symbols. This is ignored if the
:ui unicodemodule is enabled.
(setq doom-font (font-spec :family "Fira Mono" :size 12)
doom-variable-pitch-font (font-spec :family "Fira Sans")
doom-unicode-font (font-spec :family "DejaVu Sans Mono")
doom-big-font (font-spec :family "Fira Mono" :size 19))
Troubleshooting
Strange font symbols
If you're seeing strange unicode symbols, this is likely because you don't have all-the-icons's font icon installed. You can install them with M-x all-the-icons-install-fonts.