mirror of
https://github.com/amix/vimrc
synced 2025-07-10 11:44:59 +08:00
Updated plugins
This commit is contained in:
@ -1,23 +1,19 @@
|
||||
*lightline.txt* A light and configurable statusline/tabline for Vim
|
||||
|
||||
Version: 0.1
|
||||
Author: itchyny (https://github.com/itchyny)
|
||||
License: MIT License
|
||||
Repository: https://github.com/itchyny/lightline.vim
|
||||
Last Change: 2020/05/02 17:05:15.
|
||||
Last Change: 2020/10/20 21:35:06.
|
||||
|
||||
CONTENTS *lightline-contents*
|
||||
|
||||
Introduction |lightline-introduction|
|
||||
Spirit |lightline-spirit|
|
||||
Option |lightline-option|
|
||||
Font |lightline-font|
|
||||
Function |lightline-function|
|
||||
Component Expansion |lightline-component-expansion|
|
||||
Colorscheme |lightline-colorscheme|
|
||||
Examples |lightline-examples|
|
||||
Nice Examples |lightline-nice-examples|
|
||||
Powerful Example |lightline-powerful-example|
|
||||
Troubleshooting |lightline-troubleshooting|
|
||||
|
||||
==============================================================================
|
||||
@ -107,7 +103,7 @@ OPTIONS *lightline-option*
|
||||
\ 'percent': '%3p%%',
|
||||
\ 'percentwin': '%P',
|
||||
\ 'spell': '%{&spell?&spelllang:""}',
|
||||
\ 'lineinfo': '%3l:%-2v',
|
||||
\ 'lineinfo': '%3l:%-2c',
|
||||
\ 'line': '%l',
|
||||
\ 'column': '%c',
|
||||
\ 'close': '%999X X ',
|
||||
@ -152,6 +148,10 @@ OPTIONS *lightline-option*
|
||||
\ },
|
||||
\ }
|
||||
<
|
||||
If you simply want to display the branch name instead of
|
||||
installing a plugin for full git integration, you can use
|
||||
vim-gitbranch (https://github.com/itchyny/vim-gitbranch).
|
||||
|
||||
g:lightline.component_function_visible_condition
|
||||
*g:lightline.component_function_visible_condition*
|
||||
A dictionary to store the visible conditions of the function
|
||||
@ -291,78 +291,6 @@ OPTIONS *lightline-option*
|
||||
\ }
|
||||
<
|
||||
==============================================================================
|
||||
FONT *lightline-font*
|
||||
You can use the patched font you used for |vim-powerline| and |powerline|.
|
||||
|
||||
The patched fonts for |powerline| are available at
|
||||
https://github.com/Lokaltog/powerline-fonts
|
||||
|
||||
A tutorial to create a patched font for |vim-powerline| is available at
|
||||
https://github.com/Lokaltog/vim-powerline/tree/develop/fontpatcher
|
||||
|
||||
If you have installed the patched font for |powerline|, following settings look
|
||||
nice.
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'component': {
|
||||
\ 'lineinfo': ' %3l:%-2v',
|
||||
\ },
|
||||
\ 'component_function': {
|
||||
\ 'readonly': 'LightlineReadonly',
|
||||
\ 'fugitive': 'LightlineFugitive'
|
||||
\ },
|
||||
\ 'separator': { 'left': '', 'right': '' },
|
||||
\ 'subseparator': { 'left': '', 'right': '' }
|
||||
\ }
|
||||
function! LightlineReadonly()
|
||||
return &readonly ? '' : ''
|
||||
endfunction
|
||||
function! LightlineFugitive()
|
||||
if exists('*FugitiveHead')
|
||||
let branch = FugitiveHead()
|
||||
return branch !=# '' ? ''.branch : ''
|
||||
endif
|
||||
return ''
|
||||
endfunction
|
||||
<
|
||||
If you have installed the patched font for |vim-powerline|, following settings
|
||||
look nice.
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'component': {
|
||||
\ 'lineinfo': '⭡ %3l:%-2v',
|
||||
\ },
|
||||
\ 'component_function': {
|
||||
\ 'readonly': 'LightlineReadonly',
|
||||
\ 'fugitive': 'LightlineFugitive'
|
||||
\ },
|
||||
\ 'separator': { 'left': '⮀', 'right': '⮂' },
|
||||
\ 'subseparator': { 'left': '⮁', 'right': '⮃' }
|
||||
\ }
|
||||
function! LightlineReadonly()
|
||||
return &readonly ? '⭤' : ''
|
||||
endfunction
|
||||
function! LightlineFugitive()
|
||||
if exists('*FugitiveHead')
|
||||
let branch = FugitiveHead()
|
||||
return branch !=# '' ? '⭠ '.branch : ''
|
||||
endif
|
||||
return ''
|
||||
endfunction
|
||||
<
|
||||
If the statusline does not correctly show the special characters, use the
|
||||
unicode numbers. For |powerline| font users:
|
||||
>
|
||||
\ 'separator': { 'left': "\ue0b0", 'right': "\ue0b2" },
|
||||
\ 'subseparator': { 'left': "\ue0b1", 'right': "\ue0b3" }
|
||||
<
|
||||
For |vim-powerline| font users:
|
||||
>
|
||||
\ 'separator': { 'left': "\u2b80", 'right': "\u2b82" },
|
||||
\ 'subseparator': { 'left': "\u2b81", 'right': "\u2b83" }
|
||||
<
|
||||
See |lightline-problem-9| for more detail.
|
||||
==============================================================================
|
||||
FUNCTION *lightline-function*
|
||||
Exposed functions for lightline.vim.
|
||||
|
||||
@ -662,34 +590,27 @@ In order to change the colorscheme:
|
||||
\ 'colorscheme': 'wombat',
|
||||
\ }
|
||||
<
|
||||
|
||||
In order to define your own component:
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'active': {
|
||||
\ 'left': [ [ 'mode', 'paste' ], [ 'myfilename' ] ]
|
||||
\ },
|
||||
\ 'component_function': {
|
||||
\ 'myfilename': 'LightlineFilename',
|
||||
\ 'myreadonly': 'LightlineReadonly',
|
||||
\ 'mymodified': 'LightlineModified',
|
||||
\ 'filename': 'LightlineFilename',
|
||||
\ 'readonly': 'LightlineReadonly',
|
||||
\ 'modified': 'LightlineModified',
|
||||
\ }
|
||||
\ }
|
||||
function! LightlineFilename()
|
||||
return (LightlineReadonly() !=# '' ? LightlineReadonly() . ' ' : '') .
|
||||
\ (&ft ==# 'vimfiler' ? vimfiler#get_status_string() :
|
||||
return &ft ==# 'vimfiler' ? vimfiler#get_status_string() :
|
||||
\ &ft ==# 'unite' ? unite#get_status_string() :
|
||||
\ expand('%:t') !=# '' ? expand('%:t') : '[No Name]') .
|
||||
\ (LightlineModified() !=# '' ? ' ' . LightlineModified() : '')
|
||||
\ expand('%:t') !=# '' ? expand('%:t') : '[No Name]'
|
||||
endfunction
|
||||
function! LightlineReadonly()
|
||||
return &ft !~? 'help' && &readonly ? 'RO' : ''
|
||||
return &ft !~? 'help\|vimfiler' && &readonly ? 'RO' : ''
|
||||
endfunction
|
||||
function! LightlineModified()
|
||||
return &modifiable && &modified ? '+' : ''
|
||||
endfunction
|
||||
<
|
||||
|
||||
Separators settings:
|
||||
>
|
||||
let g:lightline = {
|
||||
@ -697,30 +618,9 @@ Separators settings:
|
||||
\ 'subseparator': { 'left': '|', 'right': '|' }
|
||||
\ }
|
||||
<
|
||||
|
||||
For |powerline| font users:
|
||||
An example for fugitive, vimfiler and unite users.
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'separator': { 'left': '', 'right': '' },
|
||||
\ 'subseparator': { 'left': '', 'right': '' }
|
||||
\ }
|
||||
<
|
||||
|
||||
For |vim-powerline| font users:
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'separator': { 'left': '⮀', 'right': '⮂' },
|
||||
\ 'subseparator': { 'left': '⮁', 'right': '⮃' }
|
||||
\ }
|
||||
<
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
NICE EXAMPLES *lightline-nice-examples*
|
||||
|
||||
A nice example for non-patched font users.
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'colorscheme': 'wombat',
|
||||
\ 'active': {
|
||||
\ 'left': [ [ 'mode', 'paste' ], [ 'fugitive', 'filename' ] ]
|
||||
\ },
|
||||
@ -739,61 +639,19 @@ A nice example for non-patched font users.
|
||||
return (LightlineReadonly() !=# '' ? LightlineReadonly() . ' ' : '') .
|
||||
\ (&ft ==# 'vimfiler' ? vimfiler#get_status_string() :
|
||||
\ &ft ==# 'unite' ? unite#get_status_string() :
|
||||
\ &ft ==# 'vimshell' ? vimshell#get_status_string() :
|
||||
\ expand('%:t') !=# '' ? expand('%:t') : '[No Name]') .
|
||||
\ (LightlineModified() !=# '' ? ' ' . LightlineModified() : '')
|
||||
endfunction
|
||||
function! LightlineFugitive()
|
||||
if &ft !~? 'vimfiler' && exists('*FugitiveHead')
|
||||
if exists('*FugitiveHead')
|
||||
return FugitiveHead()
|
||||
endif
|
||||
return ''
|
||||
endfunction
|
||||
<
|
||||
A nice example for |vim-powerline| font users:
|
||||
For users of lots of plugins:
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'colorscheme': 'wombat',
|
||||
\ 'active': {
|
||||
\ 'left': [ [ 'mode', 'paste' ], [ 'fugitive', 'filename' ] ]
|
||||
\ },
|
||||
\ 'component_function': {
|
||||
\ 'fugitive': 'LightlineFugitive',
|
||||
\ 'filename': 'LightlineFilename'
|
||||
\ },
|
||||
\ 'separator': { 'left': '⮀', 'right': '⮂' },
|
||||
\ 'subseparator': { 'left': '⮁', 'right': '⮃' }
|
||||
\ }
|
||||
function! LightlineModified()
|
||||
return &ft =~# 'help\|vimfiler' ? '' : &modified ? '+' : &modifiable ? '' : '-'
|
||||
endfunction
|
||||
function! LightlineReadonly()
|
||||
return &ft !~? 'help\|vimfiler' && &readonly ? '⭤' : ''
|
||||
endfunction
|
||||
function! LightlineFilename()
|
||||
return (LightlineReadonly() !=# '' ? LightlineReadonly() . ' ' : '') .
|
||||
\ (&ft ==# 'vimfiler' ? vimfiler#get_status_string() :
|
||||
\ &ft ==# 'unite' ? unite#get_status_string() :
|
||||
\ &ft ==# 'vimshell' ? vimshell#get_status_string() :
|
||||
\ expand('%:t') !=# '' ? expand('%:t') : '[No Name]') .
|
||||
\ (LightlineModified() !=# '' ? ' ' . LightlineModified() : '')
|
||||
endfunction
|
||||
function! LightlineFugitive()
|
||||
if &ft !~? 'vimfiler' && exists('*FugitiveHead')
|
||||
let branch = FugitiveHead()
|
||||
return branch !=# '' ? '⭠ '.branch : ''
|
||||
endif
|
||||
return ''
|
||||
endfunction
|
||||
<
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
POWERFUL EXAMPLE *lightline-powerful-example*
|
||||
|
||||
For users who uses lots of plugins:
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'colorscheme': 'wombat',
|
||||
\ 'active': {
|
||||
\ 'left': [ [ 'mode', 'paste' ], [ 'fugitive', 'filename' ], ['ctrlpmark'] ],
|
||||
\ 'right': [ [ 'syntastic', 'lineinfo' ], ['percent'], [ 'fileformat', 'fileencoding', 'filetype' ] ]
|
||||
@ -935,17 +793,7 @@ Problem 5: |lightline-problem-5|
|
||||
The statusline does not seem to be correctly colored.
|
||||
|
||||
Problem 6: |lightline-problem-6|
|
||||
How to install a patched font.
|
||||
|
||||
Problem 7: |lightline-problem-7|
|
||||
Right triangles do not stick to the right components with the
|
||||
patched font.
|
||||
|
||||
Problem 8: |lightline-problem-8|
|
||||
Triangles do not appear. Triangles look weird.
|
||||
|
||||
Problem 9: |lightline-problem-9|
|
||||
Where can I find the list of all the cool characters for patched fonts?
|
||||
How to use a powerline font and the triangles for separators.
|
||||
|
||||
Problem 10: |lightline-problem-10|
|
||||
Cool statusline disappears in |unite|, |vimfiler| and |vimshell|
|
||||
@ -984,20 +832,17 @@ Problem 17: |lightline-problem-17|
|
||||
Problem 1: *lightline-problem-1*
|
||||
How to install this plugin.
|
||||
|
||||
If you are to install this plugin manually:
|
||||
|
||||
1. Put all the files under $VIM.
|
||||
|
||||
If you are to install this plugin using |vim-pathogen|:
|
||||
|
||||
1. Install this plugin with the following command.
|
||||
If you install this plugin using Vim packages:
|
||||
>
|
||||
git clone https://github.com/itchyny/lightline.vim \
|
||||
~/.vim/pack/plugins/start/lightline
|
||||
<
|
||||
If you install this plugin using |vim-pathogen|:
|
||||
>
|
||||
git clone https://github.com/itchyny/lightline.vim \
|
||||
~/.vim/bundle/lightline.vim
|
||||
<
|
||||
2. Generate help tags with |:Helptags|.
|
||||
|
||||
If you are to install this plugin using |Vundle|:
|
||||
If you install this plugin using |Vundle|:
|
||||
|
||||
1. Add the following configuration to your
|
||||
.vimrc(_vimrc).
|
||||
@ -1006,7 +851,7 @@ Problem 1: *lightline-problem-1*
|
||||
<
|
||||
2. Install with |:PluginInstall|.
|
||||
|
||||
If you are to install this plugin using |NeoBundle|:
|
||||
If you install this plugin using |NeoBundle|:
|
||||
|
||||
1. Add the following configuration to your
|
||||
.vimrc(_vimrc).
|
||||
@ -1015,7 +860,7 @@ Problem 1: *lightline-problem-1*
|
||||
<
|
||||
2. Install with |:NeoBundleInstall|.
|
||||
|
||||
If you are to install this plugin using |vim-plug|:
|
||||
If you install this plugin using |vim-plug|:
|
||||
|
||||
1. Add the following configuration to your
|
||||
.vimrc(_vimrc).
|
||||
@ -1024,51 +869,76 @@ Problem 1: *lightline-problem-1*
|
||||
<
|
||||
2. Install with |:PlugInstall|.
|
||||
|
||||
If you install this plugin using |dein|:
|
||||
|
||||
1. Add the following configuration to your
|
||||
.vimrc(_vimrc).
|
||||
>
|
||||
call dein#add('itchyny/lightline.vim')
|
||||
<
|
||||
2. Install with :call |dein#install()|.
|
||||
|
||||
Problem 2: *lightline-problem-2*
|
||||
How to update this plugin.
|
||||
|
||||
If you have installed this plugin manually:
|
||||
If you installed this plugin using Vim packages:
|
||||
>
|
||||
git -C ~/.vim/pack/plugins/start/lightline pull
|
||||
<
|
||||
If you installed this plugin using |vim-pathogen|:
|
||||
>
|
||||
git -C ~/.vim/bundle/lightline.vim pull
|
||||
<
|
||||
If you installed this plugin using |Vundle|:
|
||||
|
||||
1. Access https://github.com/itchyny/lightline.vim .
|
||||
2. Download the latest scripts.
|
||||
3. Place the scripts as written in Problem 1.
|
||||
Execute |:PluginUpdate|.
|
||||
|
||||
If you have installed this plugin using Vundle:
|
||||
If you installed this plugin using |NeoBundle|:
|
||||
|
||||
1. Execute |:PluginUpdate|.
|
||||
Execute |:NeoBundleUpdate|.
|
||||
|
||||
If you have installed this plugin using NeoBundle:
|
||||
If you installed this plugin using |vim-plug|:
|
||||
|
||||
1. Execute |:NeoBundleUpdate|.
|
||||
Execute |:PlugUpdate|.
|
||||
|
||||
If you have installed this plugin using vim-plug:
|
||||
If you installed this plugin using |dein|:
|
||||
|
||||
1. Execute |:PlugUpdate|.
|
||||
Execute :call |dein#update()|.
|
||||
|
||||
Problem 3: *lightline-problem-3*
|
||||
How to uninstall this plugin.
|
||||
|
||||
If you have installed this plugin manually:
|
||||
If you installed this plugin using Vim packages:
|
||||
>
|
||||
rm -rf ~/.vim/pack/plugins/start/lightline
|
||||
<
|
||||
If you installed this plugin using |vim-pathogen|:
|
||||
>
|
||||
rm -rf ~/.vim/bundle/lightline.vim
|
||||
<
|
||||
If you have installed this plugin using |Vundle|:
|
||||
|
||||
1. Remove all the lightline.*s under $VIM.
|
||||
1. Remove `Plugin 'itchyny/lightline.vim'`
|
||||
from your .vimrc(_vimrc).
|
||||
2. Execute |:PluginClean|.
|
||||
|
||||
If you have installed this plugin using Vundle:
|
||||
If you installed this plugin using |NeoBundle|:
|
||||
|
||||
1. Remove the :Plugin 'itchyny/lightline.vim'
|
||||
configuration from your .vimrc(_vimrc).
|
||||
2. Update with |:PluginClean|.
|
||||
1. Remove `NeoBundle 'itchyny/lightline.vim'`
|
||||
from your .vimrc(_vimrc).
|
||||
2. Remove the plugin directory.
|
||||
|
||||
If you have installed this plugin using NeoBundle:
|
||||
If you installed this plugin using |vim-plug|:
|
||||
|
||||
1. Remove the :NeoBundle 'itchyny/lightline.vim'
|
||||
configuration from your .vimrc(_vimrc).
|
||||
2. Update with |:NeoBundleClean|.
|
||||
1. Remove `Plug 'itchyny/lightline.vim'`
|
||||
from your .vimrc(_vimrc).
|
||||
2. Execute |:PlugClean|.
|
||||
|
||||
If you have installed this plugin using vim-plug:
|
||||
If you installed this plugin using |dein|:
|
||||
|
||||
1. Remove the :Plug 'itchyny/lightline.vim'
|
||||
configuration from your .vimrc(_vimrc).
|
||||
2. Update with |:PlugClean|.
|
||||
1. Remove `call dein#add('itchyny/lightline.vim')`
|
||||
from your .vimrc(_vimrc).
|
||||
2. Remove the plugin directory.
|
||||
|
||||
Problem 4: *lightline-problem-4*
|
||||
Cool statuslines appear only on |:vsp|.
|
||||
@ -1093,74 +963,22 @@ Problem 5: *lightline-problem-5*
|
||||
to your .vimrc(_vimrc).
|
||||
|
||||
Problem 6: *lightline-problem-6*
|
||||
How to install a patched font.
|
||||
How to use a powerline font and the triangles for separators.
|
||||
|
||||
There are two kinds of patched fonts:
|
||||
Using a patched font is not recommended due to less
|
||||
portability. Also the powerline fonts project is not actively
|
||||
maintained (https://github.com/powerline/fonts).
|
||||
|
||||
+ The patched fonts for |vim-powerline|
|
||||
(https://github.com/Lokaltog/vim-powerline):
|
||||
follow the guide https://github.com/Lokaltog/vim-powerline/tree/develop/fontpatcher
|
||||
+ The patched fonts for |powerline|
|
||||
(https://github.com/Lokaltog/powerline):
|
||||
download from https://github.com/Lokaltog/powerline-fonts
|
||||
|
||||
Problem 7: *lightline-problem-7*
|
||||
Right triangles do not stick to the right components with patched
|
||||
font.
|
||||
|
||||
Remove the following setting from your .vimrc(_vimrc).
|
||||
>
|
||||
set ambiwidth=double
|
||||
<
|
||||
If you want to keep this setting, try the patched font for
|
||||
|vim-powerline|.
|
||||
|
||||
Problem 8: *lightline-problem-8*
|
||||
Triangles do not appear. Triangles look weird.
|
||||
|
||||
If the triangles do not appear (but you get some spaces or
|
||||
weird characters like <bf> or ¿), firstly try adding
|
||||
>
|
||||
scriptencoding utf-8
|
||||
set encoding=utf-8
|
||||
<
|
||||
to the head of your .vimrc(_vimrc). Still you have weird
|
||||
characters, use the unicode numbers. For |powerline| font
|
||||
users:
|
||||
If you still want to use a patched font, you can configure
|
||||
>
|
||||
\ 'separator': { 'left': "\ue0b0", 'right': "\ue0b2" },
|
||||
\ 'subseparator': { 'left': "\ue0b1", 'right': "\ue0b3" }
|
||||
\ 'subseparator': { 'left': "\ue0b1", 'right': "\ue0b3" },
|
||||
<
|
||||
For |vim-powerline| font users:
|
||||
or
|
||||
>
|
||||
\ 'separator': { 'left': "\u2b80", 'right': "\u2b82" },
|
||||
\ 'subseparator': { 'left': "\u2b81", 'right': "\u2b83" }
|
||||
\ 'subseparator': { 'left': "\u2b81", 'right': "\u2b83" },
|
||||
<
|
||||
The full list of unicode numbers for fancy characters is shown
|
||||
in |lightline-problem-9|.
|
||||
|
||||
If the triangles are shown in appropriate characters but the
|
||||
colors do not look correctly, see the following.
|
||||
If you are using iTerm2, change the following settings.
|
||||
|
||||
+ set Profiles>Colors>Minimum contrast to the Lowest.
|
||||
+ set Profiles>Window>Transparency to the Opaquest.
|
||||
|
||||
For other terminals, this weird-triangle problem will be
|
||||
resolved by disabling transparency or contrast adjustment.
|
||||
|
||||
Problem 9: *lightline-problem-9*
|
||||
Where can I find the list of all the cool characters for patched fonts?
|
||||
|
||||
Default powerline vim-powerline
|
||||
separator.left '' '' (\ue0b0) '⮀' (\u2b80)
|
||||
separator.right '' '' (\ue0b2) '⮂' (\u2b82)
|
||||
subseparator.left '|' '' (\ue0b1) '⮁' (\u2b81)
|
||||
subseparator.right '|' '' (\ue0b3) '⮃' (\u2b83)
|
||||
branch symbol -- '' (\ue0a0) '⭠' (\u2b60)
|
||||
readonly symbol -- '' (\ue0a2) '⭤' (\u2b64)
|
||||
linecolumn symbol -- '' (\ue0a1) '⭡' (\u2b61)
|
||||
|
||||
Problem 10: *lightline-problem-10*
|
||||
Cool statusline disappears on |unite|, |vimfiler| and |vimshell|
|
||||
buffers.
|
||||
@ -1192,7 +1010,7 @@ Problem 11: *lightline-problem-11*
|
||||
return lightline#statusline(0)
|
||||
endfunction
|
||||
<
|
||||
See |lightline-powerful-example| for more cool settings for
|
||||
See |lightline-example| for more cool settings for
|
||||
these plugins.
|
||||
|
||||
Problem 12: *lightline-problem-12*
|
||||
@ -1287,8 +1105,8 @@ Problem 15: *lightline-problem-15*
|
||||
If you don't like the separators in the tabline, use:
|
||||
>
|
||||
let g:lightline = {
|
||||
\ 'tabline_separator': { 'left': "", 'right': "" },
|
||||
\ 'tabline_subseparator': { 'left': "", 'right': "" },
|
||||
\ 'tabline_separator': { 'left': '', 'right': '' },
|
||||
\ 'tabline_subseparator': { 'left': '', 'right': '' },
|
||||
\ }
|
||||
<
|
||||
Problem 16: *lightline-problem-16*
|
||||
|
Reference in New Issue
Block a user