Had to create dummy init functions at some places since the owner of a package is the last layer that defines the init function of a package. And a package can be installed only if it has an owner. |
||
---|---|---|
.. | ||
local/ivy-spacemacs-help | ||
config.el | ||
funcs.el | ||
layers.el | ||
packages.el | ||
README.org |
Ivy layer
Description
This layer enables Ivy for completion. It will replace the default completion by Helm.
These completion systems are the central control towers of Spacemacs, they are used to manage buffers, projects, search results, configuration layers, toggles and more…
Mastering your choice of completion system will make you a Spacemacs power user.
Features:
- Project wide
grep
like text search viasearch-auto
- Project wide text replacements using
counsel-imenu
- Buffer wide dynamic text search via
swiper
- Detailed configuration parameters for ivy appearance
- Intuitive
transient state
- Advanced buffer information with
ivy-rich
Install
To use this configuration layer, add it to your ~/.spacemacs
. You will need to
add ivy
to the existing dotspacemacs-configuration-layers
list in this
file.
Configuration
General
You can customize ivy with the following variables:
ivy-wrap
Whether C-n and C-p should wrap-around when at the the first or last candidate. The default value isnil
.ivy-extra-directories
Setting this tonil
hides . and .. directories from file name completion. You can still go up a directory up byDEL
. The default value is ("../", "./").ivy-use-virtual-buffers
Add bookmarks and recent files to buffer completion menu. The Spacemacs default is t.ivy-height
The height of the minibuffer. The Spacemacs default is 15.ivy-use-selectable-prompt
When non-nil, make the prompt line selectable like a candidate. The Spacemacs default value ist
.
Advanced buffer information
To display more information about buffers set the layer variable
ivy-enable-advanced-buffer-information
to t
which will enable ivy-rich
.
Note that ivy-rich
has been reported to be very slow on macOS
. This feature
is disabled by default.
(setq-default dotspacemacs-configuration-layers '(
(ivy :variables ivy-enable-advanced-buffer-information t)))
Key Bindings
If you choose ivy
as completion system, make sure to read the official manual.
In case you don't want to read everything, at least familiarise with
minibuffer key bindings.
Some useful key bindings are presented in the following table.
Key Binding | Description |
---|---|
RET |
call default action on current candidate |
M-RET |
the same as RET but doesn't close completion minibuffer |
C-M-j |
use current input immediately (this can be used to create a new file in Find File) |
tab |
complete partially |
M-o |
show the list of valid actions on current candidate (then press any of described keys to execute it) |
C-M-o |
the same as M-o but doesn't close completion minibuffer |
C-' |
use avy to quickly select completion on current page (sometimes faster than using arrows) |
<ESC> |
close minibuffer |
Transient state
Press M-SPC
anytime in Ivy to get into the transient state.
Key Binding | Description |
---|---|
j |
select next candidate |
k |
select previous candidate |
d |
call default action on candidate |
g |
the same as d but doesn't close completion minibuffer |
o |
leave transient state |