summaryrefslogtreecommitdiff
path: root/README.md
blob: 33804e300ca39ec36557303a1ff5509a4688e6cd (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
# About

Zenburn for Emacs is a direct port of the popular
[Zenburn](http://slinky.imukuppi.org/zenburnpage/) theme for vim,
developed by Jani Nurminen. 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's is exceptionally easy on
the eyes. 

The theme has two versions - one for Emacs 23, relying on the
`color-theme` package and another for Emacs 24 using the built-in
theming support there.

# Installation

## Emacs 23

Zenburn depends on the `color-theme` package, so you should have it
installed. In zenburn's repo you'll find a stripped down version of
color-theme (without the built-in themes), suitable for use with
zenburn. Finally put this in your `.emacs`(or `init.el`):

``` elisp
(require 'color-theme-zenburn)
(color-theme-zenburn)
```

Zenburn for Emacs is also available for installation via the
[Marmalade](http://marmalade-repo.org/) package repository. Follow the
installation instructions there to install `package.el` and
afterwards you can install the zenburn theme like this:

`M-x package-install color-theme-zenburn`

## Emacs 24

Download `zenburn-theme.el` to `~/.emacs.d/themes`. Add this to your
`.emacs`:

`(add-to-list 'custom-theme-load-path "~/.emacs.d/themes")`

Now you can load the theme with the interactive function `load-theme`.

## Emacs Prelude

Solarized for Emacs is already bundled into
[Emacs Prelude](https://github.com/bbatsov/emacs-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`.


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

# Contributors

So far - none. You could be the first. :-)