SpaceVim/docs/layers/shell.md

title
SpaceVim shell layer

SpaceVim Layers: shell

• Description
• Install
• Configuration
  • Default shell
  • Default shell position and height
• Key bindings

Description

This layer provide shell support in SpaceVim.

Install

To use this configuration layer, add SPLayer 'shell' to your custom configuration file.

Configuration

Default shell

Vim support these kinds of shell:

To define the default shell you can set the layer variable default_shell to the following variables:

• terminal
• VimShell

The default shell is quickly accessible via a the default shortcut key SPC '.

Default shell position and height

It is possible to choose where the shell should pop up by setting the variable default_position to either top, bottom, left, right, or full. Default value is top. It is also possible to set the default height in percents with the variable default_height. Default value is 30.

call SpaceVim#layers#load('shell',
        \ {
        \ 'default_position' : 'top',
        \ 'default_height' : 30,
        \ }
        \ )

Key bindings

Key Binding	Description
SPC '	Open, close or go to the default shell