z_mirror/kak-one

git clone https://git.raiguard.me/z_mirror/kak-one

Caleb HeuerUpdate 16-color themes and include color config exampleafd5866

trunk
branchestrunkall refs →
3.7 KiB136 linesraw

kak-one

One Light and One Dark colorschemes for Kakoune. Based on vim-one. Includes an additional One Darker colorscheme, which has higher contrast than One Dark and the coloring of variables and operators is swapped.

Installation

Install the files in the colors subdirectory in (kak configuration)/colors, or use a plugin manager.

Usage

Enable one of the themes with colorscheme <name>:

  • one-light, one-light-16
  • one-dark, one-dark-16
  • one-darker, one-darker-16

16-color variants

There is a 16-color variant of each theme available that uses your base terminal colors. To achieve the correct theme, you will need to set your terminal colors accordingly.

Color option expansions (explained below) are not available in 16-color variants - use the ANSI color names instead.

one-light-16, one-dark-16, one-darker-16

Foot color configuration for one-darker-16

[colors]
foreground=abb2bf # white
background=181a1f # black
selection-foreground=181a1f # black
selection-background=61afef # blue
regular0=282c34 # black
regular1=e06c75 # red
regular2=98c379 # green
regular3=e5c07b # yellow
regular4=61afef # blue
regular5=c678dd # magenta
regular6=56b6c2 # cyan
regular7=abb2bf # white
bright0=70798a # bright black
bright1=e06c75 # bright red
bright2=98c379 # bright green
bright3=d19a66 # bright yellow
bright4=61afef # bright blue
bright5=c678dd # bright magenta
bright6=56b6c2 # bright cyan
bright7=ffffff # bright white
dim1=7c434a # dim red
dim2=586e4c # dim green
dim3=7e6d4d # dim yellow
dim4=3c6487 # dim blue
dim5=6f497e # dim magenta
dim6=376870 # dim cyan
dim7=70798a # dim white (comment color)

Plugin support

kak-one includes colors for the following plugins:

  • kak-lsp
    • LSP info boxes are syntax highlighted
    • Inlay hints inherit from the type face, with a dim modifier
    • Special enum and parameter faces are provided for semantic highlighting (requires configuration in kak-lsp.toml)
      • enum is cyan
      • parameter is italicized and uses the variable color
    • LSP diagnostics are colored as:
      • Error: red
      • Warning: yellow
      • Info: blue
      • Hint: bright white / dark black (in dark and light themes respectively)
    • Inline diagnostics are represented with colored curly underlines - this feature may not work on all terminal emulators
    • Other references to the current symbol are highlighted in a slightly lighter background color
  • kak-rainbower
    • Brackets are colored yellow, magenta, and blue

Using scheme constructs in your own scripts

You can use the scheme colors and other properties in your own scripts by using the following options in expansions:

add-highlighter global/trailing-whitespaces regex "(\h+)$" "1:default,rgba:%opt{darkred}%opt{selectionalpha}"

Colors

  • fg

  • bg

  • subbg

  • lightred

  • darkred

  • green

  • lightorange

  • darkorange

  • blue

  • magenta

  • cyan

  • comment

Transparencies

  • cursoralpha
  • selectionalpha

Other

  • menuselection (cursor color adjusted for ths subbg background, since menus do not support transparency)

Feature screenshots

Alpha-blended selections

Obvious secondary selections

kak-lsp diagnostics

Curly and/or colored underlines may not display on all terminal emulators.

1# kak-one
2
3![](screenshots/one-darker.png)
4![](screenshots/one-dark.png)
5![](screenshots/one-light.png)
6
7`One Light` and `One Dark` colorschemes for [Kakoune](https://kakoune.org).
8Based on [vim-one](https://github.com/rakr/vim-one).
9Includes an additional `One Darker` colorscheme, which has higher contrast than
10`One Dark` and the coloring of variables and operators is swapped.
11
12## Installation
13
14Install the files in the `colors` subdirectory in `(kak configuration)/colors`,
15or use a plugin manager.
16
17## Usage
18
19Enable one of the themes with `colorscheme <name>`:
20- `one-light`, `one-light-16`
21- `one-dark`, `one-dark-16`
22- `one-darker`, `one-darker-16`
23
24## 16-color variants
25
26There is a 16-color variant of each theme available that uses your base
27terminal colors. To achieve the correct theme, you will need to set your
28terminal colors accordingly.
29
30Color option expansions (explained below) are not available in 16-color
31variants - use the ANSI color names instead.
32
33`one-light-16`, `one-dark-16`, `one-darker-16`
34
35### [Foot](https://codeberg.org/dnkl/foot) color configuration for `one-darker-16`
36
37```ini
38[colors]
39foreground=abb2bf # white
40background=181a1f # black
41selection-foreground=181a1f # black
42selection-background=61afef # blue
43regular0=282c34 # black
44regular1=e06c75 # red
45regular2=98c379 # green
46regular3=e5c07b # yellow
47regular4=61afef # blue
48regular5=c678dd # magenta
49regular6=56b6c2 # cyan
50regular7=abb2bf # white
51bright0=70798a # bright black
52bright1=e06c75 # bright red
53bright2=98c379 # bright green
54bright3=d19a66 # bright yellow
55bright4=61afef # bright blue
56bright5=c678dd # bright magenta
57bright6=56b6c2 # bright cyan
58bright7=ffffff # bright white
59dim1=7c434a # dim red
60dim2=586e4c # dim green
61dim3=7e6d4d # dim yellow
62dim4=3c6487 # dim blue
63dim5=6f497e # dim magenta
64dim6=376870 # dim cyan
65dim7=70798a # dim white (comment color)
66```
67
68## Plugin support
69
70`kak-one` includes colors for the following plugins:
71
72- [kak-lsp](https://github.com/kak-lsp/kak-lsp)
73    - LSP info boxes are syntax highlighted
74    - Inlay hints inherit from the `type` face, with a dim modifier
75    - Special `enum` and `parameter` faces are provided for semantic highlighting (requires configuration in `kak-lsp.toml`)
76        - `enum` is cyan
77        - `parameter` is italicized and uses the `variable` color
78    - LSP diagnostics are colored as:
79        - Error: red
80        - Warning: yellow
81        - Info: blue
82        - Hint: bright white / dark black (in dark and light themes respectively)
83    - Inline diagnostics are represented with colored curly underlines - this feature may not work on all terminal emulators
84    - Other references to the current symbol are highlighted in a slightly lighter background color
85- [kak-rainbower](https://github.com/crizan/kak-rainbower)
86    - Brackets are colored yellow, magenta, and blue
87
88## Using scheme constructs in your own scripts
89
90You can use the scheme colors and other properties in your own scripts by using the following options in expansions:
91
92```kak
93add-highlighter global/trailing-whitespaces regex "(\h+)$" "1:default,rgba:%opt{darkred}%opt{selectionalpha}"
94```
95
96### Colors
97
98- `fg`
99- `bg`
100- `subbg`
101
102- `lightred`
103- `darkred`
104- `green`
105- `lightorange`
106- `darkorange`
107- `blue`
108- `magenta`
109- `cyan`
110
111- `comment`
112
113### Transparencies
114
115- `cursoralpha`
116- `selectionalpha`
117
118### Other
119
120- `menuselection` (cursor color adjusted for ths `subbg` background, since menus do not support transparency)
121
122## Feature screenshots
123
124### Alpha-blended selections
125
126![](screenshots/alpha-blended-selections.png)
127
128### Obvious secondary selections
129
130![](screenshots/secondary-selections.png)
131
132### kak-lsp diagnostics
133
134![](screenshots/kak-lsp.png)
135
136Curly and/or colored underlines may not display on all terminal emulators.