More README update
This commit is contained in:
parent
dec07982d9
commit
ece68bd965
1 changed files with 9 additions and 5 deletions
14
README.md
14
README.md
|
@ -6,22 +6,26 @@ It keeps track of a "combo" counter that increases every time you press a key. W
|
||||||
Deleting won't increase your combo but it will reset the timer. By default, the timer is 1 second. It may seem tight but longer timers lead to incredibly big combos too easily.
|
Deleting won't increase your combo but it will reset the timer. By default, the timer is 1 second. It may seem tight but longer timers lead to incredibly big combos too easily.
|
||||||
Pasting counts as 1 (be it in Insert-Paste or directly from clipboard), movement does not affect the counter.
|
Pasting counts as 1 (be it in Insert-Paste or directly from clipboard), movement does not affect the counter.
|
||||||
## how
|
## how
|
||||||
It uses a function called on buffer change (autocmd on TextChangedI) to increases the counter. Current time is checked every time against last best time.
|
It uses a function called on buffer change (autocmd on TextChangedI) to increases the counter. Current time is checked every time against last recorded time.
|
||||||
|
|
||||||
vim-combo keeps track of your best combos for each filetype with files inside the hidden .combo folder (~/.vim/.combo). Every time vim loads, the best combo is loaded from file (one is kept for each filetype edited). Every time you get a new best score, the value on file is replaced.
|
vim-combo keeps track of your best combos for each filetype with files inside the hidden `.combo` folder (`~/.vim/.combo`). Every time vim loads, the best combo is loaded from file (one is kept for each filetype edited). Every time you get a new best score, the value on file is replaced.
|
||||||
|
|
||||||
# powermode for vim?
|
# powermode for vim?
|
||||||
vim-combo is inspired by the power-mode many more graphical editors have. While all the particles and text shaking is nice, the thing I really wanted was to keep track of my typing combos.
|
vim-combo is inspired by the power-mode many more graphical editors have. While all the particles and text shaking is nice, the thing I really wanted was to keep track of my typing combos.
|
||||||
|
|
||||||
There already are few plugins which provide particles (vim-particle, vim-power-mode) but they required windows. vim-combo can run on any system since it's only vim script!
|
There already are few plugins which provide particles (vim-particle, vim-power-mode) but they require gui and some fiddling. vim-combo can run on any system since it's only vim script!
|
||||||
|
|
||||||
# quickstart
|
# quickstart
|
||||||
If you just load this with a plugin manager, your combo will be tracked but not displayed anywhere. Current combo string is kept in `g:combo`, you can place it anywhere you'd like. If you don't have specific statusbar edits, you can add `set statusline=%{g:combo}` in your `.vimrc`.
|
If you just load this with a plugin manager, your combo will be tracked but not displayed anywhere. Current combo string is kept in `g:combo`, you can place it anywhere you'd like. If you don't have specific statusbar edits, you can add
|
||||||
|
```
|
||||||
|
set statusline=%{g:combo}
|
||||||
|
```
|
||||||
|
in your `.vimrc`.
|
||||||
|
|
||||||
# configuring
|
# configuring
|
||||||
* You can change the combo timeout by overriding `g:timeout` in your `.vimrc`. Defaults to 1.
|
* You can change the combo timeout by overriding `g:timeout` in your `.vimrc`. Defaults to 1.
|
||||||
* You can access the whole combo string in `g:combo`. You can find current score in `g:combo_counter` and best score for file in `g:combo_best`.
|
* You can access the whole combo string in `g:combo`. You can find current score in `g:combo_counter` and best score for file in `g:combo_best`.
|
||||||
* You can bind function `Cheated` to a key. If you by accident register an unfair value, you can call it to revert.
|
* You can bind function `Cheated()` to a key. If you by accident register an unfair value, you can call it to revert.
|
||||||
|
|
||||||
# is this fast?
|
# is this fast?
|
||||||
vim-combo should be pretty fast. It runs a lot but does very little (time difference, counter). If you have any issue contact me!
|
vim-combo should be pretty fast. It runs a lot but does very little (time difference, counter). If you have any issue contact me!
|
||||||
|
|
Loading…
Reference in a new issue