solarized README

The project's README from github.com/altercation/solarized. As one markdown file: README.md.


title: Solarized description: Precision colors for machines and people author: Ethan Schoonover tags: test, testing, test123 colors: light yellow created: 2011 Mar 15 modified: 2011 Apr 16


Solarized

Precision colors for machines and people

solarized dualmode

Solarized is a sixteen color palette (eight monotones, eight accent colors) designed for use with terminal and gui applications. It has several unique properties. I designed this colorscheme with both precise CIELAB lightness relationships and a refined set of hues based on fixed color wheel relationships. It has been tested extensively in real world use on color calibrated displays (as well as uncalibrated/intentionally miscalibrated displays) and in a variety of lighting conditions.

See the changelog for what's new in the most recent release.

solarized palette

solarized vim

Currently available in formats for (cf screenshots below):

Editors & IDEs

Terminal Emulators

Other Applications

Palettes

Don't see the application you want to use it in? Download the palettes (or pull the values from the table below) and create your own. Submit it back and I'll happily note the contribution and include it on this page. See also the Usage & Development section below for details on the specific values to be used in different contexts.

Download

Click here to download latest version

Current release is v1.0.0beta2. See the changelog for details on what's new in this release.

Fresh Code on GitHub

You can also use the following links to access application specific downloads and git repositories:

Note that through the magic of git-subtree these repositories are all kept in sync, so you can pull any of them and get the most up-to-date version.

Features

  1. Selective contrast

    On a sunny summer day I love to read a book outside. Not right in the sun; that's too bright. I'll hunt for a shady spot under a tree. The shaded paper contrasts with the crisp text nicely. If you were to actually measure the contrast between the two, you'd find it is much lower than black text on a white background (or white on black) on your display device of choice. Black text on white from a computer display is akin to reading a book in direct sunlight and tires the eye.

    solarized selective contrast

    Solarized reduces brightness contrast but, unlike many low contrast colorschemes, retains contrasting hues (based on colorwheel relations) for syntax highlighting readability.

  2. Both sides of the force

    solarized dualmode

    I often switch between dark and light modes when editing text and code. Solarized retains the same selective contrast relationships and overall feel when switching between the light and dark background modes. A lot of thought, planning and testing has gone into making both modes feel like part of a unified colorscheme.

  3. 16/5 palette modes

    solarized palettes

    Solarized works as a sixteen color palette for compatibility with common terminal based applications / emulators. In addition, it has been carefully designed to scale down to a variety of five color palettes (four base monotones plus one accent color) for use in design work such as web design. In every case it retains a strong personality but doesn't overwhelm.

  4. Precision, symmetry

    solarized symmetry

    The monotones have symmetric CIELAB lightness differences, so switching from dark to light mode retains the same perceived contrast in brightness between each value. Each mode is equally readable. The accent colors are based off specific colorwheel relations and subsequently translated to CIELAB to ensure perceptual uniformity in terms of lightness. The hues themselves, as with the monotone *a*b values, have been adjusted within a small range to achieve the most pleasing combination of colors.

    See also the Usage & Development section below for details on the specific values to be used in different contexts.

    This makes colorscheme inversion trivial. Here, for instance, is a sass (scss) snippet that inverts solarized based on the class of the html tag (e.g. <html class="dark red"> to give a dark background with red accent):

    $base03:    #002b36;
    $base02:    #073642;
    $base01:    #586e75;
    $base00:    #657b83;
    $base0:     #839496;
    $base1:     #93a1a1;
    $base2:     #eee8d5;
    $base3:     #fdf6e3;
    $yellow:    #b58900;
    $orange:    #cb4b16;
    $red:       #dc322f;
    $magenta:   #d33682;
    $violet:    #6c71c4;
    $blue:      #268bd2;
    $cyan:      #2aa198;
    $green:     #859900;
    @mixin rebase($rebase03,$rebase02,$rebase01,$rebase00,$rebase0,$rebase1,$rebase2,$rebase3)
    {
        background-color:$rebase03;
        color:$rebase0;
        * { color:$rebase0; }
        h1,h2,h3,h4,h5,h6 { color:$rebase1; border-color: $rebase0; }
        a, a:active, a:visited { color: $rebase1; }
    }
    @mixin accentize($accent) {
        a, a:active, a:visited, code.url { color: $accent; }
        h1,h2,h3,h4,h5,h6 {color:$accent}
    }
    /* light is default mode, so pair with general html definition */
    html, .light { @include rebase($base3,$base2,$base1,$base0,$base00,$base01,$base02,$base03)}
    .dark  { @include rebase($base03,$base02,$base01,$base00,$base0,$base1,$base2,$base3)}
    html * {
        color-profile: sRGB;
        rendering-intent: auto;
    }
    

    See also the full css stylesheet for this site.

Installation

Installation instructions for each version of the colorscheme are included in the subdirectory README files. Note that for Vim (and possibly for Mutt) you may want to clone the specific repository (for instance if you are using Pathogen). See the links at the top of this file.

Font Samples

Solarized has been designed to handle fonts of various weights and retain readability, from the classic Terminus to the beefy Menlo.

font samples - light font samples - dark

Clockwise from upper left: Menlo, Letter Gothic, Terminus, Andale Mono.

Preview all code samples in specific font faces by selecting a link from this list:

Screenshots

Click to view.

Mutt

mutt dark mutt light

C (Vim)

c dark c light

Haskell (Vim)

haskell dark haskell light

HTML (Vim)

html dark html light

Java (Vim)

java dark java light

Javascript (Vim)

javascript dark javascript light

Pandoc Markdown (Vim)

These screen shots show Vim running with my own Pandoc Kit Syntax.

pandoc dark pandoc light

Perl (Vim)

perl dark perl light

PHP (Vim)

php dark php light

Python (Vim)

python dark python light

Ruby (Vim)

ruby dark ruby light

Shell (Vim)

shell dark shell light

TeX (Vim)

tex dark tex light

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

Usage & Development

If you are considering developing a port for Solarized, please see also the developer notes for information about optional repository structure and readme formats.

Solarized flips between light and dark modes. In each mode, four monotones form the core values (with an optional fifth for emphasized content).

value samples - dark

value samples - light

Thus in the case of a dark background colorscheme, the normal relationship for background and body text is base03:base0 (please note that body text is not base00). Note also that in cases where the background and foreground can be specified as a pair value, text can be highlighted using a combination of base02:base1. The L*a*b lightness difference between base03:base0 and base02:base1 is identical by design, resulting in identical readability against both normal and highlighted backgrounds. An example use case is folded text in Vim which uses base02 for the background and base1 for the foreground.

The values in this example are simply inverted in the case of a light background.

solarized (altercation/solarized)

Searching Database…

这是什么?一套精心调校的配色方案:包含一个十六色调色板(八种单色、八种强调色),配有相互匹配的深色和浅色模式,专为终端、编辑器和其他图形界面应用设计。
Solarized 是一个我要运行程序,还是别的东西?不是程序——它是一组主题文件:每种受支持的编辑器或终端都有各自的配色文件,另外还提供 Photoshop、GIMP 和 Apple 取色器可直接使用的现成调色板。
我该怎么把它装到我的编辑器或终端里?每个移植版本都在自己子目录的 README 里带有安装说明;对于 Vim(和 Mutt),作者建议直接克隆仓库,比如配合 Pathogen 使用。
我的终端或编辑器需要什么特殊条件才能用吗?不需要任何额外的东西。配色值既可以开箱即用于普通的 16 色终端(附带对应的 Xterm 256 色编号),也有图形界面的主题文件,所以支持列表里的任何应用都能直接使用。
它是一个完成且稳定的正式版本吗?最新的发布版本仍标注为 beta(v1.0.0beta2),而且一些移植版本明确尚未完成——Xcode 移植版和 TextMate 深色主题都被标记为开发中。
我具体可以把它用到哪些应用上?编辑器和 IDE:Vim、Emacs、IntelliJ IDEA、NetBeans、Visual Studio、TextMate、TextWrangler/BBEdit 和 Coda。终端:iTerm2、OS X Terminal.app、Putty、Xfce terminal 和 Xresources。另外还支持 Mutt 邮件客户端。
为什么说这些颜色是“精密”的颜色?这个调色板建立在精确的 CIELAB 亮度关系之上,色相锁定在色轮上的固定位置,然后在经过校准甚至故意调歪的显示器、各种不同的光照条件下经过了大量测试。它在不同字重的字体间也能保持可读性,从 Terminus 到 Menlo 都没问题。
我用的那个应用不在列表里,还能在它上面用 Solarized 吗?可以。下载 Photoshop、GIMP 或 Apple 取色器的调色板,或者从 README 的表格里取出颜色值,自己动手做一个主题——作者希望你把它提交回去,这样项目主页上就能列出你的移植版本。
深色模式和浅色模式有什么区别?它们用的是同样十六种颜色的翻转。四种单色构成核心(可选第五种用于强调);在深色背景上,正文把 base03 和 base0 搭配使用——而不是 base00——高亮文本则使用 base02 搭配 base1。两者的 CIELAB 亮度差在设计上完全相同,所以两种模式下的可读性是一致的。
这十六种颜色具体是哪些?八种单色,从深蓝绿色的 base03(#002b36)到暖白色的 base3(#fdf6e3),再加上黄色 #b58900、橙色 #cb4b16、红色 #dc322f、品红 #d33682、紫色 #6c71c4、蓝色 #268bd2、青色 #2aa198 和绿色 #859900。README 的表格还为每种颜色列出了标准的 CIELAB、sRGB、HSB 和 Xterm 数值。
Size
33.7 MB
Stars
16K
Updated
CommitApr 02
Age
15y
Commits · 90 Days