summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFelix Crux <felixc@felixcrux.com>2016-02-29 20:21:04 -0500
committerFelix Crux <felixc@felixcrux.com>2016-03-16 19:23:31 -0400
commitb057fa5b2e0ad3a10d15709a3748156dd5282909 (patch)
treee525ccdc1f53bf5da3a09a3e7c5f2fa1c0eee3b5 /README.md
parent3d7463ecac9c4668a4d2ceaddea2fd43e677bfba (diff)
Add a mechanism to override a subset of the theme's colours
If a user wants to tweak the theme by changing just a few colours, they can now do so by defining new values for just that subset in the new "zenburn-override-colors-alist" variable. This improves over the previous approach of having to completely re-specify the full list of colours, which both obscures the actual overrides among the unchanged defaults, and risks breaking when new colours are added to the default theme without the user updating their definition.
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/README.md b/README.md
index a02f710..a29f669 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,27 @@ Prelude user - you're probably already using Zenburn, since it's
Prelude's default color theme. You can load Zenburn at any time by
`M-x load-theme zenburn`.
+## Customization
+
+If you'd like to tweak the theme by changing just a few colors, you can
+do so by defining new values in the `zenburn-override-colors-alist`
+variable before loading the theme.
+
+For example, to customize just the lighter background colors, you could add
+to your init file:
+
+```elisp
+(defvar zenburn-override-colors-alist
+ '(("zenburn-bg+05" . "#282828")
+ ("zenburn-bg+1" . "#2F2F2F")
+ ("zenburn-bg+2" . "#3F3F3F")
+ ("zenburn-bg+3" . "#4F4F4F")))
+(load-theme 'zenburn t)
+```
+
+To see the full list of color names you can override, consult the
+`zenburn-theme.el` source file.
+
## Ugly colors in the terminal Emacs version
If your Emacs looks considerably uglier in a terminal (compared to the