diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..6aa7344 --- /dev/null +++ b/README.md @@ -0,0 +1,105 @@ +# ido-vertical-mode.el + +[![Build Status](https://travis-ci.org/gempesaw/ido-vertical-mode.el.svg?branch=master)](https://travis-ci.org/gempesaw/ido-vertical-mode.el) Makes ido-mode display vertically. + +![screenshot.gif](screenshot.gif) + +This mode takes care of some caveats that are otherwise ugly to store +in your init file. + +You may also be interested in +[`ido-ubiquitous`](https://github.com/DarwinAwardWinner/ido-ubiquitous) +and [`smex`](https://github.com/nonsequitur/smex). + +## Install via [MELPA Stable](http://stable.melpa.org/#/) or [marmalade](http://marmalade-repo.org) + +`M-x` `package-install` `ido-vertical-mode` + +If you use MELPA instead of MELPA Stable, there's no guarantee that +you'll get something that works; I've accidentally broken master +before and will unfortunately probably do it again :( + +## Turn it on + + (require 'ido-vertical-mode) + (ido-mode 1) + (ido-vertical-mode 1) + +Or you can use `M-x ido-vertical-mode` to toggle it. + +## Customize + +#### Count + +Show the count of candidates: + +```elisp +(setq ido-vertical-show-count t) +``` + +#### Colors + +Make it look like @abo-abo's [blog post](http://oremacs.com/2015/02/09/ido-vertical/): + +```elisp +(setq ido-use-faces t) +(set-face-attribute 'ido-vertical-first-match-face nil + :background "#e5b7c0") +(set-face-attribute 'ido-vertical-only-match-face nil + :background "#e52b50" + :foreground "white") +(set-face-attribute 'ido-vertical-match-face nil + :foreground "#b00000") +(ido-vertical-mode 1) +``` + +Make it look like the screenshot above: + +```elisp +(setq ido-use-faces t) +(set-face-attribute 'ido-vertical-first-match-face nil + :background nil + :foreground "orange") +(set-face-attribute 'ido-vertical-only-match-face nil + :background nil + :foreground nil) +(set-face-attribute 'ido-vertical-match-face nil + :foreground nil) +(ido-vertical-mode 1) +``` + +Reset the faces to their defaults: + +```elisp +(set-face-attribute 'ido-vertical-first-match-face nil + :background nil + :foreground nil) +(set-face-attribute 'ido-vertical-only-match-face nil + :background nil + :foreground nil) +(set-face-attribute 'ido-vertical-match-face nil + :background nil + :foreground nil) +(ido-vertical-mode 1) + +;; optionally +(setq ido-use-faces nil) +``` + +#### Keybindings + +Since the prospects are listed vertically, it makes sense to use +`C-n/C-p` to navigate through the options. These are added to the +`ido-completion-map` by default (and `ido-toggle-prefix`, previously +on `C-p`, is moved to `M-p`). + +You also have the option to rebind some or all of the arrow keys with +`ido-vertical-define-keys`: + + (setq ido-vertical-define-keys 'C-n-C-p-up-and-down) + +to use up and down to navigate the options, or + + (setq ido-vertical-define-keys 'C-n-C-p-up-down-left-right) + +to use left and right to move through the history/directories. |