doomemacs/modules/ui/doom
Henrik Lissner 09cb4f6716
Major refactor & optimization of how modules load their packages
Now that we are loading package autoloads files (as part of the
generated doom-package-autoload-file when running make autoloads), many
:commands properties are redundant. In fact, many def-package! blocks
are redundant.

In some cases, we can do without a config.el file entirely, and can move
into the autoloads file or rely entirely on package autoloads.

Also, many settings have been moved in their module's autoloads files,
which makes them available ASAP; their use no longer depends on module
load order.

This gained me a modest ~10% boost in startup speed.
2018-05-25 00:46:16 +02:00
..
config.el Major refactor & optimization of how modules load their packages 2018-05-25 00:46:16 +02:00
packages.el Add solaire-mode 2017-06-05 12:35:51 +02:00
README.org ui/doom: update README 2017-12-08 23:14:12 -05:00

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