emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/ui/doom
History
Henrik Lissner 51d3b1b424
💥 revise advice naming convention (1/2) 
This is first of three big naming convention updates that have been a
long time coming. With 2.1 on the horizon, all the breaking updates will
batched together in preparation for the long haul.

In this commit, we do away with the asterix to communicate that a
function is an advice function, and we replace it with the '-a' suffix.
e.g.

  doom*shut-up -> doom-shut-up-a
  doom*recenter -> doom-recenter-a
  +evil*static-reindent -> +evil--static-reindent-a

The rationale behind this change is:

1. Elisp's own formatting/indenting tools would occasionally struggle
   with | and * (particularly pp and cl-prettyprint). They have no
   problem with / and :, fortunately.
2. External syntax highlighters (like pygmentize, discord markdown or
   github markdown) struggle with it, sometimes refusing to highlight
   code beyond these symbols.
3. * and | are less expressive than - and -- in communicating the
   intended visibility, versatility and stability of a function.
4. It complicated the regexps we must use to search for them.
5. They were arbitrary and over-complicated to begin with, decided
   on haphazardly way back when Doom was simply "my private config".

Anyhow, like how predicate functions have the -p suffix, we'll adopt the
-a suffix for advice functions, -h for hook functions and -fn for
variable functions.

Other noteable changes:
- Replaces advice-{add,remove}! macro with new def-advice!
  macro. The old pair weren't as useful. The new def-advice! saves on a
  lot of space.
- Removed "stage" assertions to make sure you were using the right
  macros in the right place. Turned out to not be necessary, we'll
  employ better checks later.
2019-07-22 02:27:45 +02:00
..
config.el 💥 revise advice naming convention (1/2) 2019-07-22 02:27:45 +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

README.org

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