spacemacs/layers/+themes/colors
Curtis Mackie edd7a501c8 Allow user to enable rainbow-identifiers-mode without making it default
Per syl20bnr's comment on PR 6192, the package should always be
installed with the colors layer, but only hooked into prog-mode when the
variable is active. Renamed the variable
colors-enable-rainbow-identifiers-by-default to clarify this, and
modified the documentation.
2016-06-03 22:24:59 -04:00
..
img
local/nyan-mode Format documenation files with doc-fmt tool 2016-04-12 23:31:38 -04:00
config.el Allow user to enable rainbow-identifiers-mode without making it default 2016-06-03 22:24:59 -04:00
packages.el Allow user to enable rainbow-identifiers-mode without making it default 2016-06-03 22:24:59 -04:00
README.org Allow user to enable rainbow-identifiers-mode without making it default 2016-06-03 22:24:59 -04:00

Colors layer

/TakeV/spacemacs/media/commit/edd7a501c8950d9defe36451964790780b2c9d66/layers/+themes/colors/img/rainbow_dash.png

Description

This layer colors your life with:

  • rainbow identifiers mode will colorize each variables and functions with an almost unique color. The keywords and the declaration of function colors are disabled in order to make the colorized variables and functions stand out.
  • rainbow mode displays strings representing colors with the color they represent as background.
  • nyan mode display a Nyan cat progress bar in the mode-line.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add colors to the existing dotspacemacs-configuration-layers list in this file.

Enable rainbow-identifiers

To enable rainbow-identifiers-mode by default, set the variable colors-enable-rainbow-identifiers-by-default to t:

  (setq-default dotspacemacs-configuration-layers '(
    (colors :variables colors-enable-rainbow-identifiers-by-default t)))

Saturation and lightness of identifiers can be set per theme by adding an entry in the variable colors-theme-identifiers-sat&light. This is an alist where the key is a theme symbol and the value is a pair (saturation lightness).

Example:

  (push '(mytheme . (50 50)) colors-theme-identifiers-sat&light)

Enable Nyan cat

To enable the package nyan-mode set the variable colors-enable-nyan-cat-progress-bar to t:

  (setq-default dotspacemacs-configuration-layers '(
    (colors :variables colors-enable-nyan-cat-progress-bar t)))

It may be handy to enable it only in a GUI, you can do it by using a quasi-quoted list:

  (setq-default dotspacemacs-configuration-layers
    =((colors :variables
              colors-enable-nyan-cat-progress-bar ,(display-graphic-p))))

Key bindings

The prefix associated with colors is C.

Rainbow Identifiers

/TakeV/spacemacs/media/commit/edd7a501c8950d9defe36451964790780b2c9d66/layers/+themes/colors/img/theme-tweaks-python.png

rainbow-identifiers mode can be toggled on and off with:

SPC t C i

Note that the toggle is local to the current buffer.

The saturation and lightness of identifier colors can be adjusted live with the transient-state:

Key Binding Description
SPC C i s initiate change saturation mini-mode
SPC C i l initiate change lightness mini-mode
+ increase the saturation or lightness
- decrease the saturation or lightness
= reset the saturation or lightness
Any other key leave the change mini-mode

Rainbow Mode

/TakeV/spacemacs/media/commit/edd7a501c8950d9defe36451964790780b2c9d66/layers/+themes/colors/img/rainbow-mode.png

rainbow-mode mode can be toggled on and off with:

SPC t C c

Nyan Mode

nyan-mode mode can be toggled on and off with:

SPC t m n

Note that the toggle is local to the current buffer.