## Colorschemes
+To change your colorscheme, press Ctrl-E in micro to bring up the command
+prompt, and type:
+```
+set colorscheme solarized
+```
+(or whichever colorscheme you choose).
+
Micro comes with a number of colorschemes by default. Here is the list:
-* simple: this is the simplest colorscheme. It uses 16 colors which are set by
- your terminal
+### 256 color
-* mc: A 16-color theme based on the look and feel of GNU Midnight Commander.
- This will look great used in conjunction with Midnight Commander.
-
-* nano: A 16-color theme loosely based on GNU nano's syntax highlighting.
-
-* monokai: this is the monokai colorscheme; you may recognize it as Sublime
+These should work and look nice in most terminals. I recommend these
+themes the most.
+
+* `monokai`: this is the monokai colorscheme; you may recognize it as Sublime
Text's default colorscheme. It requires true color to look perfect, but the
256 color approximation looks very good as well. It's also the default
colorscheme.
+* `zenburn`
+* `gruvbox`
+* `darcula`
+* `twilight`
+* `railscast`
+* `bubblegum`: a light colorscheme
-* zenburn: The 'zenburn' colorscheme and works well with 256 color terminals
-
-* solarized: this is the solarized colorscheme. You should have the solarized
- color palette in your terminal to use it.
-
-* solarized-tc: this is the solarized colorscheme for true color; just make sure
- your terminal supports true color before using it and that the MICRO_TRUECOLOR
- environment variable is set to 1 before starting micro.
-
-* atom-dark-tc: this colorscheme is based off of Atom's "dark" colorscheme. It
- requires true color to look good.
+### 16 color
-* cmc-16: A very nice 16-color theme. Written by contributor CaptainMcClellan
- (Collin Warren.) Licensed under the same license as the rest of the themes.
+These may vary widely based on the 16 colors selected for your terminal.
-* cmc-paper: Basically cmc-16, but on a white background. (Actually light grey
+* `simple`: this is the simplest colorscheme. It uses 16 colors which are set by
+ your terminal
+* `solarized`: You should have the solarized color palette in your terminal to use this colorscheme properly.
+* `cmc-16`
+* `cmc-paper`: cmc-16, but on a white background. (Actually light grey
on most ANSI (16-color) terminals)
+* `geany`: Colorscheme based on geany's default highlighting.
-* cmc-tc: A true colour variant of the cmc theme. It requires true color to
- look its best. Use cmc-16 if your terminal doesn't support true color.
-
-* codeblocks: A colorscheme based on the Code::Blocks IDE's default syntax
- highlighting.
-
-* codeblocks-paper: Same as codeblocks, but on a white background. (Actually
- light grey)
+### True color
-* github-tc: A colorscheme based on Github's syntax highlighting. Requires true
- color to look its best.
+These require terminals that support true color and require `MICRO_TRUECOLOR=1` (this is an environment variable).
-* paper-tc: A nice minimalist theme with a light background, good for editing
- documents on. Requires true color to look its best. Not to be confused with
- `-paper` suffixed themes.
-
-* geany: Colorscheme based on geany's default highlighting.
-
-* geany-alt-tc: Based on an alternate theme bundled with geany.
+* `solarized-tc`: this is the solarized colorscheme for true color.
+* `atom-dark-tc`: this colorscheme is based off of Atom's "dark" colorscheme.
+* `cmc-tc`: A true colour variant of the cmc theme. It requires true color to
+ look its best. Use cmc-16 if your terminal doesn't support true color.
+* `gruvbox-tc`: The true color version of the gruvbox colorscheme
+* `github-tc`: The true color version of the Github colorscheme
-* flamepoint-tc: A fire inspired, high intensity true color theme written by
- CaptainMcClellan. As with all the other `-tc` suffixed themes, it looks its
- best on a
+### Monochrome
-To enable one of these colorschemes just press CtrlE in micro and type
-`set colorscheme solarized`. (or whichever one you choose). You can also use
-`set colorscheme monochrome` if you'd prefer to have just the terminal's default
+You can also use `monochrome` if you'd prefer to have just the terminal's default
foreground and background colors. Note: This provides no syntax highlighting!
+### Other
+
See `help gimmickcolors` for a list of some true colour themes that are more
just for fun than for serious use. (Though feel free if you want!)
## Creating a Colorscheme
-Micro's colorschemes are also extremely simple to create. The default ones ca
+Micro's colorschemes are also extremely simple to create. The default ones can
be found
[here](https://github.com/zyedidia/micro/tree/master/runtime/colorschemes).
* identifier.var
* preproc.shebang (The #! at the beginning of a file that tells the os what
script interpreter to use)
-* symbol.brackets ({}()[] and sometimes <>)
+* symbol.brackets (`{}()[]` and sometimes `<>`)
* symbol.operator (Color operator symbols differently)
* symbol.tag (For html tags, among other things)
* type.keyword (If you want a special highlight for keywords like `private`)
Micro's builtin syntax highlighting tries very hard to be sane, sensible and
provide ample coverage of the meaningful elements of a language. Micro has
-syntax files built int for over 100 languages now. However, there may be
+syntax files built in for over 100 languages now! However, there may be
situations where you find Micro's highlighting to be insufficient or not to your
-liking. Good news is you can create syntax files (.micro extension), place them
+liking. The good news is that you can create your own syntax files, and place them
in `~/.config/micro/syntax` and Micro will use those instead.
### Filetype definition
projects / micro.git / blobdiff