|
|
|
|
@ -1,30 +1,31 @@
|
|
|
|
|
*togglebackground.txt* For Vim version 7.3. or newer Last change: 2011 Apr 7 |
|
|
|
|
*togglebg.vim* For Vim version 7.3. or newer Modified: 2011 Apr 12 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
TOGGLE BACKGROUND PLUGIN by Ethan Schoonover ~ |
|
|
|
|
|
|
|
|
|
Toggle Background *toggle-background* |
|
|
|
|
*togglebackground* |
|
|
|
|
*togglebg* *togbg* |
|
|
|
|
Toggle Background *togglebackground* |
|
|
|
|
*toggle-background* |
|
|
|
|
*togglebg* *toggle-bg* |
|
|
|
|
*togbg* *tog-bg* |
|
|
|
|
|
|
|
|
|
Toggle Background is a simple plugin to switch between light and dark |
|
|
|
|
background modes and reset the colorscheme. This is most useful for |
|
|
|
|
colorschemes that support both light and dark modes and in terminals or gui |
|
|
|
|
vim windows where the background will be properly set. |
|
|
|
|
|
|
|
|
|
0. Usage |togbg-usage| |
|
|
|
|
1. Default Mapping |togbg-default| |
|
|
|
|
2. Changing the Mapping |togbg-newmap| |
|
|
|
|
3. Issues |togbg-issues| |
|
|
|
|
0. Usage |togglebg-usage| |
|
|
|
|
1. Default Mapping |togglebg-default| |
|
|
|
|
2. Changing the Mapping |togglebg-newmap| |
|
|
|
|
3. Issues |togglebg-issues| |
|
|
|
|
|
|
|
|
|
============================================================================== |
|
|
|
|
0. Usage *togbg-usage* |
|
|
|
|
0. Usage *togglebg-usage* |
|
|
|
|
|
|
|
|
|
Press your map key(s) to activate Toggle Background, or select "Toggle |
|
|
|
|
Background" from the 'Window' menu while in gui mode. |
|
|
|
|
|
|
|
|
|
============================================================================== |
|
|
|
|
1. Default Mapping *togbg-default* |
|
|
|
|
1. Default Mapping *togglebg-default* |
|
|
|
|
|
|
|
|
|
Toggle Background starts with a default mapping to function key <F5>. If you |
|
|
|
|
are already using this in a mapping, Toggle Background will not map itself to |
|
|
|
|
@ -32,20 +33,22 @@ a default and you will have to map it manually in your .vimrc file, or
|
|
|
|
|
remove/change your existing <F5> mapping to another value. |
|
|
|
|
|
|
|
|
|
============================================================================== |
|
|
|
|
2. Changing the Mapping *togbg-newmap* |
|
|
|
|
2. Changing the Mapping *togglebg-newmap* |
|
|
|
|
|
|
|
|
|
To set your own mapping in your .vimrc file, simply add the following three |
|
|
|
|
lines to support normal, insert and visual mode usage: |
|
|
|
|
lines to support normal, insert and visual mode usage, changing the "<F5>" |
|
|
|
|
value to the key or key combination you wish to use: |
|
|
|
|
|
|
|
|
|
nmap <unique> <F5> <Plug>ToggleBackground |
|
|
|
|
imap <unique> <F5> <Plug>ToggleBackground |
|
|
|
|
vmap <unique> <F5> <Plug>ToggleBackground |
|
|
|
|
call togglebg#map("<F5>") |
|
|
|
|
|
|
|
|
|
Note that it is important to NOT use the noremap map variants. The plugin uses |
|
|
|
|
noremap internally. |
|
|
|
|
Note that you'll want to use a single function key or equivalent if you want |
|
|
|
|
the plugin to work in all modes (normal, insert, visual). |
|
|
|
|
|
|
|
|
|
Note also that it is important to NOT use the noremap map variants. The plugin |
|
|
|
|
uses noremap internally. |
|
|
|
|
|
|
|
|
|
============================================================================== |
|
|
|
|
3. Issues *togbg-issues* |
|
|
|
|
3. Issues *togglebg-issues* |
|
|
|
|
|
|
|
|
|
When using the plugin during insert mode, there should be no interruption in |
|
|
|
|
workflow. However, if you activate the plugin during REPLACE mode, you will |