docs: update README.md & lualine.txt (#239)
* docs: updated luline.txt * docs: updated lualine.txt tags * docs: removed whitespaces from lualine.txt * docs: updated README.md to match lualine.txt * docs: added separators to readme * docs: changes options section to provide examples instead of table * docs: fixed wrong comment in options * docs: made lualine.txt consistent with readme.md * docs: removed notice about theme mirroring * docs: changes tags structure
This commit is contained in:
parent
634959f0e9
commit
e083bf9576
438
README.md
438
README.md
|
@ -7,18 +7,16 @@ A blazing fast and easy to configure neovim statusline written in pure lua.
|
||||||
`lualine.nvim` requires neovim 0.5
|
`lualine.nvim` requires neovim 0.5
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
Please read [CONTRIBUTING.md](./CONTRIBUTING.md) before contributing.
|
|
||||||
|
|
||||||
You can check [this](https://github.com/hoob3rt/lualine.nvim/projects/3) out if you want to see what is currently being worked on.
|
|
||||||
|
|
||||||
Feel free to create an issue/pr if you want to see anything else implemented.
|
Feel free to create an issue/pr if you want to see anything else implemented.
|
||||||
|
|
||||||
|
Please read [CONTRIBUTING.md](./CONTRIBUTING.md) before opening a pr.
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
Here is a preview of how lualine can look like.
|
Here is a preview of how lualine can look like.
|
||||||
|
|
||||||
![normal_cropped](https://user-images.githubusercontent.com/41551030/108650373-bb025580-74bf-11eb-8682-2c09321dd18e.png)
|
![normal_cropped](https://user-images.githubusercontent.com/41551030/108650373-bb025580-74bf-11eb-8682-2c09321dd18e.png)
|
||||||
![powerline_cropped](https://user-images.githubusercontent.com/41551030/108650377-bd64af80-74bf-11eb-9c55-fbfc51b39fe8.png)
|
![powerline_cropped](https://user-images.githubusercontent.com/41551030/108650377-bd64af80-74bf-11eb-9c55-fbfc51b39fe8.png)
|
||||||
![diff_croped](https://user-images.githubusercontent.com/41551030/108650378-be95dc80-74bf-11eb-9718-82b242ecdd54.png)
|
![diff_cropped](https://user-images.githubusercontent.com/41551030/108650378-be95dc80-74bf-11eb-9718-82b242ecdd54.png)
|
||||||
![diagnostics_cropped](https://user-images.githubusercontent.com/41551030/108650381-bfc70980-74bf-11eb-9245-85c48f0f154a.png)
|
![diagnostics_cropped](https://user-images.githubusercontent.com/41551030/108650381-bfc70980-74bf-11eb-9245-85c48f0f154a.png)
|
||||||
![replace](https://user-images.githubusercontent.com/41551030/103467925-32372b00-4d54-11eb-88d6-6d39c46854d8.png)
|
![replace](https://user-images.githubusercontent.com/41551030/103467925-32372b00-4d54-11eb-88d6-6d39c46854d8.png)
|
||||||
|
|
||||||
|
@ -72,67 +70,24 @@ Lualine has sections as shown below.
|
||||||
```
|
```
|
||||||
|
|
||||||
Each sections holds it's components e.g. current vim's mode.
|
Each sections holds it's components e.g. current vim's mode.
|
||||||
Colorscheme of sections is mirrored, meaning section `A` will have the same colorscheme as section `Z` etc.
|
|
||||||
|
|
||||||
|
---
|
||||||
### Starting lualine
|
### Starting lualine
|
||||||
All configurations happens in the setup function
|
|
||||||
```lua
|
```lua
|
||||||
require('lualine').setup{}
|
require('lualine').setup()
|
||||||
```
|
|
||||||
### Setting a theme
|
|
||||||
```lua
|
|
||||||
options = {theme = 'gruvbox'}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
All available themes are listed in [THEMES.md](./THEMES.md)
|
<details><summary>Default config</summary>
|
||||||
|
|
||||||
Please create a pr if you managed to port a popular theme before me, [here is how to do it](./CONTRIBUTING.md).
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>Tweaking themes</summary>
|
|
||||||
|
|
||||||
You like a theme but would like to tweek some colors.
|
|
||||||
You can do that in your config easily.
|
|
||||||
|
|
||||||
Example:
|
|
||||||
```lua
|
```lua
|
||||||
local custom_gruvbox = require'lualine.themes.gruvbox'
|
|
||||||
|
|
||||||
-- Chnage the background of lualine_c section for normal mode
|
|
||||||
custom_gruvbox.normal.c.bg = '#112233' -- rgb colors are supported
|
|
||||||
|
|
||||||
require'lualine'.setup {
|
require'lualine'.setup {
|
||||||
options = { theme = custom_gruvbox },
|
|
||||||
...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
You can checkout structure of a lualine theme [here](https://github.com/hoob3rt/lualine.nvim/blob/master/CONTRIBUTING.md#adding-a-theme)
|
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
### Changing separators
|
|
||||||
Lualine defines two kinds of seperators. One is for sections and other is for components. Default section seperators are '', '' and component separators are '', ''.
|
|
||||||
They require powerline patched fonts. But you can easily change yours to something else like below
|
|
||||||
|
|
||||||
```lua
|
|
||||||
options = {
|
options = {
|
||||||
section_separators = {'', ''},
|
icons_enabled = true,
|
||||||
component_separators = {'', ''}
|
theme = 'gruvbox',
|
||||||
}
|
component_separators = {'', ''},
|
||||||
```
|
section_separators = {'', ''},
|
||||||
|
disabled_filetypes = {}
|
||||||
or disable it
|
},
|
||||||
|
|
||||||
```lua
|
|
||||||
options = {section_separators = '', component_separators = ''}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Changing components in lualine sections
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary><b>Lualine defaults</b></summary>
|
|
||||||
|
|
||||||
```lua
|
|
||||||
sections = {
|
sections = {
|
||||||
lualine_a = {'mode'},
|
lualine_a = {'mode'},
|
||||||
lualine_b = {'branch'},
|
lualine_b = {'branch'},
|
||||||
|
@ -148,32 +103,88 @@ inactive_sections = {
|
||||||
lualine_x = {'location'},
|
lualine_x = {'location'},
|
||||||
lualine_y = {},
|
lualine_y = {},
|
||||||
lualine_z = {}
|
lualine_z = {}
|
||||||
|
},
|
||||||
|
tabline = {},
|
||||||
|
extensions = {}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details>
|
---
|
||||||
<summary><b>Available components</b></summary>
|
### Setting a theme
|
||||||
|
```lua
|
||||||
|
options = {theme = 'gruvbox'}
|
||||||
|
```
|
||||||
|
|
||||||
* branch (git branch)
|
All available themes are listed in [THEMES.md](./THEMES.md)
|
||||||
* diagnostics (diagnostics count from your prefered source)
|
|
||||||
* encoding (file encoding)
|
Please create a pr if you managed to port a popular theme before me, [here is how to do it](./CONTRIBUTING.md).
|
||||||
* fileformat (file format)
|
|
||||||
* filename
|
<details>
|
||||||
* filetype
|
<summary>Customizing themes</summary>
|
||||||
* hostname
|
|
||||||
* location (location in file in line:column format)
|
```lua
|
||||||
* mode (vim mode)
|
local custom_gruvbox = require'lualine.themes.gruvbox'
|
||||||
* progress (%progress in file)
|
-- Chnage the background of lualine_c section for normal mode
|
||||||
* diff (git diff status)
|
custom_gruvbox.normal.c.bg = '#112233' -- rgb colors are supported
|
||||||
|
require'lualine'.setup{
|
||||||
|
options = { theme = custom_gruvbox },
|
||||||
|
...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
Theme structure is available [here](https://github.com/hoob3rt/lualine.nvim/blob/master/CONTRIBUTING.md#adding-a-theme)
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details>
|
---
|
||||||
<summary><b>Using custom functions as lualine component</b></summary>
|
### Separators
|
||||||
|
Lualine defines two kinds of seperators:
|
||||||
|
* `section_separators` - separators between sections
|
||||||
|
* `components_separators` - separators between components in sections
|
||||||
|
|
||||||
You can define a custom function as a lualine component
|
```lua
|
||||||
|
options = {
|
||||||
|
section_separators = {'', ''},
|
||||||
|
component_separators = {'', ''}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
<details><summary>Disabling separators</summary>
|
||||||
|
|
||||||
|
```lua
|
||||||
|
options = {section_separators = '', component_separators = ''}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
### Changing components in lualine sections
|
||||||
|
|
||||||
|
```lua
|
||||||
|
sections = {lualine_a = {'mode'}}
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Available components</b></summary>
|
||||||
|
|
||||||
|
* `branch` (git branch)
|
||||||
|
* `diagnostics` (diagnostics count from your prefered source)
|
||||||
|
* `encoding` (file encoding)
|
||||||
|
* `fileformat` (file format)
|
||||||
|
* `filename`
|
||||||
|
* `filetype`
|
||||||
|
* `hostname`
|
||||||
|
* `location` (location in file in line:column format)
|
||||||
|
* `mode` (vim mode)
|
||||||
|
* `progress` (%progress in file)
|
||||||
|
* `diff` (git diff status)
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
#### Custom components
|
||||||
|
|
||||||
|
##### Lua functions as lualine component
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
local function hello()
|
local function hello()
|
||||||
|
@ -182,164 +193,84 @@ end
|
||||||
sections = {lualine_a = {hello}}
|
sections = {lualine_a = {hello}}
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
##### Vim functions as lualine component
|
||||||
|
|
||||||
<details>
|
|
||||||
|
|
||||||
<summary><b>Using vim functions as lualine component</b></summary>
|
|
||||||
|
|
||||||
You can use vim functions as a lualine component
|
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
sections = {lualine_a = {'FugitiveHead'}}
|
sections = {lualine_a = {'FugitiveHead'}}
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
##### Vim variables as lualine component
|
||||||
|
Variables from `g:`, `v:`, `t:`, `w:`, `b:`, `o`, `go:`, `vo:`, `to:`, `wo:`, `bo:` scopes can be used.
|
||||||
|
|
||||||
<details>
|
See `:h lua-vim-variables` and `:h lua-vim-options` if you are not sure what to use.
|
||||||
<summary><b>Using variables as lualine component</b></summary>
|
|
||||||
|
|
||||||
You can use variables from vim a lualine component
|
|
||||||
Variables from g:, v:, t:, w:, b:, o, go:, vo:, to:, wo:, bo: scopes
|
|
||||||
can be used. Scopes ending with o are options usualy accessed with `&` in vimscript
|
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
sections = {lualine_a = {'g:coc_status', 'bo:filetype'}}
|
sections = {lualine_a = {'g:coc_status', 'bo:filetype'}}
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
##### Lua expressions as lualine component
|
||||||
|
You can use any valid lua expression as a component including
|
||||||
<details>
|
* oneliners
|
||||||
<summary><b>Using lua expressions as lualine component</b></summary>
|
* global variables
|
||||||
|
* require statements
|
||||||
You can use any valid lua expression as a component . This allows global
|
|
||||||
variables to be used as a component too. Even require statements can be used to access values returned by specific scripts.
|
|
||||||
One liner functions can be inlined by utilizeing this .
|
|
||||||
|
|
||||||
For exmaple this will show day of the week.
|
|
||||||
And 2nd one will display current value of global variable data.
|
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
sections = {lualine_c = {"os.data('%a')", 'data'}}
|
sections = {lualine_c = {"os.data('%a')", 'data', require'lsp-status'.status}}
|
||||||
```
|
```
|
||||||
|
`data` is a global variable in this example.
|
||||||
|
|
||||||
</details>
|
---
|
||||||
|
### Component options
|
||||||
<details>
|
Component options can change the way a component behave.
|
||||||
<summary><b>Options for components</b></summary>
|
There are two kinds of options:
|
||||||
|
* global options affecting all components
|
||||||
### Available options:
|
* local options affecting specific
|
||||||
|
|
||||||
Options can change the way a component behave.
|
|
||||||
There are two kinds of options some that work on every kind of component.
|
|
||||||
Even the ones you create like custom function component . And some that only
|
|
||||||
work on specific component.
|
|
||||||
Detailed list of available options are given below.
|
|
||||||
|
|
||||||
#### Global options
|
|
||||||
These options are available for all components.
|
|
||||||
|
|
||||||
Option | Default | Behaviour | Supported components
|
|
||||||
:------: | :------: | :------: | :--------:
|
|
||||||
icons_enabled | true | Displays icons on components You should have nerd-fonts supported fonts to see icons properly. | branch, fileformat, filetype, location, diagnostics
|
|
||||||
icon | Differs for each component | Displays an icon in front of the component | All
|
|
||||||
padding | 1 | Adds padding to the left and right of components | All
|
|
||||||
left_padding | 1 | Adds padding to the left of components | All
|
|
||||||
right_padding | 1 | Adds padding to the right of components | All
|
|
||||||
separator | (component_separators) | which separator to use at end of component | all
|
|
||||||
upper | false | Changes components to be uppercase | All
|
|
||||||
lower | false | Changes components to be lowercase | All
|
|
||||||
format | nil | Takes a function . The funtion gets the result of component as argument and it's return value is displayed. So this function can parse and format the output as user wants. | All
|
|
||||||
condition | nil | Takes a function. The component is loaded if the function returns true otherwise not. It can be used to load some comoonents on specific cases. | All
|
|
||||||
color | nil | Sets custom color for the component in this format<br></br>`color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}`<br></br>The fields of color table are optional and default to theme <br></br>Color option can also be a string containing highlight group name `color = "WarningMsg"`. One neat trick set the color to highlight group name then change that highlight with :hi command to change color of that component at runtime. | All
|
|
||||||
disabled_filetypes | {} | Disables lualine for specific filetypes | It works on entire statusline instead of on a single component
|
|
||||||
|
|
||||||
#### Using global options
|
|
||||||
Global options can be set in two ways. One is as part of options table in setup.
|
|
||||||
|
|
||||||
|
Global options can be used as local options (can be applied to specific components)
|
||||||
|
but you cannot use local options as global.
|
||||||
|
Global option used locally overwrites the global, for example:
|
||||||
```lua
|
```lua
|
||||||
require'lualine'.setup {
|
require'lualine'.setup {
|
||||||
options = {
|
options = {lower = true},
|
||||||
icons_enabled = true,
|
sections = {lualine_a = {{'mode', lower = false}}, lualine_b = {'branch'}}
|
||||||
padding = 2,
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
When set this way these values work as default for all component.
|
|
||||||
These defaults can be overwritten by setting option as part of component
|
`mode` will be displayed with `lower = false` and `branch` will be displayed with `lower = true`
|
||||||
configuration like following.
|
|
||||||
|
#### Available options
|
||||||
|
<details>
|
||||||
|
<summary><b>Global options</b></summary>
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
lualine_a = {
|
options = {
|
||||||
-- Displays only first char of mode name
|
icons_enabled = 1, -- displays icons in alongside component
|
||||||
{'mode', format=function(mode_name) return mode_name:sub(1,1) end},
|
padding = 1, -- adds padding to the left and right of components
|
||||||
-- Disables icon for branch component
|
left_padding = 1, -- adds padding to the left of components
|
||||||
{'branch', icons_enabled=false},
|
right_padding =1, -- adds padding to the right of components
|
||||||
},
|
upper = false, -- displays components in uppercase
|
||||||
lualine_c = {
|
lower = false, -- displays components in lowercase
|
||||||
-- Displays filename only when window is wider then 80
|
format = nil -- format function, formats component's output
|
||||||
{'filename', condition=function() return vim.fn.winwidth(0) > 80 end},
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Component specific options
|
</details>
|
||||||
In addition, some components have unique options.
|
|
||||||
|
|
||||||
* `diagnostics` component options
|
<details>
|
||||||
|
<summary><b>Local options</b></summary>
|
||||||
|
|
||||||
Option | Default | Behaviour | Format
|
|
||||||
:------: | :------: | :----: | :---:
|
|
||||||
sources | `nil` | displays diagnostic count from defined source | array containing one or many string from set `{'nvim_lsp', 'coc', 'ale', 'vim_lsp'}`
|
|
||||||
sections | `{'error', 'warn', 'info'}` | displays diagnostics of defined severity | array containing one or many string from set `{'error', 'warn', 'info'}`
|
|
||||||
color_error | `DiffDelete` foreground color | changes diagnostic's error section foreground color | color in `#rrggbb` format
|
|
||||||
color_warn | `DiffText` foreground color | changes diagnostic's warn section foreground color | color in `#rrggbb` format
|
|
||||||
color_info | `Normal` foreground color | changes diagnostic's info section foreground color | color in `#rrggbb` format
|
|
||||||
symbols | `{error = ' ', warn = ' ', info = ' '}` or `{error = 'E:', warn = 'W:', info = 'I:'}` | changes diagnostic's info section foreground color | table containing one or more symbols for levels |
|
|
||||||
|
|
||||||
* `filename` component options
|
|
||||||
|
|
||||||
Option | Default | Behaviour
|
|
||||||
:------: | :------: | :----:
|
|
||||||
file_status | true | Displays file status (readonly status, modified status)
|
|
||||||
path | 0 | filename `path` option: 0 = just filename, 1 = relative path, 2 = absolute path
|
|
||||||
symbols | `{modified = '[+]', readonly = '[-]'}` | changes status symbols | table containing one or more symbols |
|
|
||||||
|
|
||||||
* `filetype` component options
|
|
||||||
|
|
||||||
Option | Default | Behaviour
|
|
||||||
:------: | :------: | :----:
|
|
||||||
colored | true | Displays filetype icon in color if set to `true`
|
|
||||||
|
|
||||||
* `diff` component options
|
|
||||||
|
|
||||||
Option | Default | Behaviour | Format
|
|
||||||
:------: | :------: | :----: | :---:
|
|
||||||
colored | true | displays diff status in color if set to `true` |
|
|
||||||
color_added | `DiffAdd` foreground color | changes diff's added section foreground color | color in `#rrggbb` format
|
|
||||||
color_modified | `DiffChange` foreground color | changes diff's changed section foreground color | color in `#rrggbb` format
|
|
||||||
color_removed | `DiffDelete` foreground color | changes diff's removed section foreground color | color in `#rrggbb` format
|
|
||||||
symbols | `{added = '+', modified = '~', removed = '-'}` | changes diff's symbols | table containing one or more symbols |
|
|
||||||
|
|
||||||
|
|
||||||
Component specific options can only be set with component configs.
|
|
||||||
|
|
||||||
##### Component options example
|
|
||||||
```lua
|
```lua
|
||||||
sections = {
|
sections = {
|
||||||
lualine_b = {
|
lualine_a = {
|
||||||
{'branch', icon = '', upper = true, color = {fg = '#00aa22'}}, {
|
{
|
||||||
'filename',
|
'mode',
|
||||||
full_name = true,
|
icon = nil, -- displays icon in front of the component
|
||||||
shorten = true,
|
separator = nil, -- overwrites component_separators for component
|
||||||
format = function(name)
|
condition = nil, -- condition function, component is loaded when function returns true
|
||||||
-- Capitalize first charecter of filename to capital.
|
-- custom color for component in format
|
||||||
local path, fname = name:match('(.*/)(.*)')
|
-- color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}
|
||||||
if not path then
|
-- or highlight group
|
||||||
path = '';
|
-- color = "WarningMsg"
|
||||||
fname = name
|
color = nil
|
||||||
end
|
|
||||||
return path .. fname:sub(1, 1):upper() .. fname:sub(2, #fname)
|
|
||||||
end
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -348,10 +279,81 @@ sections = {
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><b>Using tabline as statusline (statusline on top)</b></summary>
|
<summary><b>Component specific local options</b></summary>
|
||||||
You can use lualine to display components in tabline.
|
|
||||||
The sections, configurations and highlights are same as statusline.
|
|
||||||
|
|
||||||
|
#### `diagnostics` component options
|
||||||
|
|
||||||
|
```lua
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'diagnostics',
|
||||||
|
-- table of diagnostic sources, available sources:
|
||||||
|
-- nvim_lsp, coc, ale, vim_lsp
|
||||||
|
sources = nil,
|
||||||
|
-- displays diagnostics from defined severity
|
||||||
|
sections = {'error', 'warn', 'info'},
|
||||||
|
-- all colors are in format #rrggbb
|
||||||
|
color_error = nil, -- changes diagnostic's error foreground color
|
||||||
|
color_warn = nil, -- changes diagnostic's warn foreground color
|
||||||
|
color_info = nil, -- Changes diagnostic's info foreground color
|
||||||
|
symbols = {error = 'E', warn = 'W', info = 'I'}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `filename` component options
|
||||||
|
|
||||||
|
```lua
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'filename',
|
||||||
|
file_status = true, -- displays file status (readonly status, modified status)
|
||||||
|
path = 0 -- 0 = just filename, 1 = relative path, 2 = absolute path
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `filetype` component options
|
||||||
|
|
||||||
|
```lua
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'filetype',
|
||||||
|
colored = true -- displays filetype icon in color if set to `true`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `diff` component options
|
||||||
|
|
||||||
|
```lua
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'diff',
|
||||||
|
colored = true, -- displays diff status in color if set to true
|
||||||
|
-- all colors are in format #rrggbb
|
||||||
|
color_added = nil, -- changes diff's added foreground color
|
||||||
|
color_modified = nil, -- changes diff's modified foreground color
|
||||||
|
color_removed = nil, -- changes diff's removed foreground color
|
||||||
|
symbols = {added = '+', modified = '~', removed = '-'} -- changes diff symbols
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
### Tabline
|
||||||
|
You can use lualine to display components in tabline.
|
||||||
|
The configuration for tabline sections is exactly the same as for statusline.
|
||||||
```lua
|
```lua
|
||||||
tabline = {
|
tabline = {
|
||||||
lualine_a = {},
|
lualine_a = {},
|
||||||
|
@ -364,9 +366,9 @@ tabline = {
|
||||||
```
|
```
|
||||||
This will show branch and filename component in top of neovim inside tabline .
|
This will show branch and filename component in top of neovim inside tabline .
|
||||||
|
|
||||||
|
You can also completely move your statuline to tabline by configuring
|
||||||
|
`lualine.tabline` and disabling `lualine.sections` and `lualine.inactive_sections`.
|
||||||
|
|
||||||
You can also completely move your statuline to tabline by configuring lualine.tabline
|
|
||||||
instead of lualine.sections & lualine.inactive_sections and setting them to empty
|
|
||||||
```lua
|
```lua
|
||||||
tabline = {
|
tabline = {
|
||||||
......
|
......
|
||||||
|
@ -374,14 +376,16 @@ tabline = {
|
||||||
sections = {},
|
sections = {},
|
||||||
inactive_sections = {},
|
inactive_sections = {},
|
||||||
```
|
```
|
||||||
</details>
|
|
||||||
|
|
||||||
### Loading plugin extensions
|
---
|
||||||
Lualine extensions change statusline appearance for a window/buffer with a plugin loaded e.g. [junegunn/fzf.vim](https://github.com/junegunn/fzf.vim)
|
### Extensions
|
||||||
|
Lualine extensions change statusline appearance for a window/buffer with
|
||||||
|
specified filetypes.
|
||||||
|
|
||||||
By default no plugin extension are loaded to improve performance. If you are using a plugin which is supported you can load it this way:
|
By default no extension are loaded to improve performance.
|
||||||
|
You can load extensions with:
|
||||||
```lua
|
```lua
|
||||||
extensions = { 'fzf' }
|
extensions = {'quickfix'}
|
||||||
```
|
```
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
|
@ -396,6 +400,14 @@ extensions = { 'fzf' }
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
### Disabling lualine
|
||||||
|
You can disable lualine for specific filetypes
|
||||||
|
```lua
|
||||||
|
options = {disabled_filetypes = {'lua'}}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
### Lua config example
|
### Lua config example
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
|
|
637
doc/lualine.txt
637
doc/lualine.txt
|
@ -1,122 +1,87 @@
|
||||||
*lualine.txt* A blazing fast and easy to configure statusline
|
*lualine.txt* blazing fast and easy to configure statusline
|
||||||
*lualine_nvim* *lualine*
|
*lualine.nvim* *lualine*
|
||||||
|
|
||||||
Author: hoob3rt (https://github.com/hoob3rt)
|
|
||||||
License: MIT License
|
|
||||||
Repository: https://github.com/hoob3rt/lualine.nvim
|
|
||||||
|
|
||||||
===============================================================================
|
|
||||||
LUALINE.NVIM *lualine_lualine.nvim*
|
|
||||||
|
|
||||||
|
|
||||||
__ __ __ ______ __ __ __ __ ______
|
__ __ __ ______ __ __ __ __ ______
|
||||||
/\ \ /\ \/\ \ /\ __ \ /\ \ /\ \ /\ "-.\ \ /\ ___\
|
/\ \ /\ \/\ \ /\ __ \ /\ \ /\ \ /\ "-.\ \ /\ ___\
|
||||||
\ \ \____ \ \ \_\ \ \ \ __ \ \ \ \____ \ \ \ \ \ \-. \ \ \ __\
|
\ \ \____ \ \ \_\ \ \ \ __ \ \ \ \____ \ \ \ \ \ \-. \ \ \ __\
|
||||||
\ \_____\ \ \_____\ \ \_\ \_\ \ \_____\ \ \_\ \ \_\\"\_\ \ \_____\
|
\ \_____\ \ \_____\ \ \_\ \_\ \ \_____\ \ \_\ \ \_\\"\_\ \ \_____\
|
||||||
\/_____/ \/_____/ \/_/\/_/ \/_____/ \/_/ \/_/ \/_/ \/_____/
|
\/_____/ \/_____/ \/_/\/_/ \/_____/ \/_/ \/_/ \/_/ \/_____/
|
||||||
|
|
||||||
|
Author: hoob3rt (https://github.com/hoob3rt)
|
||||||
|
License: MIT License
|
||||||
|
Repository: https://github.com/hoob3rt/lualine.nvim
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
CONTENTS *lualine-contents*
|
||||||
|
|
||||||
|
1. lualine.nvim..........................................|lualine-lualine.nvim|
|
||||||
|
1.1. Usage and customization..............|lualine-usage_and_customization|
|
||||||
|
1.1.1 Starting lualine.........................|lualine-starting_lualine|
|
||||||
|
1.1.2 Setting a theme.....................................|lualine-theme|
|
||||||
|
1.1.3 Separators.....................................|lualine-separators|
|
||||||
|
1.1.4 Changing components............................|lualine-components|
|
||||||
|
1.1.5 Custom components.......................|lualine-custom_components|
|
||||||
|
1.1.6 Component options.......................|lualine-component_options|
|
||||||
|
1.1.7 Tabline...........................................|lualine-tabline|
|
||||||
|
1.1.8 Extensions.....................................|lualine-extensions|
|
||||||
|
1.2 Config examples..............................|lualine-config_examples|
|
||||||
|
1.2.1 Lua config example...................|lualine-lua_config_example|
|
||||||
|
1.2.2 Vimscript config example.......|lualine-vimscript_config_example|
|
||||||
|
|
||||||
A blazing fast and easy to configure neovim statusline written in pure lua.
|
==============================================================================
|
||||||
|
USAGE AND CUSTOMIZATION *lualine-usage_and_customization*
|
||||||
`lualine.nvim` requires neovim 0.5
|
|
||||||
|
|
||||||
================================================================================
|
|
||||||
CONTENTS *lualine_contents*
|
|
||||||
|
|
||||||
1. lualine.nvim...........................................|lualine_lualine.nvim|
|
|
||||||
1.1. Performance comparison.................|lualine_performance_comparison|
|
|
||||||
1.2. Installation.....................................|lualine_installation|
|
|
||||||
1.2.1. vim-plug.......................................|lualine_vim-plug|
|
|
||||||
1.2.2.packer.nvim..................................|lualine_packer.nvim|
|
|
||||||
1.3. Usage and customization...............|lualine_usage_and_customization|
|
|
||||||
1.3.1. Starting lualine.......................|lualine_starting_lualine|
|
|
||||||
1.3.2. Setting theme.............................|lualine_setting_theme|
|
|
||||||
1.3.3. Changing separator...................|lualine_changing_separator|
|
|
||||||
1.3.4. Changing components.................|lualine_changing_components|
|
|
||||||
1.3.5. Building Custom components............|lualine_custom_components|
|
|
||||||
1.3.6. Custom options...........................|lualine_custom_options|
|
|
||||||
1.3.7. Using tabline as statusline...............|lualine_using_tabline|
|
|
||||||
1.3.8. Loading plugin extensions.....|lualine_loading_plugin_extensions|
|
|
||||||
1.3.9 Config examples.........................|lualine_config_examples|
|
|
||||||
1.3.9.1. Packer.nvim......|lualine_config_example_using_packer.nvim|
|
|
||||||
1.3.9.2 VIML example.......|lualine_full_config_example_inside_viml|
|
|
||||||
1.4. Contributing.....................................|lualine_contributing|
|
|
||||||
1.5. Screenshots.......................................|lualine_screenshots|
|
|
||||||
|
|
||||||
================================================================================
|
|
||||||
PERFORMANCE COMPARISON *lualine_performance_comparison*
|
|
||||||
|
|
||||||
Unlike other statusline plugins lualine loads only defined components, nothing else.
|
|
||||||
|
|
||||||
Startup time performance measured with an amazing plugin
|
|
||||||
tweekmonster/startuptime.vim (https://github.com/tweekmonster/startuptime.vim)
|
|
||||||
|
|
||||||
All times are measured with only `startuptime.vim` and given statusline plugin
|
|
||||||
installed
|
|
||||||
|
|
||||||
| clean vimrc | lualine | lightline | airline |
|
|
||||||
| :------------: | :----------: | :----------: | :----------: |
|
|
||||||
| 8.943 ms | 9.034 ms | 11.463 ms | 13.425 ms |
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
INSTALLATION *lualine_installation*
|
|
||||||
|
|
||||||
VIM-PLUG *lualine_vim-plug*
|
|
||||||
>
|
|
||||||
Plug 'hoob3rt/lualine.nvim'
|
|
||||||
" If you want to have icons in your statusline choose one of these
|
|
||||||
Plug 'kyazdani42/nvim-web-devicons'
|
|
||||||
Plug 'ryanoasis/vim-devicons'
|
|
||||||
<
|
|
||||||
|
|
||||||
PACKER.NVIM *lualine_packer.nvim*
|
|
||||||
>
|
|
||||||
use {
|
|
||||||
'hoob3rt/lualine.nvim',
|
|
||||||
requires = {'kyazdani42/nvim-web-devicons', opt = true}
|
|
||||||
}
|
|
||||||
<
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
USAGE AND CUSTOMIZATION *lualine_usage_and_customization*
|
|
||||||
|
|
||||||
Lualine has sections as shown below.
|
Lualine has sections as shown below.
|
||||||
>
|
>
|
||||||
+-------------------------------------------------+
|
+-------------------------------------------------+
|
||||||
| A | B | C X | Y | Z |
|
| A | B | C X | Y | Z |
|
||||||
+-------------------------------------------------+
|
+-------------------------------------------------+
|
||||||
<
|
|
||||||
|
|
||||||
Each sections holds it's components e.g. current vim's mode.
|
Each sections holds it's components e.g. current vim's mode.
|
||||||
Colorscheme of sections is mirrored, meaning section `A` will have the same
|
|
||||||
colorscheme as section `Z` etc.
|
|
||||||
|
|
||||||
Configuration is currently limited to lua, please use lua block or a separate
|
------------------------------------------------------------------------------
|
||||||
lua file to configure lualine.
|
STARTING LUALINE *lualine-starting_lualine* *lualine.setup()*
|
||||||
|
|
||||||
STARTING LUALINE *lualine_starting_lualine*
|
|
||||||
>
|
>
|
||||||
require('lualine').setup{}
|
require('lualine').setup()
|
||||||
<
|
|
||||||
|
|
||||||
SETTING THEME *lualine_setting_theme*
|
Default config~
|
||||||
|
>
|
||||||
|
require'lualine'.setup {
|
||||||
|
options = {
|
||||||
|
icons_enabled = true,
|
||||||
|
theme = 'gruvbox',
|
||||||
|
component_separators = {'', ''},
|
||||||
|
section_separators = {'', ''},
|
||||||
|
disabled_filetypes = {}
|
||||||
|
},
|
||||||
|
sections = {
|
||||||
|
lualine_a = {'mode'},
|
||||||
|
lualine_b = {'branch'},
|
||||||
|
lualine_c = {'filename'},
|
||||||
|
lualine_x = {'encoding', 'fileformat', 'filetype'},
|
||||||
|
lualine_y = {'progress'},
|
||||||
|
lualine_z = {'location'}
|
||||||
|
},
|
||||||
|
inactive_sections = {
|
||||||
|
lualine_a = {},
|
||||||
|
lualine_b = {},
|
||||||
|
lualine_c = {'filename'},
|
||||||
|
lualine_x = {'location'},
|
||||||
|
lualine_y = {},
|
||||||
|
lualine_z = {}
|
||||||
|
},
|
||||||
|
tabline = {},
|
||||||
|
extensions = {}
|
||||||
|
}
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
SETTING A THEME *lualine-theme*
|
||||||
>
|
>
|
||||||
options = {theme = 'gruvbox'}
|
options = {theme = 'gruvbox'}
|
||||||
<
|
|
||||||
|
|
||||||
All available themes are listed in THEMES.md (./THEMES.md)
|
Available themes are listed here:
|
||||||
|
https://github.com/hoob3rt/lualine.nvim/blob/master/THEMES.md
|
||||||
|
|
||||||
Please create a pr if you managed to port a popular theme before me, here is
|
Customizing themes~
|
||||||
how to do it (./CONTRIBUTING.md).
|
|
||||||
|
|
||||||
Tweeking themes~
|
|
||||||
|
|
||||||
You like a theme but would like to tweek some colors.
|
|
||||||
You can do that in your config easily.
|
|
||||||
|
|
||||||
Example:
|
|
||||||
>
|
>
|
||||||
local custom_gruvbox = require'lualine.themes.gruvbox'
|
local custom_gruvbox = require'lualine.themes.gruvbox'
|
||||||
|
|
||||||
|
@ -128,348 +93,196 @@ Example:
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
<
|
<
|
||||||
You can checkout structure of a lualine theme [here](https://github.com/hoob3rt/lualine.nvim/blob/master/CONTRIBUTING.md#adding-a-theme)
|
Theme structure is available here:
|
||||||
|
https://github.com/hoob3rt/lualine.nvim/blob/master/CONTRIBUTING.md#adding-a-theme
|
||||||
|
|
||||||
CHANGING SEPARATOR IN SECTION *lualine_changing_separator*
|
------------------------------------------------------------------------------
|
||||||
|
SEPARATORS *lualine-separators*
|
||||||
|
|
||||||
Lualine defines two kinds of seperators. One is for sections and other is
|
Lualine defines two kinds of seperators:
|
||||||
for components. Default section seperators are '', '' and component
|
* |section_separators| - separators between sections
|
||||||
separators are '', ''.They require powerline patched fonts. But you can
|
* |components_separators| - separators between components in sections
|
||||||
easily change yours to something else like below.
|
|
||||||
>
|
>
|
||||||
options = {
|
options = {
|
||||||
section_separators = {'', ''},
|
section_separators = {'', ''},
|
||||||
component_separators = {'', ''}
|
component_separators = {'', ''}
|
||||||
}
|
}
|
||||||
|
|
||||||
or disable it
|
Disabling separators~
|
||||||
>
|
>
|
||||||
options = {section_separators = '', component_separators = ''}
|
options = {section_separators = '', component_separators = ''}
|
||||||
<
|
|
||||||
|
|
||||||
CHANGING COMPONENTS IN LUALINE SECTIONS *lualine_changing_components*
|
|
||||||
|
|
||||||
|
|
||||||
Lualine defaults~
|
|
||||||
>
|
|
||||||
sections = {
|
|
||||||
lualine_a = { 'mode' },
|
|
||||||
lualine_b = { 'branch' },
|
|
||||||
lualine_c = { 'filename' },
|
|
||||||
lualine_x = { 'encoding', 'fileformat', 'filetype' },
|
|
||||||
lualine_y = { 'progress' },
|
|
||||||
lualine_z = { 'location' },
|
|
||||||
}
|
|
||||||
inactive_sections = {
|
|
||||||
lualine_a = { },
|
|
||||||
lualine_b = { },
|
|
||||||
lualine_c = { 'filename' },
|
|
||||||
lualine_x = { 'location' },
|
|
||||||
lualine_y = { },
|
|
||||||
lualine_z = { }
|
|
||||||
}
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
CHANGING COMPONENTS IN LUALINE SECTIONS *lualine-components*
|
||||||
|
|
||||||
|
`sections = {lualine_a = {'mode'}}`
|
||||||
|
|
||||||
Available components~
|
Available components~
|
||||||
|
|
||||||
general~
|
general~
|
||||||
* branch (git branch)
|
* |branch| (git branch)
|
||||||
* diagnostics (diagnostics count from your prefered source)
|
* |diagnostics| (diagnostics count from your preferred source)
|
||||||
* encoding (file encoding)
|
* |encoding| (file encoding)
|
||||||
* fileformat (file format)
|
* |fileformat| (file format)
|
||||||
* filename
|
* |filename|
|
||||||
* filetype
|
* |filetype|
|
||||||
* hostname
|
* |hostname|
|
||||||
* location (location in file in line:column format)
|
* |location| (location in file in line:column format)
|
||||||
* mode (vim mode)
|
* |mode| (vim mode)
|
||||||
* progress (%progress in file)
|
* |progress| (%progress in file)
|
||||||
* diff (git diff status)
|
* |diff| (git diff status)
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
CUSTOM COMPONENTS *lualine-custom_components*
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
Lua functions as lualine component~
|
||||||
BUILDING YOUR COMPONENTS *lualine_custom_components*
|
|
||||||
|
|
||||||
|
|
||||||
Using custom functions as lualine component~
|
|
||||||
|
|
||||||
You can define a custom function as a lualine component
|
|
||||||
>
|
>
|
||||||
local function hello()
|
local function hello()
|
||||||
return [[hello world]]
|
return [[hello world]]
|
||||||
end
|
end
|
||||||
sections = {lualine_a = {hello}}
|
sections = {lualine_a = {hello}}
|
||||||
<
|
<
|
||||||
Using vim functions as lualine component~
|
Vim functions as lualine component~
|
||||||
|
|
||||||
You can use vim functions as a lualine component
|
|
||||||
|
|
||||||
>
|
>
|
||||||
sections = {lualine_a = {'FugitiveHead'}}
|
sections = {lualine_a = {'FugitiveHead'}}
|
||||||
<
|
<
|
||||||
|
Vim variables as lualine component~
|
||||||
|
|
||||||
Using variables as lualine component~
|
Variables from `g:`, `v:`, `t:`, `w:`, `b:`, `o`, `go:`, `vo:`, `to:`, `wo:`, `bo:` scopes can be used.
|
||||||
|
See `:h lua-vim-variables` and `:h lua-vim-options` if you are not sure what to use.
|
||||||
You can use variables from vim. Variables from g:, v:, t:,
|
|
||||||
w:, b:, o, go:, vo:, to:, wo:, bo: scopes can be used.
|
|
||||||
Scopes ending with o are options usualy accessed with `&` in
|
|
||||||
vimscript
|
|
||||||
|
|
||||||
>
|
>
|
||||||
sections = {lualine_a = {'g:coc_status', 'bo:filetype'}}
|
sections = {lualine_a = {'g:coc_status', 'bo:filetype'}}
|
||||||
<
|
<
|
||||||
Using lua expressions as lualine component~
|
Lua expressions as lualine component~
|
||||||
|
|
||||||
You can use any valid lua expression as a component . This
|
You can use any valid lua expression as a component including
|
||||||
allows global variables to be used as a component too. Even
|
* oneliners
|
||||||
require statements can be used to access values returned by
|
* global variables
|
||||||
specific scripts. One liner functions can be inlined by
|
* require statements
|
||||||
utilizeing this .
|
|
||||||
|
|
||||||
For exmaple this will show day of the week. And 2nd one
|
|
||||||
will display current value of global variabke data.
|
|
||||||
>
|
>
|
||||||
sections = {lualine_c = {"os.data('%a')", 'data'}}
|
sections = {lualine_c = {"os.data('%a')", 'data', require'lsp-status'.status}}
|
||||||
<
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
`data` is a global variable in this example.
|
||||||
CUSTOM OPTIONS FOR COMPONENTS *lualine_custom_options*
|
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
COMPONENT OPTIONS *lualine-component_options*
|
||||||
|
|
||||||
Options for components~
|
Component options can change the way a component behave.
|
||||||
======================
|
There are two kinds of options:
|
||||||
|
* global options affecting all components
|
||||||
|
* local options affecting specific
|
||||||
|
|
||||||
|
Global options can be used as local options (can be applied to specific components)
|
||||||
|
but you cannot use local options as global.
|
||||||
|
Global option used locally overwrites the global, for example:
|
||||||
|
>
|
||||||
|
require'lualine'.setup {
|
||||||
|
options = {lower = true},
|
||||||
|
sections = {lualine_a = {{'mode', lower = false}}, lualine_b = {'branch'}}
|
||||||
|
}
|
||||||
|
|
||||||
|
`mode` will be displayed with `lower = false` and `branch` will be displayed with `lower = true`
|
||||||
|
|
||||||
Available options:~
|
Available options:~
|
||||||
|
|
||||||
Options can change the way a component behave.
|
|
||||||
There are two kinds of options some that work on every kind of component.
|
|
||||||
Even the ones you create like custom function component . And some that only
|
|
||||||
work on specific component.
|
|
||||||
Detailed list of available options are given below.
|
|
||||||
|
|
||||||
Global options~
|
Global options~
|
||||||
|
|
||||||
These options are available for all components.
|
|
||||||
|
|
||||||
option (default_value)
|
|
||||||
------ ---------------
|
|
||||||
|
|
||||||
• icons_enabled (true)
|
|
||||||
Displays icons on components
|
|
||||||
You should have nerd-fonts supported fonts to see icons properly.
|
|
||||||
Supported components: branch, fileformat, filetype, location, diagnostics
|
|
||||||
|
|
||||||
• icon (depends on component)
|
|
||||||
displays an icon infront of a component
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• padding (1)
|
|
||||||
spaces on left and right
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• left_padding (1)
|
|
||||||
spaces on left
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• right_padding (1)
|
|
||||||
spaces on right
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• separator (component_separators)
|
|
||||||
which separator to use at end of component
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• upper (false)
|
|
||||||
Displayed in upper case
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• lower (false)
|
|
||||||
Displayed in lower case
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• format (nil)
|
|
||||||
Takes a function . The funtion gets the result of component
|
|
||||||
as argument and it's return value is displayed. So this function
|
|
||||||
can parse and format the output as user wants.
|
|
||||||
Supported components: all
|
|
||||||
|
|
||||||
• disabled_filetypes ({})
|
|
||||||
Disables lualine for specific filetypes. It works on entire
|
|
||||||
statusline instead of on a single component.
|
|
||||||
|
|
||||||
Example:
|
|
||||||
`lualine.options.icons_enabled = true`
|
|
||||||
|
|
||||||
|
|
||||||
Component specific options
|
|
||||||
---------------
|
---------------
|
||||||
As mentioned above, all global options can be applied to specific components.
|
|
||||||
However there are some options which are component-only (you cannot set them as globals)
|
|
||||||
|
|
||||||
option (default_value)
|
|
||||||
------ ---------------
|
|
||||||
|
|
||||||
• icon (differs for each component)
|
|
||||||
displays an icon infront of a component
|
|
||||||
|
|
||||||
• condition (nil)
|
|
||||||
Takes a function. The component is loaded if the function
|
|
||||||
returns true otherwise not. It can be used to load some
|
|
||||||
comoonents on specific cases.
|
|
||||||
|
|
||||||
• color (Theme colors)
|
|
||||||
color option can be used to set custom color to a component
|
|
||||||
Color format:
|
|
||||||
`lua color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}`
|
|
||||||
the members of color table are optional and default to theme
|
|
||||||
Color option can also be a string containing highlight group name >
|
|
||||||
color = "WarningMsg"`
|
|
||||||
< One neat trick set the color to highlight group name then change
|
|
||||||
that highlight with :hi command to change color of that component
|
|
||||||
at runtime.
|
|
||||||
|
|
||||||
Using global options~
|
|
||||||
|
|
||||||
Global options can be set in two ways. One is as part of options table in setup.
|
|
||||||
|
|
||||||
>
|
>
|
||||||
require'lualine'.setup{
|
|
||||||
options = {
|
options = {
|
||||||
icons_enabled = true,
|
icons_enabled = 1, -- displays icons in alongside component
|
||||||
padding = 2,
|
padding = 1, -- adds padding to the left and right of components
|
||||||
|
left_padding = 1, -- adds padding to the left of components
|
||||||
|
right_padding =1, -- adds padding to the right of components
|
||||||
|
upper = false, -- displays components in uppercase
|
||||||
|
lower = false, -- displays components in lowercase
|
||||||
|
format = nil -- format function, formats component's output
|
||||||
}
|
}
|
||||||
}
|
|
||||||
<
|
|
||||||
When set this way these values work as default for all component.
|
|
||||||
These defaults can be overwritten by setting option as part of component
|
|
||||||
configuration like following.
|
|
||||||
|
|
||||||
>
|
Local options~
|
||||||
lualine_a = {
|
---------------
|
||||||
-- Displays only first char of mode name
|
|
||||||
{'mode', format=function(mode_name) return mode_name:sub(1,1) end},
|
|
||||||
-- Disables icon for branch component
|
|
||||||
{'branch', icons_enabled=false},
|
|
||||||
},
|
|
||||||
lualine_c = {
|
|
||||||
-- Displays filename only when window is wider then 80
|
|
||||||
{'filename', condition=function() return vim.fn.winwidth(0) > 80 end},
|
|
||||||
}
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
Component specific options~
|
|
||||||
|
|
||||||
In addition, some components have unique options.
|
|
||||||
|
|
||||||
• diagnostics~
|
|
||||||
• sources (nil)
|
|
||||||
displays diagnostic count from defined source.
|
|
||||||
array containing one or many string from set
|
|
||||||
{'nvim_lsp', 'coc', 'ale', 'vim_lsp'}
|
|
||||||
|
|
||||||
• sections ({'error', 'warn', 'info'})
|
|
||||||
displays diagnostics of defined severity.
|
|
||||||
array containing one or many string from set
|
|
||||||
{'error', 'warn', 'info'}
|
|
||||||
|
|
||||||
• color_error (DiffDelete foreground color)
|
|
||||||
changes diagnostic's error section foreground color.
|
|
||||||
color in #rrggbb format
|
|
||||||
|
|
||||||
• color_warn (DiffText foreground color)
|
|
||||||
changes diagnostic's warn section foreground color
|
|
||||||
color in #rrggbb format
|
|
||||||
|
|
||||||
• color_info (Normal foreground color)
|
|
||||||
changes diagnostic's info section foreground color
|
|
||||||
color in #rrggbb format
|
|
||||||
|
|
||||||
• symbols
|
|
||||||
(icons_enabled: true -> {error = ' ', warn = ' ', info = ' '})
|
|
||||||
(icons_enabled: false -> {error = 'E:', warn = 'W:', info = 'I:'})
|
|
||||||
changes diagnostic's symbol characters. You can set one or more symbols
|
|
||||||
for each level.
|
|
||||||
>
|
|
||||||
{
|
|
||||||
'diagnostics',
|
|
||||||
symbols = {
|
|
||||||
-- set the error symbol and use defaults for warn and info.
|
|
||||||
error = '!!',
|
|
||||||
},
|
|
||||||
}
|
|
||||||
<
|
|
||||||
|
|
||||||
• filename~
|
|
||||||
• file_status (true)
|
|
||||||
Displays file status (readonly status, modified status)
|
|
||||||
|
|
||||||
• path (0)
|
|
||||||
filename `path` option: 0 = just filename, 1 = relative path, 2 = absolute path
|
|
||||||
|
|
||||||
• symbols (`{modified = '[+]', readonly = '[-]'}`)
|
|
||||||
changes status symbols
|
|
||||||
|
|
||||||
• filetype~
|
|
||||||
• colored (true)
|
|
||||||
Displays filetype icon in color if set to `true`
|
|
||||||
|
|
||||||
• fileformat~
|
|
||||||
• icons_enabled (true)
|
|
||||||
Whether to displays icon before component. Colors
|
|
||||||
are automaticaly extracted from colorscheme . If you
|
|
||||||
want to change any of those you can use options given below.
|
|
||||||
|
|
||||||
• diff~
|
|
||||||
• colored (true)
|
|
||||||
displays diff status in color if set to `true`
|
|
||||||
|
|
||||||
• color_added (DiffAdd foreground color)
|
|
||||||
Changes diff's added section foreground color
|
|
||||||
Color in `#rrggbb` format
|
|
||||||
|
|
||||||
• color_modified (DiffChange foreground color)
|
|
||||||
Changes diff's changed section foreground color
|
|
||||||
Color in `#rrggbb` format
|
|
||||||
|
|
||||||
• color_removed (DiffDelete foreground color)
|
|
||||||
Changes diff's removed section foreground color
|
|
||||||
Color in `#rrggbb` format
|
|
||||||
|
|
||||||
• symbols (`{added = '+', modified = '~', removed = '-'}`)
|
|
||||||
changes diff's symbols
|
|
||||||
Color in `#rrggbb` format
|
|
||||||
<
|
|
||||||
Component specific options can only be set with component configs.
|
|
||||||
|
|
||||||
Example:~
|
|
||||||
>
|
>
|
||||||
sections = {
|
sections = {
|
||||||
lualine_b = {
|
lualine_a = {
|
||||||
{'branch', icon = '', upper = true, color = {fg = '#00aa22'}}, {
|
{
|
||||||
|
'mode',
|
||||||
|
icon = nil, -- displays icon in front of the component
|
||||||
|
separator = nil, -- overwrites component_separators for component
|
||||||
|
condition = nil, -- condition function, component is loaded when function returns true
|
||||||
|
-- custom color for component in format
|
||||||
|
-- color = {fg = '#rrggbb', bg= '#rrggbb', gui='style'}
|
||||||
|
-- or highlight group
|
||||||
|
-- color = "WarningMsg"
|
||||||
|
color = nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Component specific local options~
|
||||||
|
---------------
|
||||||
|
|
||||||
|
* diagnostics~
|
||||||
|
>
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'diagnostics',
|
||||||
|
-- table of diagnostic sources, available sources:
|
||||||
|
-- nvim_lsp, coc, ale, vim_lsp
|
||||||
|
sources = nil,
|
||||||
|
-- displays diagnostics from defined severity
|
||||||
|
sections = {'error', 'warn', 'info'},
|
||||||
|
-- all colors are in format #rrggbb
|
||||||
|
color_error = nil, -- changes diagnostic's error foreground color
|
||||||
|
color_warn = nil, -- changes diagnostic's warn foreground color
|
||||||
|
color_info = nil, -- Changes diagnostic's info foreground color
|
||||||
|
symbols = {error = 'E', warn = 'W', info = 'I'}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
* filename~
|
||||||
|
>
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
'filename',
|
'filename',
|
||||||
full_name = true,
|
file_status = true, -- displays file status (readonly status, modified status)
|
||||||
shorten = true,
|
path = 0 -- 0 = just filename, 1 = relative path, 2 = absolute path
|
||||||
format = function(name)
|
|
||||||
-- Capitalize first charecter of filename to capital.
|
|
||||||
local path, fname = name:match('(.*/)(.*)')
|
|
||||||
if not path then
|
|
||||||
path = '';
|
|
||||||
fname = name
|
|
||||||
end
|
|
||||||
return path .. fname:sub(1, 1):upper() .. fname:sub(2, #fname)
|
|
||||||
end
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
-------------------------------------------------------------------------------
|
|
||||||
USING TABLINE AS STATUSLINE *lualine_using_tabline*
|
* filetype~
|
||||||
|
>
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'filetype',
|
||||||
|
colored = true -- displays filetype icon in color if set to `true`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
* diff~
|
||||||
|
>
|
||||||
|
sections = {
|
||||||
|
lualine_a = {
|
||||||
|
{
|
||||||
|
'diff',
|
||||||
|
colored = true, -- displays diff status in color if set to true
|
||||||
|
-- all colors are in format #rrggbb
|
||||||
|
color_added = nil, -- changes diff's added foreground color
|
||||||
|
color_modified = nil, -- changes diff's modified foreground color
|
||||||
|
color_removed = nil, -- changes diff's removed foreground color
|
||||||
|
symbols = {added = '+', modified = '~', removed = '-'} -- changes diff symbols
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
TABLINE *lualine-tabline*
|
||||||
|
|
||||||
You can use lualine to display components in tabline.
|
You can use lualine to display components in tabline.
|
||||||
The sections, configurations and highlights are same as statusline.
|
The configuration for tabline sections is exactly the same as for statusline.
|
||||||
|
|
||||||
>
|
>
|
||||||
tabline = {
|
tabline = {
|
||||||
lualine_a = {},
|
lualine_a = {},
|
||||||
|
@ -480,43 +293,49 @@ The sections, configurations and highlights are same as statusline.
|
||||||
lualine_z = {},
|
lualine_z = {},
|
||||||
}
|
}
|
||||||
<
|
<
|
||||||
This will show branch and filename component in top of neovim inside tabline .
|
This will show branch and filename component on top of neovim inside tabline.
|
||||||
|
|
||||||
You can also completely move your statuline to tabline by configuring lualine.tabline
|
You can also completely move your statuline to tabline by configuring
|
||||||
instead of lualine.sections & lualine.inactive_sections and setting them to empty
|
|lualine.tabline| and disabling |lualine.sections| and |lualine.inactive_sections|.
|
||||||
>
|
>
|
||||||
tabline = {
|
tabline = {
|
||||||
......
|
......
|
||||||
}
|
}
|
||||||
sections = {}
|
sections = {}
|
||||||
inactive_sections = {}
|
inactive_sections = {}
|
||||||
<
|
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
--------------------------------------------------------------------------------
|
EXTENSIONS *lualine-extensions*
|
||||||
LOADING PLUGIN EXTENSIONS *lualine_loading_plugin_extensions*
|
|
||||||
|
|
||||||
Lualine extensions change statusline appearance for a window/buffer with
|
Lualine extensions change statusline appearance for a window/buffer with
|
||||||
a plugin loaded e.g. junegunn/fzf.vim (https://github.com/junegunn/fzf.vim)
|
specified filetypes.
|
||||||
|
|
||||||
By default no plugin extension are loaded to improve performance. If you are
|
By default no extension are loaded to improve performance.
|
||||||
using a plugin which is supported you can load it this way:
|
You can load extensions with:
|
||||||
>
|
>
|
||||||
extensions = { 'fzf' }
|
extensions = {'quickfix'}
|
||||||
<
|
<
|
||||||
|
|
||||||
Available extensions
|
Available extensions
|
||||||
* chadtree
|
* |chadtree|
|
||||||
* fugitive
|
* |fugitive|
|
||||||
* fzf
|
* |fzf|
|
||||||
* nerdtree
|
* |nerdtree|
|
||||||
* nvim-tree
|
* |nvim-tree|
|
||||||
* quickfix
|
* |quickfix|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
==============================================================================
|
||||||
CONGIG EXAMPLES *lualine_config_examples*
|
DISABLING LUALINE *lualine-disable*
|
||||||
|
|
||||||
Lua config example
|
You can disable lualine for specific filetypes
|
||||||
|
|
||||||
|
`options = {disabled_filetypes = {'lua'}}`
|
||||||
|
|
||||||
|
==============================================================================
|
||||||
|
|
||||||
|
CONGIG EXAMPLES *lualine-config_examples*
|
||||||
|
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
LUA CONFIG EXAMPLE *lualine-lua_config_example*
|
||||||
>
|
>
|
||||||
use {
|
use {
|
||||||
'hoob3rt/lualine.nvim',
|
'hoob3rt/lualine.nvim',
|
||||||
|
@ -551,8 +370,8 @@ Lua config example
|
||||||
end
|
end
|
||||||
}
|
}
|
||||||
<
|
<
|
||||||
--------------------------------------------------------------------------------
|
------------------------------------------------------------------------------
|
||||||
Vimscript config example
|
VIMSCRIPT CONFIG EXAMPLE *lualine-vimscript_config_example*
|
||||||
>
|
>
|
||||||
let g:lualine = {
|
let g:lualine = {
|
||||||
\'options' : {
|
\'options' : {
|
||||||
|
@ -582,5 +401,5 @@ Vimscript config example
|
||||||
\}
|
\}
|
||||||
lua require("lualine").setup()
|
lua require("lualine").setup()
|
||||||
<
|
<
|
||||||
-------------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
vim:tw=80:sw=4:ts=8:noet:ft=help:norl:et:
|
vim:tw=80:sw=4:ts=8:noet:ft=help:norl:et:
|
||||||
|
|
Loading…
Reference in New Issue