github-nvim-theme

通知

[!警告] 如果您自定义或配置颜色，或者升级配色方案后发现外观没有变化，请运行:GithubThemeCompile命令来编译配色方案。我们正在积极解决这个问题，感谢您的耐心等待。

订阅此讨论 或查看:h github-theme-changelog以获取有关重大变更和弃用的更新。

• 2023-12-02：重新实现了*_default配色方案，之前在changelog-23042023中被弃用
• 2023-05-14：本主题进行了重大重构，对Neovim支持和代码库进行了更改，深受nightfox.nvim的启发。感谢EdenEast。对于较旧的Neovim版本，请使用0.0.x分支。
• 2022-08-03：终端和其他主题已移至**github-theme-contrib** Git仓库，相关代码已从本仓库中移除。

支持的配色方案和比较

github-nvim-theme	github-vscode-theme	Github Web UI	Primer
github_dark	Github Dark	-	-
github_light	Github Light	-	-
github_dark_dimmed	Github Dark Dimmed	Dark dimmed	dark_dimmed
github_dark_default	Github Dark Default	Dark default	dark
github_light_default	Github Light Default	Light default	light
github_dark_high_contrast	Github Dark High Contrast	Dark high contrast	dark_high_contrast
github_light_high_contrast	Github Light High Contrast	Light high contrast	light_high_contrast
github_dark_colorblind	Github Dark Colorblind (Beta)	Dark Protanopia & Deuteranopia	dark_colorblind
github_light_colorblind	Github Light Colorblind (Beta)	Light Protanopia & Deuteranopia	light_colorblind
github_dark_tritanopia	-	Dark Tritanopia	dark_tritanopia
github_light_tritanopia	-	Light Tritanopia	light_tritanopia

特性

• 支持最新的Neovim>=0.5特性，如Treesitter和LSP
• 类似于GitHub的VSCode主题，遵循primer设计指南
• 包含GitHub的色盲主题
• 支持多个插件和状态栏
  • 许多其他插件也应该"开箱即用"！
• 最小化的非活动Vim默认状态栏
• Vim终端颜色
• 侧边栏类窗口的较深背景
• 高度可配置，支持模板覆盖
• 最优雅的lualine主题
• 编译用户配置以加快启动时间
• 导出颜色库实用工具
• 交互式实时配置重新加载

要求

• Neovim >= 0.8.0（对于旧版本请使用0.0.x分支）
• 真彩色支持
• 下划线终端支持（可选）

[!注意] 在macOS上，默认终端（即Terminal.app）不支持真彩色24位RGB颜色。请使用Iterm2或其他支持真彩色的终端。

安装

使用您喜欢的包管理器安装主题：

使用vim-plug安装：

[object Object],[object Object]

或使用dein：

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

或使用minpac：

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

或使用Packer.nvim：

在您的init.lua或plugins.lua中添加以下内容

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

或使用lazy.nvim：

在您的init.lua或plugins.lua中添加以下内容

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

使用方法

只需使用内置命令 :colorscheme 设置配色方案

[object Object],[object Object]

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

截图

• 字体： Iosevka Nerd Font Mono
• 终端： kitty
• 图标： nvim-web-devicons
• 状态栏：默认 (.vimrc)
• 配置文件： ful1e5/dotfiles/nvim

Github 深色

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 深色默认

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 深色暗淡

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 深色高对比度

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 深色色盲模式（测试版）

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 深色蓝黄色盲模式（测试版）

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 浅色

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 浅色默认

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 浅色高对比度

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 浅色色盲模式（测试版）

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Github 浅色蓝黄色盲模式（测试版）

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

配置

如果您不想更改默认选项和设置，则无需调用 setup。

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

如果你想更改上述任何默认选项，只需指定你想更改的选项。未指定的选项将使用其默认值。例如，如果你只想更改某些语法项的样式：

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

要查看Github Theme配置设置的详细说明，请参考内置帮助:help github-nvim-theme或 Usage。

模块

Github Theme的模块存储各种插件和其他neovim模块的配置信息。要启用模块， 可以将模块设置为true，或者如果模块有额外的配置信息，则将enable设置为true。

默认情况下，模块将被启用。要更改此行为，请将options.module_default更改为false。

要查看模块列表，请参阅Usage或:help以获取更多信息。

自定义调色板和组

你可以更改github-theme的颜色palette和高亮group。这里是一个简短的例子：

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

-- 模板使用规格。规格中包含可访问的调色板字段 IncSearch = { bg = 'palette.cyan' }, }, github_dark = { -- 与规格和调色板一样,特定样式的值将优先于'all'中的值使用。 PmenuSel = { bg = '#73daca', fg = 'bg0' }, }, }

require('github-theme').setup({ palettes = palettes, specs = specs, groups = groups })

-- 必须在加载前调用setup vim.cmd('colorscheme github_dark')

要查找为vim定义的语法高亮组列表,请使用帮助`:help group-name`和`:help nvim-treesitter-highlights`(用于treesitter)。如果你还想了解GitHub Theme如何定义这些高亮组,可以查看[syntax.lua]获取vim语法信息,[treesitter.lua]获取treesitter信息。这些文件列出了所有高亮组,并附有描述注释。另一个值得注意的文件是[editor.lua],它负责vim外观的高亮组(背景、光标行、标签栏等)。

要获取更多信息,请查看[Usage](https://github.com/projekt0n/github-nvim-theme/blob/main/./Usage.md#configuration)或帮助文件`:help github-nvim-theme`以获取更详细的信息。

[editor.lua]: https://github.com/projekt0n/github-nvim-theme/blob/main/lua/github-theme/group/editor.lua
[syntax.lua]: https://github.com/projekt0n/github-nvim-theme/blob/main/lua/github-theme/group/syntax.lua
[treesitter.lua]: https://github.com/projekt0n/github-nvim-theme/blob/main/lua/github-theme/group/modules/treesitter.lua

### 自定义模板值

GitHub Theme的`palettes`和`specs`可以用你自己的值进行扩展。这对于想要区分用于多个组定义的规格值的用户很有用。通过一个例子可以更好地理解这一点。

`bg0`用作深色替代背景色。它在多个区域使用(非当前文件、状态栏、普通浮动窗口等)。如果你想让非活动颜色与浮动窗口/状态栏颜色不同,可以在`specs`表中定义自己的值。

```lua
require('github-theme').setup({
  palettes = {
    -- 带有黑色背景的自定义duskfox
    github_dark = {
      bg1 = '#000000', -- 黑色背景
      bg0 = '#1d1d2b', -- 替代背景(浮动窗口、状态栏等)
      bg3 = '#121820', -- 比原版暗55%
      sel0 = '#131b24', -- 比原版暗55%
    },
  },
  specs = {
    all = {
      inactive = 'bg0', -- 其他样式的默认值
    },
    github_dark_dimmed = {
      inactive = '#090909', -- 略微比黑色背景亮一些
    },
  },
  groups = {
    all = {
      NormalNC = { fg = 'fg1', bg = 'inactive' }, -- 非当前窗口
    },
  },
})

API

GitHub Theme提供了一些API和实用类,让你可以获取GitHub Theme的数据。

调色板

你可以获取每个配色方案使用的调色板:

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

有关调色板的更多信息,请参阅Usage。

规格

你可以获取每个配色方案使用的规格:

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

有关规格的更多信息,请参阅Usage。

颜色库

GitHub Theme内部使用颜色库来操作颜色。你也可以使用这个库。

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

有很多有用的函数可以在不同的色彩空间中操作和处理颜色。

有关Color的更多信息,请参阅Usage。

编译

GitHub Theme是一个高度可定制和可配置的配色方案。然而,这会带来复杂性和执行时间的代价。

GitHub Theme预先计算你的配置结果,并将Lua字节码保存在缓存中,以便下次加载时使用。 这显著提高了GitHub Theme的执行速度。对配置的更改将自动重新计算和缓存。

默认情况下,GitHub Theme将编译结果写入系统的cache目录。在Unix系统上,这是 $XDG_CACHE_HOME/nvim/github-theme,在Windows上,这是%localappdata%\\Temp\\nvim\\github-theme。

GitHub Theme提供了一些函数来处理GitHub Theme编译器。

[object Object],[object Object],[object Object]

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

交互式

Github 主题使得修改配置并查看结果变得容易。为此，Github 主题提供了以下命令：

GithubThemeInteractive

该命令会为当前缓冲区添加一个在 BufferWritePost 事件上执行的自动命令。这个自动命令会清除 Github 主题的内部状态，并从新保存的文件中重新加载配置。然后它会重置配色方案。

支持的插件

• 内置 LSP 诊断
• ale
• circles.nvim
• coc.nvim
• dap-ui
• dashboard-nvim
• diffchar.vim
• diffview.nvim
• fidget.nvim
• fsread.nvim
• fzf-lua
• gitsigns.nvim
• indent-blankline.nvim
• lsp-trouble.nvim
• lspsaga.nvim
• lualine.nvim
• mini.nvim
• neo-tree.nvim
• neogit
• nvim-bufferline.lua
• nvim-cmp
• nvim-compe
• nvim-notify
• nvim-tree.lua
• nvim-treesitter-context
• nvim-treesitter
• nvim-web-devicons
• telescope.nvim
• vim-airline
• vim-gitgutter
• which-key.nvim

状态栏

Lualine

Lualine 通过检查 vim.g.colors_name 的值（使用 :colorscheme 命令时设置）来确定要加载的主题。在调用 setup 之前设置你的配色方案。

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Airline

使用 vim 命令 :AirlineThemes 设置你的 airline 配色方案。

语法高亮组

本节将帮助你确定某段语法应用了哪个高亮组。这些方法可以显示当前光标位置（光标下）正在使用的高亮组。

[!提示] 在 Neovim v0.9.0 及更高版本中，你可以使用内置命令 :Inspect 或 Lua 函数 vim.show_pos()。

Treesitter 高亮

如果 treesitter 是相关语言的高亮方法，你可以使用命令：:TSHighlightCapturesUnderCursor。这个命令来自 treesitter playground 插件。确保你已安装此插件以及 nvim-treesitter。

在 Tmux 中正确显示 undercurls

要让 undercurls 显示并带有颜色，请在你的 Tmux 配置文件中添加以下内容：

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

贡献

查看 CONTRIBUTING.md

版权

本项目基于 MIT 许可证发布。 更多信息请查看 LICENSE 或访问 opensource.org