doomemacs/modules/ui/doom/README.org
2017-12-08 23:14:12 -05:00

2.4 KiB

: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)

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-mode is enabled.
doom-variable-font
the font to use when variable-pitch-mode is active (or where the variable-pitch face is used).
doom-unicode-font
the font used to display unicode symbols. This is ignored if the :ui unicode module 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.