chore: generated vimdoc (#115)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
9ef93d6ed6
commit
6aea9c640f
128
doc/zenbones.txt
128
doc/zenbones.txt
@@ -4,10 +4,10 @@
|
|||||||
Table of Contents *zenbones-table-of-contents*
|
Table of Contents *zenbones-table-of-contents*
|
||||||
|
|
||||||
1. Documentation |zenbones-documentation|
|
1. Documentation |zenbones-documentation|
|
||||||
- Requirement |zenbones-requirement|
|
- Requirement |zenbones-documentation-requirement|
|
||||||
- Usage |zenbones-usage|
|
- Usage |zenbones-documentation-usage|
|
||||||
- Configuration |zenbones-configuration|
|
- Configuration |zenbones-documentation-configuration|
|
||||||
- Advanced Usage |zenbones-advanced-usage|
|
- Advanced Usage |zenbones-documentation-advanced-usage|
|
||||||
|
|
||||||
==============================================================================
|
==============================================================================
|
||||||
1. Documentation *zenbones-documentation*
|
1. Documentation *zenbones-documentation*
|
||||||
@@ -15,17 +15,18 @@ Table of Contents *zenbones-table-of-contents*
|
|||||||
A collection of Vim/Neovim colorschemes designed to highlight code using
|
A collection of Vim/Neovim colorschemes designed to highlight code using
|
||||||
contrasts and font variations.
|
contrasts and font variations.
|
||||||
|
|
||||||
REQUIREMENT *zenbones-requirement*
|
|
||||||
|
REQUIREMENT *zenbones-documentation-requirement*
|
||||||
|
|
||||||
|
|
||||||
- Neovim v0.8.0 (use v2.0.0 for older versions) or Vim 8.1
|
- Neovim v0.8.0 (use v2.0.0 for older versions) or Vim 8.1
|
||||||
|
|
||||||
|
|
||||||
USAGE *zenbones-usage*
|
USAGE *zenbones-documentation-usage*
|
||||||
|
|
||||||
Just apply the colorscheme as usual:
|
Just apply the colorscheme as usual:
|
||||||
|
|
||||||
>
|
>vim
|
||||||
set termguicolors
|
set termguicolors
|
||||||
set background=light " or dark
|
set background=light " or dark
|
||||||
|
|
||||||
@@ -47,95 +48,120 @@ Just apply the colorscheme as usual:
|
|||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
CONFIGURATION *zenbones-configuration*
|
CONFIGURATION *zenbones-documentation-configuration*
|
||||||
|
|
||||||
Configuration is only available for Neovim. There are two ways to set
|
Configuration is only available for Neovim. There are two ways to set
|
||||||
configuration. First:
|
configuration. First:
|
||||||
|
|
||||||
>
|
>vim
|
||||||
" vimscript
|
" vimscript
|
||||||
let g:zenbones_solid_line_nr = v:true
|
let g:zenbones_solid_line_nr = v:true
|
||||||
let g:zenbones_darken_comments = 45
|
let g:zenbones_darken_comments = 45
|
||||||
<
|
<
|
||||||
|
|
||||||
|
>lua
|
||||||
>
|
|
||||||
-- lua
|
-- lua
|
||||||
vim.g.zenbones_solid_line_nr = true
|
vim.g.zenbones_solid_line_nr = true
|
||||||
vim.g.zenbones_darken_comments = 45
|
vim.g.zenbones_darken_comments = 45
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
Second way is to set configuration is to assign a dictionary to the prefix:
|
Second way is to set configuration is to assign a dictionary to the prefix:
|
||||||
|
|
||||||
>
|
>vim
|
||||||
" vimscript
|
" vimscript
|
||||||
let g:forestbones = #{ solid_line_nr: v:true, darken_comments: 45 }
|
let g:forestbones = #{ solid_line_nr: v:true, darken_comments: 45 }
|
||||||
<
|
<
|
||||||
|
|
||||||
|
>lua
|
||||||
>
|
|
||||||
-- lua
|
-- lua
|
||||||
vim.g.forestbones = { solid_line_nr = true, darken_comments = 45 }
|
vim.g.forestbones = { solid_line_nr = true, darken_comments = 45 }
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
**Notes**: Flavors accept their own configuration by replacing the prefix with
|
**Notes**: Flavors accept their own configuration by replacing the prefix with
|
||||||
the flavor name e.g. `g:rosebones_italic_comments`.
|
the flavor name e.g. `g:rosebones_italic_comments`.
|
||||||
|
|
||||||
│ Option │Background│ Default │ Description │
|
-----------------------------------------------------------------------------------------------------
|
||||||
│lightness │light │nil │Change background colors lightness. Options: 'bright', 'dim'. │
|
Option Background Default Description
|
||||||
│darkness │dark │nil │Change background colors darkness. Options: 'stark', 'warm'. │
|
------------------------------------ ------------ --------- -----------------------------------------
|
||||||
│solid_vert_split │both │false │Solid |hl-VertSplit| background. │
|
lightness light nil Change background colors lightness.
|
||||||
│solid_line_nr │both │false │Solid |hl-LineNr| background. │
|
Options: 'bright', 'dim'.
|
||||||
│solid_float_border │both │false │Make |hl-FloatBorder| have a more distinguishable background highlight.│
|
|
||||||
│darken_noncurrent_window │light │false │Make non-current window background darker than _Normal_. │
|
|
||||||
│lighten_noncurrent_window │dark │false │Make non-current window background lighter than _Normal_. │
|
|
||||||
│italic_comments │both │true │Make comments italicize. │
|
|
||||||
│darken_comments │light │38 │Percentage to darken comments relative to Normal bg. │
|
|
||||||
│lighten_comments │dark │38 │Percentage to lighten comments relative to Normal bg. │
|
|
||||||
│darken_non_text │light │25 │Percentage to darken |hl-NonText| relative to Normal bg. │
|
|
||||||
│lighten_non_text │dark │30 │Percentage to lighten |hl-NonText| relative to Normal bg. │
|
|
||||||
│darken_line_nr │light │33 │Percentage to darken |hl-LineNr| relative to Normal bg. │
|
|
||||||
│lighten_line_nr │dark │35 │Percentage to lighten |hl-LineNr| relative to Normal bg. │
|
|
||||||
│darken_cursor_line │light │3 │Percentage to darken |hl-CursorLine| relative to Normal bg. │
|
|
||||||
│lighten_cursor_line │dark │4 │Percentage to lighten |hl-CursorLine| relative to Normal bg. │
|
|
||||||
│colorize_diagnostic_underline_text│both │false │Colorize the fg of DiagnosticUnderline*. │
|
|
||||||
│transparent_background │both │false │Make background transparent. │
|
|
||||||
|
|
||||||
|
darkness dark nil Change background colors darkness.
|
||||||
|
Options: 'stark', 'warm'.
|
||||||
|
|
||||||
*zenbones-g:bones_compat*
|
solid_vert_split both false Solid |hl-VertSplit| background.
|
||||||
|
|
||||||
g:bones_compat Set to `1` to enable compatibility mode
|
solid_line_nr both false Solid |hl-LineNr| background.
|
||||||
for all colorschemes. Enabled in Vim. To
|
|
||||||
enable/disable compatibility mode for a
|
solid_float_border both false Make |hl-FloatBorder| have a more
|
||||||
specific theme, set the variable
|
distinguishable background highlight.
|
||||||
`g:{theme}_compat` to `0` or `1`,
|
|
||||||
e.g. `let g:zenbones_compat = 1`.
|
darken_noncurrent_window light false Make non-current window background darker
|
||||||
|
than Normal.
|
||||||
|
|
||||||
|
lighten_noncurrent_window dark false Make non-current window background
|
||||||
|
lighter than Normal.
|
||||||
|
|
||||||
|
italic_comments both true Make comments italicize.
|
||||||
|
|
||||||
|
darken_comments light 38 Percentage to darken comments relative to
|
||||||
|
Normal bg.
|
||||||
|
|
||||||
|
lighten_comments dark 38 Percentage to lighten comments relative
|
||||||
|
to Normal bg.
|
||||||
|
|
||||||
|
darken_non_text light 25 Percentage to darken |hl-NonText|
|
||||||
|
relative to Normal bg.
|
||||||
|
|
||||||
|
lighten_non_text dark 30 Percentage to lighten |hl-NonText|
|
||||||
|
relative to Normal bg.
|
||||||
|
|
||||||
|
darken_line_nr light 33 Percentage to darken |hl-LineNr| relative
|
||||||
|
to Normal bg.
|
||||||
|
|
||||||
|
lighten_line_nr dark 35 Percentage to lighten |hl-LineNr|
|
||||||
|
relative to Normal bg.
|
||||||
|
|
||||||
|
darken_cursor_line light 3 Percentage to darken |hl-CursorLine|
|
||||||
|
relative to Normal bg.
|
||||||
|
|
||||||
|
lighten_cursor_line dark 4 Percentage to lighten |hl-CursorLine|
|
||||||
|
relative to Normal bg.
|
||||||
|
|
||||||
|
colorize_diagnostic_underline_text both false Colorize the fg of DiagnosticUnderline*.
|
||||||
|
|
||||||
|
transparent_background both false Make background transparent.
|
||||||
|
-----------------------------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
G:BONES_COMPAT
|
||||||
|
|
||||||
|
Set to `1` to enable compatibility mode for all colorschemes. Enabled in Vim.
|
||||||
|
To enable/disable compatibility mode for a specific theme, set the variable
|
||||||
|
`g:{theme}_compat` to `0` or `1`, e.g. `let g:zenbones_compat = 1`.
|
||||||
|
|
||||||
|
|
||||||
LIGHTLINE ~
|
LIGHTLINE ~
|
||||||
|
|
||||||
>
|
>vim
|
||||||
let g:lightline = #{ colorscheme: 'zenbones' } " or any other flavor
|
let g:lightline = #{ colorscheme: 'zenbones' } " or any other flavor
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
LUALINE ~
|
LUALINE ~
|
||||||
|
|
||||||
>
|
>lua
|
||||||
require("lualine").setup {
|
require("lualine").setup {
|
||||||
options = { theme = "zenbones" }, -- or any other flavor
|
options = { theme = "zenbones" }, -- or any other flavor
|
||||||
}
|
}
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
ADVANCED USAGE *zenbones-advanced-usage*
|
ADVANCED USAGE *zenbones-documentation-advanced-usage*
|
||||||
|
|
||||||
Zenbones is pretty extensible thanks to Lush. You can easily retrieve the
|
Zenbones is pretty extensible thanks to Lush. You can easily retrieve the
|
||||||
colors in lua:
|
colors in lua:
|
||||||
|
|
||||||
>
|
>lua
|
||||||
local theme = require "zenbones" -- or any other flavor
|
local theme = require "zenbones" -- or any other flavor
|
||||||
local palette = require "zenbones.palette"
|
local palette = require "zenbones.palette"
|
||||||
|
|
||||||
@@ -150,7 +176,7 @@ Here’s an example of how to extend/override some highlights.
|
|||||||
|
|
||||||
`lua/customize_zenbones.lua`:
|
`lua/customize_zenbones.lua`:
|
||||||
|
|
||||||
>
|
>lua
|
||||||
local lush = require "lush"
|
local lush = require "lush"
|
||||||
local base = require "zenbones"
|
local base = require "zenbones"
|
||||||
|
|
||||||
@@ -164,18 +190,17 @@ Here’s an example of how to extend/override some highlights.
|
|||||||
lush.apply(lush.compile(specs))
|
lush.apply(lush.compile(specs))
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
And then somewhere in your `init.vim`:
|
And then somewhere in your `init.vim`:
|
||||||
|
|
||||||
>
|
>vim
|
||||||
autocmd ColorScheme zenbones lua require "customize_zenbones"
|
autocmd ColorScheme zenbones lua require "customize_zenbones"
|
||||||
colorscheme zenbones
|
colorscheme zenbones
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
See also Lush’s documentation
|
See also Lush’s documentation
|
||||||
<https://github.com/rktjmp/lush.nvim#advanced-usage> for more options.
|
<https://github.com/rktjmp/lush.nvim#advanced-usage> for more options.
|
||||||
|
|
||||||
|
|
||||||
CREATE YOUR OWN COLORSCHEME ~
|
CREATE YOUR OWN COLORSCHEME ~
|
||||||
|
|
||||||
You can ultimately create your own colorscheme that is based on zenbones by
|
You can ultimately create your own colorscheme that is based on zenbones by
|
||||||
@@ -186,7 +211,7 @@ through an example. Let’s make a zenbones-flavored Gruvbox colorscheme called
|
|||||||
Let’s define our |colorscheme| in `colors/gruvbones.lua`. It contains the
|
Let’s define our |colorscheme| in `colors/gruvbones.lua`. It contains the
|
||||||
following:
|
following:
|
||||||
|
|
||||||
>
|
>lua
|
||||||
local colors_name = "gruvbones"
|
local colors_name = "gruvbones"
|
||||||
vim.g.colors_name = colors_name -- Required when defining a colorscheme
|
vim.g.colors_name = colors_name -- Required when defining a colorscheme
|
||||||
|
|
||||||
@@ -243,7 +268,6 @@ following:
|
|||||||
require("zenbones.term").apply_colors(palette)
|
require("zenbones.term").apply_colors(palette)
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
And there you have it. Just call `colorscheme gruvbones` to use your new
|
And there you have it. Just call `colorscheme gruvbones` to use your new
|
||||||
colorscheme. It respects `&background` and other configurations too.
|
colorscheme. It respects `&background` and other configurations too.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user