Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/drzel/vim-line-no-indicator
Simple and expressive line number indicator.
https://github.com/drzel/vim-line-no-indicator
Last synced: 3 months ago
JSON representation
Simple and expressive line number indicator.
- Host: GitHub
- URL: https://github.com/drzel/vim-line-no-indicator
- Owner: drzel
- License: mit
- Created: 2017-09-02T07:38:20.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-09-14T15:10:54.000Z (about 1 year ago)
- Last Synced: 2024-07-04T04:34:15.513Z (4 months ago)
- Language: Vim Script
- Homepage:
- Size: 16.6 KB
- Stars: 124
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vim-line-no-indicator
A simple line number indicator.
## Why?
I have line numbers displayed (`set number`) when editing code, so I already
know what line number I'm on. I just need something to show me roughly how far
through the document I am, without taking up 4+ characters in my statusline.
## Installation
Install with a plugin manager.
## Usage
Add `%{LineNoIndicator()}` to your statusline. For example:
```vim
set statusline=%<%f\ %h%m%r%=%-14.(%l,%c%V%)\ %{LineNoIndicator()}
```
See `:help 'statusline'` for more information about doing this.
### vim-lightline
I use [vim-lightline](https://github.com/itchyny/lightline.vim). My settings
look like this:
```vim
let g:lightline.component = {
\ 'indicator': '%{LineNoIndicator()}'
\ }
let g:lightline.active = {
\ 'left': [
\ [ 'mode', 'paste' ],
\ [ 'readonly', 'relativepath', 'modified' ]
\ ],
\ 'right': [
\ [ 'indicator' ],
\ [ 'lineinfo' ]
\ ]
\ }
let g:lightline.inactive = {
\ 'left': [
\ [ 'filename' ]
\ ],
\ 'right': [
\ [ 'indicator' ],
\ [ 'lineinfo' ]
\ ]
\ }
```
### vim-airline
I used to use [vim-airline](https://github.com/vim-airline/vim-airline/). My
settings looked like this:
```vim
let g:airline_section_x = '%{&filetype}'
let g:airline_section_y = '%#__accent_bold#%{LineNoIndicator()}%#__restore__#'
let g:airline_section_z = '%2c'
```
### lualine.nvim
Users of [Lualine](https://github.com/nvim-lualine/lualine.nvim) can simply add `'LineNoIndicator'` in the proper section. For example, one can replace the default
```lua
lualine_y = {'progress'},
```
within the `sections` part of the setup with
```lua
lualine_y = {'LineNoIndicator'},
```
For more information, see [Lualine’s documentation](https://github.com/nvim-lualine/lualine.nvim#usage-and-customization).
## Configuration
```vim
" Defaults
let g:line_no_indicator_chars = ['⎺', '⎻', '─', '⎼', '⎽'] " on macOS
let g:line_no_indicator_chars = ['⎺', '⎻', '⎼', '⎽', '⎯'] " on Linux
```
The chars above look different between my Mac and Ubuntu machines for some
reason, so the above are the respective defaults. If neither of these are right
for you, [create an issue](https://github.com/drzel/vim-line-no-indicator/issues/new).
Some alternatives:
```vim
" one char wide solid vertical bar
let g:line_no_indicator_chars = [
\ ' ', '▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'
\ ]
" two char wide fade-in blocks
let g:line_no_indicator_chars = [
\ ' ', '░ ', '▒ ', '▓ ', '█ ', '█░', '█▒', '█▓', '██'
\ ]
" three char wide solid horizontal bar
let g:line_no_indicator_chars = [
\ ' ', '▏ ', '▎ ', '▍ ', '▌ ',
\ '▋ ', '▊ ', '▉ ', '█ ', '█▏ ',
\ '█▎ ', '█▍ ', '█▌ ', '█▋ ', '█▊ ',
\ '█▉ ', '██ ', '██▏', '██▎', '██▍',
\ '██▌', '██▋', '██▊', '██▉', '███'
\ ]
```
Note: The above chars might look a little janky in your browser, but probably
render okay in your terminal.
## Screenshots
### Before
Default vim-airline statusline:
### After
With vim-line-no-indicator and vim-airline settings as above:
Screenshots in
[Tilix](https://gnunn1.github.io/tilix-web/), running
[neovim](https://neovim.io/) with
[roboto mono](https://fonts.google.com/specimen/Roboto+Mono) font,
[nord](https://github.com/arcticicestudio/nord-vim) colorscheme and
[vim-airline](https://github.com/vim-airline/vim-airline) statusline.
## What people are saying about vim-line-no-indicator
[justinmk](https://github.com/justinmk):
> Cool. I used [noscrollbar](https://github.com/gcavallanti/vim-noscrollbar)
> for a long time, but sometimes wished for this approach instead.
[romainl](https://github.com/romainl):
> I don't think it's of any use.