1
0
mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-02-02 22:10:06 +08:00

docs(help): add windows and ui doc

This commit is contained in:
Eric Wong 2024-06-23 00:22:04 +08:00
parent 5520a11abd
commit 7efe5bc008
3 changed files with 247 additions and 53 deletions

View File

@ -1984,34 +1984,6 @@ endfunction
" `?` toggle help " `?` toggle help
" < " <
""
" @section windows-and-tabs, usage-windows-and-tabs
" @parentsection usage
" @subsection Windows related key bindings
" Window manager key bindings can only be used in normal mode.
" The default leader `[WIN]` is `s`, you can change it via `windows_leader`
" option:
" >
" [options]
" windows_leader = "s"
" <
" The following key bindings can be used to manager vim windows and tabs.
" >
" Key Bindings | Descriptions
" ------------ | --------------------------------------------------
" q | Smart buffer close
" WIN v | :split
" WIN V | Split with previous buffer
" WIN g | :vsplit
" WIN G | Vertically split with previous buffer
" WIN t | Open new tab (:tabnew)
" WIN o | Close other windows (:only)
" WIN x | Remove buffer, leave blank window
" WIN q | Remove current buffer
" WIN Q | Close current buffer (:close)
" Shift-Tab | Switch to alternate window (switch back and forth)
" <
"" ""
" @section search-and-replace, usage-search-and-replace " @section search-and-replace, usage-search-and-replace
" @parentsection usage " @parentsection usage
@ -2356,6 +2328,33 @@ endfunction
" `autoload/SpaceVim/layers/lang/java.vim`, " `autoload/SpaceVim/layers/lang/java.vim`,
" you can use `:A doc` switch to `docs/layers/lang/java.md` " you can use `:A doc` switch to `docs/layers/lang/java.md`
""
" @section Toggle UI, usage-toggle-ui
" @parentsection usage
" Some UI indicators can be toggled on and off (toggles start with t and T):
" >
" Key Bindings | Descriptions
" ----------------- | -----------------------------------------
" SPC t 8 | highlight characters past the 80th column
" SPC t a | toggle autocomplete
" SPC t f | display the fill column
" SPC t h h | toggle highlight of the current line
" SPC t h i | toggle highlight indentation levels
" SPC t h c | toggle highlight current column
" SPC t h s | toggle syntax highlighting
" SPC t i | toggle indentation guide at point
" SPC t n | toggle line numbers
" SPC t b | toggle background
" SPC t c | toggle conceal
" SPC t p | toggle paste mode
" SPC t P | toggle auto parens mode
" SPC t t | open tabs manager
" SPC T ~ | display ~ in the fringe on empty lines
" SPC T F / F11 | toggle frame fullscreen
" SPC T f | toggle display of the fringe
" SPC T m | toggle menu bar
" SPC T t | toggle tool bar
" <
"" ""
" @section Error handling, usage-error-handling " @section Error handling, usage-error-handling

View File

@ -6,6 +6,103 @@
" License: GPLv3 " License: GPLv3
"============================================================================= "=============================================================================
""
" @section windows-and-tabs, usage-windows-and-tabs
" @parentsection usage
" Window manager key bindings can only be used in normal mode.
" The default leader `[WIN]` is `s`, you can change it via `windows_leader`
" in the `[options]` section:
" >
" [options]
" windows_leader = "s"
" <
" >
" Key Bindings | Descriptions
" ------------ | --------------------------------------------------
" q | Smart buffer close
" WIN v | :split
" WIN V | Split with previous buffer
" WIN g | :vsplit
" WIN G | Vertically split with previous buffer
" WIN t | Open new tab (:tabnew)
" WIN o | Close other windows (:only)
" WIN x | Remove buffer, leave blank window
" WIN q | Remove current buffer
" WIN Q | Close current buffer (:close)
" Shift-Tab | Switch to alternate window (switch back and forth)
" <
" SpaceVim has mapped normal `q` (record a macro) as smart buffer close,
" and record a macro (vim's `q`) has been mapped to `<Leader> q r`,
" if you want to disable this feature, you can use `vimcompatible` mode.
"
" @subsection General Editor windows
" >
" Key Bindings | Descriptions
" ------------ | --------------------------------
" <F2> | Toggle tagbar
" <F3> | Toggle Vimfiler
" Ctrl-Down | Move to split below ( Ctrl-w j )
" Ctrl-Up | Move to upper split ( Ctrl-w k )
" Ctrl-Left | Move to left split ( Ctrl-w h )
" Ctrl-Right | Move to right split ( Ctrl-w l )
" <
" @subsection Window manipulation key bindings
"
" Every window has a number displayed at the start of the statusline
" and can be quickly accessed using `SPC number`.
" >
" Key Bindings | Descriptions
" ------------ | ---------------------
" SPC 1 | go to window number 1
" SPC 2 | go to window number 2
" SPC 3 | go to window number 3
" SPC 4 | go to window number 4
" SPC 5 | go to window number 5
" SPC 6 | go to window number 6
" SPC 7 | go to window number 7
" SPC 8 | go to window number 8
" SPC 9 | go to window number 9
" <
" Windows manipulation commands (start with `w`):
" >
" Key Bindings | Descriptions
" --------------------- | --------------------------------------------------
" SPC w . | windows transient state
" SPC w <Tab> | switch to alternate window in the current frame
" SPC w = | balance split windows
" SPC w c | Distraction-free reading current window
" SPC w C | Distraction-free reading other windows
" SPC w d | delete a window
" SPC w D | delete another window using vim-choosewin
" SPC w f | toggle follow mode
" SPC w F | create new tab
" SPC w h | move to window on the left
" SPC w H | move window to the left
" SPC w j | move to window below
" SPC w J | move window to the bottom
" SPC w k | move to window above
" SPC w K | move window to the top
" SPC w l | move to window on the right
" SPC w L | move window to the right
" SPC w m | maximize/minimize a window
" SPC w M | swap windows using vim-choosewin
" SPC w o | cycle and focus between tabs
" SPC w r | rotate windows forward
" SPC w R | rotate windows backward
" SPC w s / SPC w - | horizontal split
" SPC w S | horizontal split and focus new window
" SPC w u | undo window layout
" SPC w U | redo window layout
" SPC w v / SPC w / | vertical split
" SPC w V | vertical split and focus new window
" SPC w w | cycle and focus between windows
" SPC w W | select window using vim-choosewin
" SPC w x | exchange current window with next one
" <
let s:file = expand('<sfile>:~') let s:file = expand('<sfile>:~')
let s:lnum = expand('<slnum>') + 3 let s:lnum = expand('<slnum>') + 3
function! SpaceVim#mapping#leader#defindWindowsLeader(key) abort function! SpaceVim#mapping#leader#defindWindowsLeader(key) abort

View File

@ -249,15 +249,16 @@ CONTENTS *SpaceVim-contents*
148. xmake........................................ |SpaceVim-layers-xmake| 148. xmake........................................ |SpaceVim-layers-xmake|
7. Usage..................................................... |SpaceVim-usage| 7. Usage..................................................... |SpaceVim-usage|
1. Error handling......................... |SpaceVim-usage-error-handling| 1. Error handling......................... |SpaceVim-usage-error-handling|
2. alternate file......................... |SpaceVim-usage-alternate-file| 2. Toggle UI................................... |SpaceVim-usage-toggle-ui|
3. buffers-and-files................... |SpaceVim-usage-buffers-and-files| 3. alternate file......................... |SpaceVim-usage-alternate-file|
4. command-line-mode................... |SpaceVim-usage-command-line-mode| 4. buffers-and-files................... |SpaceVim-usage-buffers-and-files|
5. custom_plugins......................... |SpaceVim-usage-custom_plugins| 5. command-line-mode................... |SpaceVim-usage-command-line-mode|
6. repl............................................. |SpaceVim-usage-repl| 6. custom_plugins......................... |SpaceVim-usage-custom_plugins|
7. search-and-replace................. |SpaceVim-usage-search-and-replace| 7. repl............................................. |SpaceVim-usage-repl|
8. tasks........................................... |SpaceVim-usage-tasks| 8. search-and-replace................. |SpaceVim-usage-search-and-replace|
9. undo-tree.................................... |SpaceVim-usage-undotree| 9. tasks........................................... |SpaceVim-usage-tasks|
10. windows-and-tabs.................... |SpaceVim-usage-windows-and-tabs| 10. undo-tree................................... |SpaceVim-usage-undotree|
11. windows-and-tabs.................... |SpaceVim-usage-windows-and-tabs|
8. Plugins................................................. |SpaceVim-plugins| 8. Plugins................................................. |SpaceVim-plugins|
1. Mapping Guide......................... |SpaceVim-plugins-mapping-guide| 1. Mapping Guide......................... |SpaceVim-plugins-mapping-guide|
2. Symbol highlighter............... |SpaceVim-plugins-symbol-highlighter| 2. Symbol highlighter............... |SpaceVim-plugins-symbol-highlighter|
@ -6186,6 +6187,34 @@ QUICKFIX LIST NAVIGATION
<Leader> q p | jump to previous item in quickfix list <Leader> q p | jump to previous item in quickfix list
< <
==============================================================================
TOGGLE UI *SpaceVim-usage-toggle-ui*
Some UI indicators can be toggled on and off (toggles start with t and T):
>
Key Bindings | Descriptions
----------------- | -----------------------------------------
SPC t 8 | highlight characters past the 80th column
SPC t a | toggle autocomplete
SPC t f | display the fill column
SPC t h h | toggle highlight of the current line
SPC t h i | toggle highlight indentation levels
SPC t h c | toggle highlight current column
SPC t h s | toggle syntax highlighting
SPC t i | toggle indentation guide at point
SPC t n | toggle line numbers
SPC t b | toggle background
SPC t c | toggle conceal
SPC t p | toggle paste mode
SPC t P | toggle auto parens mode
SPC t t | open tabs manager
SPC T ~ | display ~ in the fringe on empty lines
SPC T F / F11 | toggle frame fullscreen
SPC T f | toggle display of the fringe
SPC T m | toggle menu bar
SPC T t | toggle tool bar
<
============================================================================== ==============================================================================
ALTERNATE FILE *SpaceVim-usage-alternate-file* ALTERNATE FILE *SpaceVim-usage-alternate-file*
@ -6626,28 +6655,97 @@ Key bindings within undo tree windows:
============================================================================== ==============================================================================
WINDOWS-AND-TABS *SpaceVim-usage-windows-and-tabs* WINDOWS-AND-TABS *SpaceVim-usage-windows-and-tabs*
WINDOWS RELATED KEY BINDINGS
Window manager key bindings can only be used in normal mode. The default Window manager key bindings can only be used in normal mode. The default
leader `[WIN]` is `s`, you can change it via `windows_leader` option: leader `[WIN]` is `s`, you can change it via `windows_leader` in the
`[options]` section:
> >
[options] [options]
windows_leader = "s" windows_leader = "s"
< <
The following key bindings can be used to manager vim windows and tabs.
> >
Key Bindings | Descriptions Key Bindings | Descriptions
------------ | -------------------------------------------------- ------------ | --------------------------------------------------
q | Smart buffer close q | Smart buffer close
WIN v | :split WIN v | :split
WIN V | Split with previous buffer WIN V | Split with previous buffer
WIN g | :vsplit WIN g | :vsplit
WIN G | Vertically split with previous buffer WIN G | Vertically split with previous buffer
WIN t | Open new tab (:tabnew) WIN t | Open new tab (:tabnew)
WIN o | Close other windows (:only) WIN o | Close other windows (:only)
WIN x | Remove buffer, leave blank window WIN x | Remove buffer, leave blank window
WIN q | Remove current buffer WIN q | Remove current buffer
WIN Q | Close current buffer (:close) WIN Q | Close current buffer (:close)
Shift-Tab | Switch to alternate window (switch back and forth) Shift-Tab | Switch to alternate window (switch back and forth)
<
SpaceVim has mapped normal `q` (record a macro) as smart buffer close, and
record a macro (vim's `q`) has been mapped to `<Leader> q r`, if you want to
disable this feature, you can use `vimcompatible` mode.
GENERAL EDITOR WINDOWS
>
Key Bindings | Descriptions
------------ | --------------------------------
<F2> | Toggle tagbar
<F3> | Toggle Vimfiler
Ctrl-Down | Move to split below ( Ctrl-w j )
Ctrl-Up | Move to upper split ( Ctrl-w k )
Ctrl-Left | Move to left split ( Ctrl-w h )
Ctrl-Right | Move to right split ( Ctrl-w l )
<
WINDOW MANIPULATION KEY BINDINGS
Every window has a number displayed at the start of the statusline and can be
quickly accessed using `SPC number`.
>
Key Bindings | Descriptions
------------ | ---------------------
SPC 1 | go to window number 1
SPC 2 | go to window number 2
SPC 3 | go to window number 3
SPC 4 | go to window number 4
SPC 5 | go to window number 5
SPC 6 | go to window number 6
SPC 7 | go to window number 7
SPC 8 | go to window number 8
SPC 9 | go to window number 9
<
Windows manipulation commands (start with `w`):
>
Key Bindings | Descriptions
--------------------- | --------------------------------------------------
SPC w . | windows transient state
SPC w <Tab> | switch to alternate window in the current frame
SPC w = | balance split windows
SPC w c | Distraction-free reading current window
SPC w C | Distraction-free reading other windows
SPC w d | delete a window
SPC w D | delete another window using vim-choosewin
SPC w f | toggle follow mode
SPC w F | create new tab
SPC w h | move to window on the left
SPC w H | move window to the left
SPC w j | move to window below
SPC w J | move window to the bottom
SPC w k | move to window above
SPC w K | move window to the top
SPC w l | move to window on the right
SPC w L | move window to the right
SPC w m | maximize/minimize a window
SPC w M | swap windows using vim-choosewin
SPC w o | cycle and focus between tabs
SPC w r | rotate windows forward
SPC w R | rotate windows backward
SPC w s / SPC w - | horizontal split
SPC w S | horizontal split and focus new window
SPC w u | undo window layout
SPC w U | redo window layout
SPC w v / SPC w / | vertical split
SPC w V | vertical split and focus new window
SPC w w | cycle and focus between windows
SPC w W | select window using vim-choosewin
SPC w x | exchange current window with next one
< <
============================================================================== ==============================================================================