mirror of
https://github.com/dcarrillo/prezto.git
synced 2024-12-23 00:17:59 +00:00
114 lines
3.0 KiB
Markdown
114 lines
3.0 KiB
Markdown
# Editor
|
|
|
|
Sets editor specific key bindings options and variables.
|
|
|
|
## Options
|
|
|
|
- `BEEP` beep on error in line editor.
|
|
|
|
## Variables
|
|
|
|
- `WORDCHARS` treat a given set of characters as part of a word.
|
|
|
|
## Settings
|
|
|
|
### Wordchars
|
|
|
|
To change what characters are considered part of a word, add the following to
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor' wordchars <chars>
|
|
```
|
|
|
|
Defaults to `*?_-.[]~&;!#$%^(){}<>`.
|
|
|
|
### Key bindings
|
|
|
|
To enable key bindings, add the following to _`${ZDOTDIR:-$HOME}/.zpreztorc`_,
|
|
and replace `'<bindings>'` with `'emacs'` or `'vi'`.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor' key-bindings '<bindings>'
|
|
```
|
|
|
|
### Dot Expansion
|
|
|
|
To enable the auto conversion of .... to ../.., add the following to
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor' dot-expansion 'yes'
|
|
```
|
|
|
|
### PS Context
|
|
|
|
To enable the prompt context to be set, add the following to
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor' ps-context 'yes'
|
|
```
|
|
|
|
## Theming
|
|
|
|
To indicate when the editor is in the primary keymap (emacs or viins), add
|
|
the following to your `theme_prompt_setup` function.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor:info:keymap:primary' format '>>>'
|
|
```
|
|
|
|
To indicate when the editor is in the primary keymap (emacs or viins) insert
|
|
mode, add the following to your `theme_prompt_setup` function.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor:info:keymap:primary:insert' format 'I'
|
|
```
|
|
|
|
To indicate when the editor is in the primary keymap (emacs or viins) overwrite
|
|
mode, add the following to your `theme_prompt_setup` function.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor:info:keymap:primary:overwrite' format 'O'
|
|
```
|
|
|
|
To indicate when the editor is in the alternate keymap (vicmd), add the
|
|
following to your `theme_prompt_setup` function.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor:info:keymap:alternate' format '<<<'
|
|
```
|
|
|
|
To indicate when the editor is completing, add the following to your
|
|
`theme_prompt_setup` function.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:editor:info:completing' format '...'
|
|
```
|
|
|
|
Then add `$editor_info[context]`, where context is _keymap_, _insert_, or
|
|
_overwrite_, to `$PROMPT` or `$RPROMPT`.
|
|
|
|
## Convenience Functions
|
|
|
|
### bindkey-all
|
|
|
|
Provides a function `bindkey-all` which can be useful for checking how all of
|
|
the keys are bound. Normal `bindkey` command will only list the keys bound for
|
|
one keymap, which is not as useful if you want to grep through the output. The
|
|
keymap's names go to stderr so when you grep through `bindkey-all`'s output you
|
|
will still see the headings and can tell which keymap each binding goes to.
|
|
|
|
It will also pass through arguments so you can use bindkey-all to set bindings
|
|
for all keymaps at once. If provided arguments it will _not_ print out the
|
|
names of each of the keymaps, and just run the command for each keymap.
|
|
|
|
## Authors
|
|
|
|
_The authors of this module should be contacted via the [issue tracker][1]._
|
|
|
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
|
|
[1]: https://github.com/sorin-ionescu/prezto/issues
|