109 lines
5.3 KiB
Markdown
109 lines
5.3 KiB
Markdown
# Zenflesh, Zenbones
|
|
|
|
Zenbones is a vim/neovim colorscheme designed to highlight code using contrasts
|
|
and font variations. Colors are tasked only for other roles such as diagnostics,
|
|
diffs, search matches.
|
|
|
|
|
|
|
|
<p align="center">
|
|
<em>A rock garden in <a href="https://en.wikipedia.org/wiki/Ry%C5%8Dan-ji">Ryōan-ji</a>.</em>
|
|
</p>
|
|
|
|
## Requirements
|
|
|
|
Primarily built for neovim but it works pretty well with vim. However here are
|
|
some requirements to take full advantage of the colorscheme:
|
|
|
|
- 24-bit RGB colors (neovim or vim compiled with +termguicolors) i.e.
|
|
`set termguicolors`
|
|
- Font with bold and italic
|
|
- Terminal or GUI with bold and italic support
|
|
|
|
## Installation
|
|
|
|
Example installation using packer:
|
|
|
|
```lua
|
|
use "mcchrish/zenbones.nvim"
|
|
|
|
-- Optionally install Lush. Useful if you want to extend the theme
|
|
-- e.g. create a statusline plugin theme using zenbones colors
|
|
use "rktjmp/lush.nvim"
|
|
-- See Advanced Usage section for more details
|
|
```
|
|
|
|
## Usage
|
|
|
|
Just apply the colorscheme as usual:
|
|
|
|
```vim
|
|
colorscheme zenbones " light
|
|
colorscheme zenflesh " dark
|
|
```
|
|
|
|
If you want to make use of the lua version:
|
|
|
|
```vim
|
|
" Requires `neovim` and `rktjmp/lush.nvim` installed
|
|
colorscheme zenbones-lush
|
|
colorscheme zenflesh-lush
|
|
```
|
|
|
|
## Configuration and other documentations
|
|
|
|
See [doc](doc/zenbones.md).
|
|
|
|
## Showcase
|
|
|
|
| 'bright' | _(unset)_ | 'dim' |
|
|
| :-----------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------: |
|
|
|  |  |  |
|
|
|
|
| 'stark' | _(unset)_ | 'warm' |
|
|
| :---------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------: |
|
|
|  |  |  |
|
|
|
|
## Other plugins support
|
|
|
|
Aside from LSP and basic Tree-sitter support, here are some plugins that are
|
|
currently supported.
|
|
|
|
- [Git Signs](https://github.com/lewis6991/gitsigns.nvim)
|
|
- [Git Gutter](https://github.com/airblade/vim-gitgutter)
|
|
- [Indent Blankline](https://github.com/lukas-reineke/indent-blankline.nvim)
|
|
- [Telescope](https://github.com/nvim-telescope/telescope.nvim)
|
|
- [Sneak](https://github.com/justinmk/vim-sneak)
|
|
- [Lightspeed](https://github.com/ggandor/lightspeed.nvim)
|
|
- [Hop](https://github.com/phaazon/hop.nvim)
|
|
- [Lualine](https://github.com/hoob3rt/lualine.nvim)
|
|
- [Lightline](https://github.com/itchyny/lightline.vim)
|
|
- [BarBar](https://github.com/romgrk/barbar.nvim)
|
|
- [CoC](https://github.com/neoclide/coc.nvim)
|
|
- [Neogit](https://github.com/TimUntersberger/neogit)
|
|
- [WhichKey](https://github.com/folke/which-key.nvim)
|
|
- [Trouble](https://github.com/folke/trouble.nvim)
|
|
|
|
## Other implementations
|
|
|
|
- [iTerm2](extras/iterm)
|
|
- [Kitty](extras/kitty)
|
|
- [Alacritty](extras/alacritty)
|
|
- [WezTerm](extras/wezterm)
|
|
- [Tmux](extras/tmux)
|
|
|
|
It's also possible to generate color configuration files using a template,
|
|
[this one for Kitty](lua/zenbones/build/kitty.lua) for example. Please feel free
|
|
to submit a PR if you want to add some more.
|
|
|
|
## Inspirations
|
|
|
|
Zenbones is heavily inspired by
|
|
[Verdandi](https://github.com/be5invis/vsc-theme-verdandi) and
|
|
[vim-yin-yang](https://github.com/pgdouyon/vim-yin-yang). The name came from a
|
|
book called
|
|
[Zen Flesh, Zen Bones](https://en.wikipedia.org/wiki/Zen_Flesh,_Zen_Bones).
|
|
|
|
There are more similar
|
|
[colorschemes with few colors from this collection](https://github.com/mcchrish/vim-no-color-collections).
|