blob: 31b370a79ef359674a4d409ba0e4e829b842d1fc (
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
[![License GPL 3][badge-license]](http://www.gnu.org/licenses/gpl-3.0.txt)
[](http://melpa.org/#/zenburn-theme)
[](http://stable.melpa.org/#/zenburn-theme)
[](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" (it used to be new several years ago when I
created this package) built-in theming support available starting with
Emacs 24.1.
## Installation
### Manual
Download `zenburn-theme.el` to the directory `~/.emacs.d/themes/`. Add this to your
`.emacs` (or `init.el`):
```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
### Custom colors
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
(setq 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.
### Scaled headings
The theme supports scaling the font size for some headings and titles as well
as using a variable-pitch font for those. To enable this, use the following
settings before loading `zenburn-theme`:
```elisp
;; use variable-pitch fonts for some headings and titles
(setq zenburn-use-variable-pitch t)
;; scale headings in org-mode
(setq zenburn-scale-org-headlines t)
;; scale headings in outline-mode
(setq zenburn-scale-outline-headlines t)
```
The screenshot above shows the default setting with no scaled or
variable-pitch fonts. With scaled headings and variable-pitch fonts it looks
like this:
## 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 project's 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
|
