1 # Context Coloring [![Build Status](https://travis-ci.org/jacksonrayhamilton/context-coloring.png?branch=master)](https://travis-ci.org/jacksonrayhamilton/context-coloring) [![Coverage Status](https://coveralls.io/repos/jacksonrayhamilton/context-coloring/badge.svg?branch=master)](https://coveralls.io/r/jacksonrayhamilton/context-coloring?branch=master)
4 <img alt="Screenshot of JavaScript code highlighted by context." src="screenshot.png" title="Screenshot">
7 Highlights code by scope. Top-level scopes are one color, second-level scopes
8 are another color, and so on. Variables retain the color of the scope in which
9 they are defined. A variable defined in an outer scope referenced by an inner
10 scope is colored the same as the outer scope.
12 By default, comments and strings are still highlighted syntactically.
16 - Light and dark customizable color schemes.
18 - Script, function and block scopes (and even `catch` block scopes).
19 - Node.js "file-level" scope detection.
21 - `defun`, `lambda`, `let`, `let*`, `cond`, `condition-case`, `defadvice`,
22 `dolist`, `quote`, `backquote` and backquote splicing.
23 - Works in `eval-expression` too.
27 Requires Emacs 24.3+. JavaScript language support requires
28 [js2-mode](https://github.com/mooz/js2-mode).
30 To install, run the command `M-x package-install RET context-coloring RET`, and
31 then add the following to your init file:
35 (add-to-list 'auto-mode-alist '("\\.js\\'" . js2-mode))
36 (add-hook 'js2-mode-hook #'context-coloring-mode)
39 (add-hook 'emacs-lisp-mode-hook #'context-coloring-mode)
42 (add-hook 'eval-expression-minibuffer-setup-hook #'context-coloring-mode) ; 24.4+
43 (add-hook 'minibuffer-setup-hook #'context-coloring-mode) ; 24.3
48 You can define your own colors by customizing faces like
49 `context-coloring-level-N-face`, where N is a number starting from 0.
51 These are the colors used in the screenshot above:
54 (custom-theme-set-faces
56 '(context-coloring-level-0-face ((t :foreground "#dcdccc")))
57 '(context-coloring-level-1-face ((t :foreground "#93e0e3")))
58 '(context-coloring-level-2-face ((t :foreground "#bfebbf")))
59 '(context-coloring-level-3-face ((t :foreground "#f0dfaf")))
60 '(context-coloring-level-4-face ((t :foreground "#dfaf8f")))
61 '(context-coloring-level-5-face ((t :foreground "#cc9393")))
62 '(context-coloring-level-6-face ((t :foreground "#dc8cc3")))
63 '(context-coloring-level-7-face ((t :foreground "#94bff3")))
64 '(context-coloring-level-8-face ((t :foreground "#9fc59f")))
65 '(context-coloring-level-9-face ((t :foreground "#d0bf8f")))
66 '(context-coloring-level-10-face ((t :foreground "#dca3a3"))))
69 [See here](https://gist.github.com/jacksonrayhamilton/6b89ca3b85182c490816) for
70 some color schemes for popular custom themes.
74 - `context-coloring-syntactic-comments` (default: `t`): If non-nil, also color
75 comments using `font-lock`.
76 - `context-coloring-syntactic-strings` (default: `t`): If non-nil, also color
77 strings using `font-lock`.
78 - `context-coloring-javascript-block-scopes` (default: `nil`): If non-nil, also
79 color block scopes in the scope hierarchy in JavaScript.
80 - `context-coloring-javascript-detect-top-level-scope` (default: `t`): If
81 non-nil, detect when to use file-level scope.