docs: removed old vimdoc
This commit is contained in:
Folke Lemaitre
parent
4bbf5e57a5
commit
634eaecd07
12
doc/tags
12
doc/tags
@ -1,12 +0,0 @@
|
|||||||
tokyonight.nvim-day tokyonight.nvim.txt /*tokyonight.nvim-day*
|
|
||||||
tokyonight.nvim-night tokyonight.nvim.txt /*tokyonight.nvim-night*
|
|
||||||
tokyonight.nvim-plugin-support tokyonight.nvim.txt /*tokyonight.nvim-plugin-support*
|
|
||||||
tokyonight.nvim-storm tokyonight.nvim.txt /*tokyonight.nvim-storm*
|
|
||||||
tokyonight.nvim-⚙️-configuration tokyonight.nvim.txt /*tokyonight.nvim-⚙️-configuration*
|
|
||||||
tokyonight.nvim-⚡️-requirements tokyonight.nvim.txt /*tokyonight.nvim-⚡️-requirements*
|
|
||||||
tokyonight.nvim-✨-features tokyonight.nvim.txt /*tokyonight.nvim-✨-features*
|
|
||||||
tokyonight.nvim-🍭-extras tokyonight.nvim.txt /*tokyonight.nvim-🍭-extras*
|
|
||||||
tokyonight.nvim-🏙-tokyo-night tokyonight.nvim.txt /*tokyonight.nvim-🏙-tokyo-night*
|
|
||||||
tokyonight.nvim-📦-installation tokyonight.nvim.txt /*tokyonight.nvim-📦-installation*
|
|
||||||
tokyonight.nvim-🔥-contributing tokyonight.nvim.txt /*tokyonight.nvim-🔥-contributing*
|
|
||||||
tokyonight.nvim-🚀-usage tokyonight.nvim.txt /*tokyonight.nvim-🚀-usage*
|
|
||||||
@ -1,289 +0,0 @@
|
|||||||
==============================================================================
|
|
||||||
1. 🏙 Tokyo Night *tokyonight.nvim-🏙-tokyo-night*
|
|
||||||
|
|
||||||
|
|
||||||
A dark and light Neovim theme written in Lua ported from the Visual Studio Code [TokyoNight](https://github.com/enkia/tokyo-night-vscode-theme)
|
|
||||||
theme. Includes extra themes for Kitty, Alacritty, iTerm and Fish.
|
|
||||||
==============================================================================
|
|
||||||
2. Storm *tokyonight.nvim-storm*
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
3. Night *tokyonight.nvim-night*
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
4. Day *tokyonight.nvim-day*
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
5. ✨ Features *tokyonight.nvim-✨-features*
|
|
||||||
|
|
||||||
|
|
||||||
- supports the latest Neovim 5.0 features like TreeSitter and LSP
|
|
||||||
- minimal inactive statusline
|
|
||||||
- vim terminal colors
|
|
||||||
- darker background for sidebar-like windows
|
|
||||||
- color configs for [Kitty](https://sw.kovidgoyal.net/kitty/conf.html?highlight=include), [Alacritty](https://github.com/alacritty/alacritty) and [Fish Shell](https://fishshell.com/)
|
|
||||||
- **lualine** theme
|
|
||||||
==============================================================================
|
|
||||||
6. Plugin Support *tokyonight.nvim-plugin-support*
|
|
||||||
|
|
||||||
|
|
||||||
- [TreeSitter](https://github.com/nvim-treesitter/nvim-treesitter)
|
|
||||||
- [LSP Diagnostics](https://neovim.io/doc/user/lsp.html)
|
|
||||||
- [LSP Trouble](https://github.com/folke/lsp-trouble.nvim)
|
|
||||||
- [LSP Saga](https://github.com/glepnir/lspsaga.nvim)
|
|
||||||
- [Git Signs](https://github.com/lewis6991/gitsigns.nvim)
|
|
||||||
- [Git Gutter](https://github.com/airblade/vim-gitgutter)
|
|
||||||
- [Telescope](https://github.com/nvim-telescope/telescope.nvim)
|
|
||||||
- [NvimTree](https://github.com/kyazdani42/nvim-tree.lua)
|
|
||||||
- [WhichKey](https://github.com/liuchengxu/vim-which-key)
|
|
||||||
- [Indent Blankline](https://github.com/lukas-reineke/indent-blankline.nvim)
|
|
||||||
- [Dashboard](https://github.com/glepnir/dashboard-nvim)
|
|
||||||
- [BufferLine](https://github.com/akinsho/nvim-bufferline.lua)
|
|
||||||
- [Lualine](https://github.com/hoob3rt/lualine.nvim)
|
|
||||||
- [Lightline](https://github.com/itchyny/lightline.vim)
|
|
||||||
- [Neogit](https://github.com/TimUntersberger/neogit)
|
|
||||||
- [vim-sneak](https://github.com/justinmk/vim-sneak)
|
|
||||||
- [Fern](https://github.com/lambdalisue/fern.vim)
|
|
||||||
==============================================================================
|
|
||||||
7. ⚡️ Requirements *tokyonight.nvim-⚡️-requirements*
|
|
||||||
|
|
||||||
|
|
||||||
- Neovim >= 0.5.0
|
|
||||||
==============================================================================
|
|
||||||
8. 📦 Installation *tokyonight.nvim-📦-installation*
|
|
||||||
|
|
||||||
|
|
||||||
Install the theme with your preferred package manager:
|
|
||||||
[vim-plug](https://github.com/junegunn/vim-plug)
|
|
||||||
|
|
||||||
>
|
|
||||||
Plug 'folke/tokyonight.nvim'
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
[packer](https://github.com/wbthomason/packer.nvim)
|
|
||||||
|
|
||||||
>
|
|
||||||
use 'folke/tokyonight.nvim'
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
9. 🚀 Usage *tokyonight.nvim-🚀-usage*
|
|
||||||
|
|
||||||
|
|
||||||
Enable the colorscheme:
|
|
||||||
|
|
||||||
>
|
|
||||||
" Vim Script
|
|
||||||
colorscheme tokyonight
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>
|
|
||||||
-- Lua
|
|
||||||
vim.cmd[[colorscheme tokyonight]]
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
To enable the `TokyoNight` theme for `Lualine` , simply specify it in your
|
|
||||||
lualine settings:
|
|
||||||
|
|
||||||
>
|
|
||||||
require('lualine').setup {
|
|
||||||
options = {
|
|
||||||
-- ... your lualine config
|
|
||||||
theme = 'tokyonight'
|
|
||||||
-- ... your lualine config
|
|
||||||
}
|
|
||||||
}
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
To enable the `tokyonight` colorscheme for `Lightline` :
|
|
||||||
|
|
||||||
>
|
|
||||||
" Vim Script
|
|
||||||
let g:lightline = {'colorscheme': 'tokyonight'}
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
10. ⚙️ Configuration *tokyonight.nvim-⚙️-configuration*
|
|
||||||
|
|
||||||
|
|
||||||
❗️ configuration needs to be set **BEFORE** loading the color scheme with
|
|
||||||
`colorscheme tokyonight`
|
|
||||||
The theme comes in three styles, `storm` , a darker variant `night` and `day`.
|
|
||||||
The **day** style will be used if:
|
|
||||||
- `vim.g.tokyonight_style = "day"`
|
|
||||||
- or `vim.o.background = "light"`
|
|
||||||
Option
|
|
||||||
Default
|
|
||||||
Description
|
|
||||||
-----------------------------------
|
|
||||||
---------
|
|
||||||
---------------------------------------------------------------------------------------------------------------------------------------------------------------
|
|
||||||
tokyonight_style
|
|
||||||
|
|
||||||
"storm"
|
|
||||||
|
|
||||||
The theme comes in three styles,
|
|
||||||
storm
|
|
||||||
, a darker variant
|
|
||||||
night
|
|
||||||
and
|
|
||||||
day
|
|
||||||
.
|
|
||||||
tokyonight_terminal_colors
|
|
||||||
|
|
||||||
true
|
|
||||||
|
|
||||||
Configure the colors used when opening a
|
|
||||||
:terminal
|
|
||||||
in Neovim
|
|
||||||
tokyonight_italic_comments
|
|
||||||
|
|
||||||
true
|
|
||||||
|
|
||||||
Make comments italic
|
|
||||||
tokyonight_italic_keywords
|
|
||||||
|
|
||||||
true
|
|
||||||
|
|
||||||
Make keywords italic
|
|
||||||
tokyonight_italic_functions
|
|
||||||
|
|
||||||
false
|
|
||||||
|
|
||||||
Make functions italic
|
|
||||||
tokyonight_italic_variables
|
|
||||||
|
|
||||||
false
|
|
||||||
|
|
||||||
Make variables and identifiers italic
|
|
||||||
tokyonight_transparent
|
|
||||||
|
|
||||||
false
|
|
||||||
|
|
||||||
Enable this to disable setting the background color
|
|
||||||
tokyonight_hide_inactive_statusline
|
|
||||||
|
|
||||||
false
|
|
||||||
|
|
||||||
Enabling this option, will hide inactive statuslines and replace them with a thin border instead. Should work with the standard
|
|
||||||
StatusLine
|
|
||||||
and
|
|
||||||
LuaLine
|
|
||||||
.
|
|
||||||
tokyonight_sidebars
|
|
||||||
|
|
||||||
{}
|
|
||||||
|
|
||||||
Set a darker background on sidebar-like windows. For example:
|
|
||||||
["qf", "vista_kind", "terminal", "packer"]
|
|
||||||
|
|
||||||
tokyonight_dark_sidebar
|
|
||||||
|
|
||||||
true
|
|
||||||
|
|
||||||
Sidebar like windows like
|
|
||||||
NvimTree
|
|
||||||
get a darker background
|
|
||||||
tokyonight_dark_float
|
|
||||||
|
|
||||||
true
|
|
||||||
|
|
||||||
Float windows like the lsp diagnostics windows get a darker background.
|
|
||||||
tokyonight_colors
|
|
||||||
|
|
||||||
{}
|
|
||||||
|
|
||||||
You can override specific color groups to use other groups or a hex color
|
|
||||||
tokyonight_day_brightness
|
|
||||||
|
|
||||||
0.3
|
|
||||||
|
|
||||||
Adjusts the brightness of the colors of the
|
|
||||||
Day
|
|
||||||
style. Number between 0 and 1, from dull to vibrant colors
|
|
||||||
tokyonight_lualine_bold
|
|
||||||
|
|
||||||
false
|
|
||||||
|
|
||||||
When
|
|
||||||
true
|
|
||||||
, section headers in the lualine theme will be bold
|
|
||||||
|
|
||||||
>
|
|
||||||
-- Example config in Lua
|
|
||||||
vim.g.tokyonight_style = "night"
|
|
||||||
vim.g.tokyonight_italic_functions = true
|
|
||||||
vim.g.tokyonight_sidebars = { "qf", "vista_kind", "terminal", "packer" }
|
|
||||||
|
|
||||||
-- Change the "hint" color to the "orange" color, and make the "error" color bright red
|
|
||||||
vim.g.tokyonight_colors = { hint = "orange", error = "#ff0000" }
|
|
||||||
|
|
||||||
-- Load the colorscheme
|
|
||||||
vim.cmd[[colorscheme tokyonight]]
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>
|
|
||||||
" Example config in VimScript
|
|
||||||
let g:tokyonight_style = "night"
|
|
||||||
let g:tokyonight_italic_functions = 1
|
|
||||||
let g:tokyonight_sidebars = [ "qf", "vista_kind", "terminal", "packer" ]
|
|
||||||
|
|
||||||
" Load the colorscheme
|
|
||||||
colorscheme tokyonight
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
11. Making `undercurls` work properly in **Tmux***tokyonight.nvim-making-`undercurls`-work-properly-in-**tmux***
|
|
||||||
|
|
||||||
|
|
||||||
To have undercurls show up and in color, add the following to your **Tmux**
|
|
||||||
config file:
|
|
||||||
|
|
||||||
>
|
|
||||||
# Undercurl
|
|
||||||
set -g default-terminal "${TERM}"
|
|
||||||
set -as terminal-overrides ',*:Smulx=\E[4::%p1%dm' # undercurl support
|
|
||||||
set -as terminal-overrides ',*:Setulc=\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%;m' # underscore colours - needs tmux-3.0
|
|
||||||
<
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
12. 🍭 Extras *tokyonight.nvim-🍭-extras*
|
|
||||||
|
|
||||||
|
|
||||||
Extra color configs for **Kitty** , **Alacritty** , **Fish** , **WezTerm** and
|
|
||||||
**iTerm** can be found in [extras](extras/). To use them, refer to their
|
|
||||||
respective documentation.
|
|
||||||
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
13. 🔥 Contributing *tokyonight.nvim-🔥-contributing*
|
|
||||||
|
|
||||||
|
|
||||||
Pull requests are welcome. For the `extras` , we use a simple template system
|
|
||||||
that can be used to generate themes for the different styles.
|
|
||||||
How to add a new extra template:
|
|
||||||
1. create a file like `lua/tokyonight/extra/cool-app.lua`
|
|
||||||
2. add the name and output file extension to the `extras` table in `lua/tokyonight/extra/init.lua`
|
|
||||||
3. in the root directory, run `$ lua lua/tokyonight/extra/init.lua` to generate / update extra themes
|
|
||||||
4. commit the newly created themes under `extra/`
|
|
||||||
vim:tw=78:ts=8:ft=help:norl:
|
|
||||||
Loading…
Reference in New Issue
Block a user