Giter Site home page Giter Site logo

rainbow-delimiters's Introduction

MELPA MELPA Stable Build Status

rainbow-delimiters

rainbow-delimiters is a "rainbow parentheses"-like mode which highlights delimiters such as parentheses, brackets or braces according to their depth. Each successive level is highlighted in a different color. This makes it easy to spot matching delimiters, orient yourself in the code, and tell which statements are at a given depth.

Great care has been taken to make this mode fast. You shouldn't see any change in scrolling or editing speed when it's on even when working in delimiter-rich languages like Clojure or Emacs Lisp. It can be used with any language.

You can customize the colors rainbow-delimiters uses. The default colors are intentionally subtle; they are unobtrusive enough to make the mode worth looking at even if you usually don't like rainbow parentheses modes. A number of major color themes such as Zenburn and Solarized have added their own faces for the mode.

This is the official github repository for rainbow-delimiters.

The latest release of rainbow-delimiters is always found at https://github.com/Fanael/rainbow-delimiters/tree/master

Installation

The recommended way is to use MELPA or MELPA Stable. If either is in your package-archives, do

M-x package-install RET rainbow-delimiters RET

Otherwise, open rainbow-delimiters.el in Emacs and use

M-x package-install-from-buffer

Any other methods of installation are unsupported.

Usage

To toggle the mode in the current buffer:

M-x rainbow-delimiters-mode

To start the mode automatically in foo-mode, add the following to your init file:

(add-hook 'foo-mode-hook #'rainbow-delimiters-mode)

To start the mode automatically in most programming modes (Emacs 24 and above):

(add-hook 'prog-mode-hook #'rainbow-delimiters-mode)

Global mode

There's no global-rainbow-delimiters-mode anymore. It used to exist, but it was impossible to keep it from breaking some major modes. It's strongly recommended to use major mode hooks instead, as shown above. There's nothing stopping you from defining global-rainbow-delimiters-mode yourself, but if it breaks something, you're on your own.

Customization

To customize various options, including the color theme:

M-x customize-group rainbow-delimiters

You can specify custom colors by customizing following faces:

  • Faces take the form rainbow-delimiters-depth-N-face, with N being the depth. Depth begins at 1, the outermost color. Faces exist for depths 1-9.
  • The unmatched delimiter face: rainbow-delimiters-unmatched-face.
  • The mismatched delimiter face: rainbow-delimiters-mismatched-face.

rainbow-delimiters's People

Contributors

fanael avatar jlr avatar purcell avatar swsnr avatar crlf0710 avatar pgrkr avatar snogge avatar sergeyklay avatar skangas avatar to1ne avatar immerrr avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.