blob: d53d67fe39d2548f2db48e701b68c7fd268a1900 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
[![License GPL 3][badge-license]](http://www.gnu.org/licenses/gpl-3.0.txt)
[![MELPA](http://melpa.org/packages/zenburn-theme-badge.svg)](http://melpa.org/#/zenburn-theme)
[![MELPA Stable](http://stable.melpa.org/packages/zenburn-theme-badge.svg)](http://stable.melpa.org/#/zenburn-theme)
[![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/bbatsov)
## About
Zenburn for Emacs is a direct port of the popular
[Zenburn](http://kippura.org/zenburnpage/) theme for vim,
developed by [Jani Nurminen](https://github.com/jnurmine). It's my personal belief (and
that of its many users I presume) that it's one of the best low
contrast color themes out there and that it is exceptionally easy on
the eyes.
This theme uses the new built-in theming support available starting
with Emacs 24.
## Installation
### Manual
Download `zenburn-theme.el` to the directory `~/.emacs.d/themes/`. Add this to your
`.emacs`:
```lisp
(add-to-list 'custom-theme-load-path "~/.emacs.d/themes/")
```
Now you can load the theme with the interactive function `load-theme` like this:
`M-x load-theme RET zenburn`
### Package.el
Zenburn is available in both [MELPA Stable](http://stable.melpa.org)
and [MELPA](http://melpa.org).
You can install `zenburn` with the following command:
`M-x package-install zenburn-theme`
To load it automatically on Emacs startup add this to your init file:
```lisp
(load-theme 'zenburn t)
```
### Emacs Prelude
Zenburn for Emacs is already bundled into
[Emacs Prelude](https://github.com/bbatsov/prelude). If you're a
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`.
### Debian and Ubuntu
Users of Debian 9 or later or Ubuntu 16.10 or later may simply
`apt-get install elpa-zenburn-theme`.
## 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
GUI version) try adding this to your `.bashrc` or `.zshrc`:
```bash
export TERM=xterm-256color
```
Source the `.bashrc` (or `.zshrc`) file and start Emacs again.
# Bugs & Improvements
Please, report any problems that you find on the projects integrated
issue tracker. If you've added some improvements and you want them
included upstream don't hesitate to send me a patch or even better - a
GitHub pull request. [These](https://github.com/bbatsov/zenburn-emacs/contributors)
contributors have done so.
You can support my work on Zenburn and [all my other projects](https://github.com/bbatsov) via [Patreon](https://www.patreon.com/bbatsov).
[badge-license]: https://img.shields.io/badge/license-GPL_3-green.svg
|