Skip to content

Latest commit

 

History

History
61 lines (45 loc) · 2.63 KB

README.md

File metadata and controls

61 lines (45 loc) · 2.63 KB
Raw

vim-lineletters

Jump to any visible line in the buffer by using letters instead of numbers. Works in normal and visual modes.

Why? Because letters are much easier to touch type than numbers (๑˃̵ᴗ˂̵)و

Install

Use your favorite plugin manager

Plug 'skamsie/vim-lineletters'

How to use

By default there is no key mapping, to create one, add this in your .vimrc and replace , with whatever you like (even though , is a good choice if you don't normall use it). Ideally it should be a one character mapping.

map <silent>, <Plug>LineLetters

Use the mapping you chose to show signs on each of the visible lines in the buffer. Type the character(s) you see in the sign column to jump to that line.

You can check the documentation at any time with :help lineletters

Settings

By default you don't need to configure anything, but if you want to change the defaults, you can do it via the g:lineletters_settings dictionary. For example you can add something like this to your .vimrc:

let g:lineletters_settings = {
      \ 'main_chars': map(range(100, 120), 'nr2char(v:val)'),
      \ 'prefix_chars': [',', ';', 'j'],
      \ 'highlight_group': 'MoreMsg',
      \ 'after_jump_do': '0'
      \ }
      
" map(range(100, 120), 'nr2char(v:val)') -> will generate a list with letters from 'd' to 'x'

Config Options

+--------------------+-------------------+--------------------------------------------+
| Option             | Default           | Description                                |
|--------------------|-------------------|--------------------------------------------|
| main_chars         | ['a', ..., 'z']   | Main characters used for the signs column. |
|                    |                   | An empty list disables the plugin          |
|--------------------|-------------------|--------------------------------------------|
| prefix_chars       | [',', 'j', 'f']   | Characters used to prefix main_chars after |
|                    |                   | they are consumed                          |
|--------------------|-------------------|--------------------------------------------|
| highlight_group    | 'LineNr'          | Highlight group used to colorize the signs |
|--------------------|-------------------|--------------------------------------------|
| after_jump_do      | '^'               | Command to be executed after               |
|                    |                   | jumping to line (only in normal mode)      |
+--------------------+-------------------+--------------------------------------------+