1
0
mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 06:30:03 +08:00
SpaceVim/docs/cn/layers/shell.md

71 lines
2.2 KiB
Markdown
Raw Normal View History

---
title: "SpaceVim shell 模块"
description: "这一模块为 SpaceVim 提供了终端集成特性,优化内置终端的使用体验。"
2019-10-04 14:13:51 +08:00
lang: zh
---
2018-06-23 14:37:41 +08:00
# [可用模块](../) >> shell
<!-- vim-markdown-toc GFM -->
2018-06-23 14:37:41 +08:00
- [模块描述](#模块描述)
- [启用模块](#启用模块)
- [模块配置](#模块配置)
- [设置默认 shell](#设置默认-shell)
- [设置终端打开位置及高度](#设置终端打开位置及高度)
- [快捷键](#快捷键)
<!-- vim-markdown-toc -->
2018-06-23 14:37:41 +08:00
## 模块描述
这一模块为 SpaceVim 提供了 shell 集成,根据当前 Vim/Neovim 的版本,优化自带的内置终端。
2018-06-23 14:37:41 +08:00
## 启用模块
如果需要启用该模块,需要在 SpaceVim 的配置文件内添加如下配置:
```toml
[[layers]]
name = "shell"
```
2018-06-23 14:37:41 +08:00
## 模块配置
### 设置默认 shell
SpaceVim 支持两种 shell用户在启用该模块时可以通过 `default_shell` 这一模块选项来指定默认的 shell 工具。
- terminal使用 Vim/Neovim 内置终端
- VimShell使用 VimShell 这一插件
The default shell is quickly accessible via a the default shortcut key `SPC '`.
### 设置终端打开位置及高度
在启用该模块时,可以通过 `default_position` 这一模块选项来指定终端打开的位置,
目前可以选的值为:`top`, `bottom`, `left`, `right`, `float` or `full`,默认的值为 `top`
同时,可以通过 `default_height` 这一模块选项指定终端打开的高度,默认值为 30。
```toml
[[layers]]
name = "shell"
default_position = "top"
default_height = 30
```
## 快捷键
| 快捷键 | 功能描述 |
| --------------- | ---------------------------------- |
| `SPC '` | 打开或跳至已打开的终端窗口 |
| `Ctrl-d` | 输入模式下关闭终端窗口 |
| `q` | Normal 模式下隐藏终端窗口 |
| `` Ctrl-` `` | Terminal 模式下隐藏终端窗口 |
| `Ctrl-\-Ctrl-n` | 从 Terminal 模式切换到 Normal 模式 |
| `Ctrl-Left` | 切换到左侧窗口 |
| `Ctrl-Up` | 切换到上方窗口 |
| `Ctrl-Down` | 切换到下方窗口 |
| `Ctrl-Right` | 切换到右侧窗口 |