search

sellout / emacs-color-theme-solarized

Emacs highlighting using Ethan Schoonover’s Solarized color scheme
http://ethanschoonover.com/solarized
MIT License
1.16k stars 202 forks source link

readme

Solarized Colorscheme for Emacs

Stolen from Ethan Schoonover es@ethanschoonover.com by Greg Pfeil greg@technomadic.org

Visit the Solarized homepage

See the Solarized homepage for screenshots, details and colorscheme versions for Vim, Mutt, popular terminal emulators and other applications.

Screenshots

solarized dark

Downloads

If you have come across this colorscheme via the Emacs-only repository on github, see the link above to the Solarized homepage or visit the main Solarized repository.

The Emacs-only repository is kept in sync with the main Solarized repository. Issues, bug reports, changelogs that are not specific to the Emacs implementation should be submitted to the main Solarized repository.

Installation & Usage

Emacs 24

  1. Add the emacs-color-theme-solarized directory to your Emacs custom-theme-load-path.
  2. Add (load-theme 'solarized t) to your Emacs init file.
  3. Reload the init file, or restart Emacs.

all versions

To switch between the light and dark variations of Solarized, set the frame’s background-mode. This can be accomplished globally using M-x customize-variable frame-background-mode or on a per-frame basis with (set-frame-parameter nil 'background-mode 'light) (or 'dark). If you're in a terminal, you must also set the terminal parameter with (set-terminal-parameter nil 'background-mode 'light) (or 'dark). Remember to call enable-theme after changing the background mode to update the state of the theme.

This allows you to have a mix of light and dark frames. I tend to use light frames in the GUI and dark frames in my terminal, so I use the following code:

(add-hook 'after-make-frame-functions
          (lambda (frame)
            (solarized-update-background-mode
             (if (display-graphic-p frame) 'light 'dark)
             (list frame))))

Similarly, you can switch between background modes with M-x solarized-toggle-background-mode.

If you use Emacs Plus, you can keep the mode in sync with the OS with

(add-hook 'ns-system-appearance-change-functions
          #'solarized-update-background-mode)

IMPORTANT NOTE FOR TERMINAL USERS:

If you are going to use Solarized in Terminal mode (i.e. not in a GUI version like Cocoa or X11 Emacs), please please please consider setting your terminal emulator's colorscheme to use the Solarized palette. The [Solarized repository] includes palettes for some popular terminal emulator as well as Xdefaults; or you can download them from the official Solarized homepage. If you use this emacs color theme without having changed your emulator's palette, you will need to configure Solarized to degrade its colorscheme to a set compatible with the terminal's default limited 256 color palette (whereas by using the terminal's 16 ANSI color values, you would see the correct, specific values for the Solarized palette).

Again, I recommend just changing your terminal colors to Solarized values either manually or via one of the many terminal schemes available for import.

Advanced Configuration

Solarized will work out of the box with just the instructions specified above but does include several variables that can be customized.

variable name            default   optional
--------------------------------------------
solarized-termcolors =   16    |   256
solarized-degrade    =   nil   |   t
solarized-bold       =   t     |   nil
solarized-underline  =   t     |   nil
solarized-italic     =   t     |   nil
solarized-contrast   =   normal|   high, low
solarized-visibility =   normal|   high, low
solarized-broken-srgb=   nil   |   t (see details for Mac behavior)
--------------------------------------------

Option Details

Code Notes

I have attempted to modularize the creation of Emacs colorschemes in this script and, while it could be refactored further, it should be a good foundation for the creation of any color scheme. By simply changing the values in the solarized-colors table in solarized-definitions.el and testing in a GUI Emacs, you can rapidly prototype new colorschemes without diving into the weeds of line-item editing each syntax highlight declaration.

The Values

L*a*b values are canonical (White D65, Reference D50), other values are matched in sRGB space.

SOLARIZED HEX     16/8 TERMCOL  XTERM/HEX   L*A*B      RGB         HSB
--------- ------- ---- -------  ----------- ---------- ----------- -----------
base03    #002b36  8/4 brblack  234 #1c1c1c 15 -12 -12   0  43  54 193 100  21
base02    #073642  0/4 black    235 #262626 20 -12 -12   7  54  66 192  90  26
base01    #586e75 10/7 brgreen  240 #585858 45 -07 -07  88 110 117 194  25  46
base00    #657b83 11/7 bryellow 241 #626262 50 -07 -07 101 123 131 195  23  51
base0     #839496 12/6 brblue   244 #808080 60 -06 -03 131 148 150 186  13  59
base1     #93a1a1 14/4 brcyan   245 #8a8a8a 65 -05 -02 147 161 161 180   9  63
base2     #eee8d5  7/7 white    254 #e4e4e4 92 -00  10 238 232 213  44  11  93
base3     #fdf6e3 15/7 brwhite  230 #ffffd7 97  00  10 253 246 227  44  10  99
yellow    #b58900  3/3 yellow   136 #af8700 60  10  65 181 137   0  45 100  71
orange    #cb4b16  9/3 brred    166 #d75f00 50  50  55 203  75  22  18  89  80
red       #dc322f  1/1 red      160 #d70000 50  65  45 220  50  47   1  79  86
magenta   #d33682  5/5 magenta  125 #af005f 50  65 -05 211  54 130 331  74  83
violet    #6c71c4 13/5 brmagenta 61 #5f5faf 50  15 -45 108 113 196 237  45  77
blue      #268bd2  4/4 blue      33 #0087ff 55 -10 -45  38 139 210 205  82  82
cyan      #2aa198  6/6 cyan      37 #00afaf 60 -35 -05  42 161 152 175  74  63
green     #859900  2/2 green     64 #5f8700 60 -20  65 133 153   0  68 100  60

Bug Reporting

Here are some things to keep in mind when submitting a bug report: