spacemacs/layers/+themes/colors
2017-05-24 10:09:50 +02:00
..
img
local/nyan-mode remove ^M from nyan README.org 2017-05-22 18:35:37 +03:00
config.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
funcs.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
packages.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
README.org Colors: Corrected keybindings in documentation 2017-05-24 10:09:50 +02:00

Colors layer

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

Description

This layer colors your life with:

  • rainbow identifiers mode will colorize all identifiers (christmas tree mode :-)) with an almost unique color.
  • color-identifiers mode will colorize only identifiers recognized as variables.
  • 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.

Configuration

Colorize identifiers

To colorize some identifiers by default in programming language buffers, set the layer variables colors-colorize-identifiers to either variables or all. variables will colorize only words recognized as variables, all will colorize all the words.

  (setq-default dotspacemacs-configuration-layers '(
    (colors :variables colors-colorize-identifiers 'all)))

When using the value all the Saturation and lightness of 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).

For now saturation and lightness are not supported with the variables value.

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

Colorize Identifiers

Key Binding Description
SPC t C a colorize all identifiers in current buffer
SPC t C C-a globally colorize all identifiers and all subsequent buffers
SPC t C v colorize only variables in current buffer
SPC t C C-v globally colorize only variables and all subsequent buffers

The saturation and lightness of rainbow identifier mode's colors can be adjusted live via 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/fbd29b1b3bed08b0818b2058c4755887b96418a2/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.