Dev_theme

Nvim :help 頁面,從 原始碼 使用 tree-sitter-vimdoc 解析器 產生


Nvim 色彩配置指南
開發 Nvim 預設色彩配置的樣式指南。

設計

具有「Neovim 品牌」風格,也就是說,主要以「綠藍色」為主,外加一或兩種顏色保留給偶爾需要使用者注意的情況。
'termguicolors' (真色彩) 為導向,同時針對 'notermguicolors' (16 色) 作為備案時,盡可能地簡化。
具有易讀性,也就是說,具有足夠的對比度(如 https://www.w3.org/TR/2008/REC-WCAG20-20081211/#contrast-ratiodef 中定義)。這表示 hl-Normal 的數值至少為 7,且某些常見情況 ( hl-Visual、設定 'cursorline'Comment、彩色語法、Diff*hl-Search) 的數值至少為 4.5。
透過深色和淺色調色盤的交換,適用於深色和淺色背景。
具有可用性,也就是說,為常見物件提供足夠的視覺回饋。

調色盤

有兩個獨立的調色盤:深色和淺色。它們都包含相同的顏色集,分別以 NvimDark*NvimLight* 顏色匯出。
深色調色盤用於深色配色方案的背景和淺色配色方案的前景;反之亦然。這在不至於太過突出的情況下,引入可辨識的視覺系統。
調色盤的實際計算應在感知均勻的色彩空間中完成。Oklch 是一個不錯的選擇。
每個調色盤都有以下顏色(描述適用於深色背景;淺色背景則相反)
四種色調的「冷」灰色,用於一般使用者介面。
深色 (從最深到最淺) 保留作為 hl-NormalFloat (視為「黑色」)、hl-Normal (背景)、hl-CursorLinehl-Visual 的背景。
淺色 (也從最深到最淺) 保留給 Commenthl-StatusLine/|hl-TabLine|、hl-Normal (前景) 和視為「白色」的顏色。
六種顏色足以提供終端機顏色:紅色、黃色、綠色、青色、藍色、洋紅色。它們應具有(合理地)相似的亮度和彩度,以使其在視覺上連貫。亮度應盡可能與調色盤的基本灰色(用於 hl-Normal)相等。它們應具有(合理地)不同的色調,以使其在視覺上可區分。
對於 16 色
不使用灰色,而是以終端機模擬器的前景和背景顏色取代。
非灰色會回退到 ANSI 程式碼中排序的終端機顏色 ( https://en.wikipedia.org/wiki/ANSI_escape_code#3-bit_and_4-bit ),也就是說,紅色 (1, 9)、綠色 (2, 10)、黃色 (3, 11)、藍色 (4, 12)、洋紅色 (5, 13)、青色 (6, 14)。為了增加對比度,顏色 1-6 用於淺色背景,而 9-14 用於深色背景。

高亮群組

使用
根據設計,將灰色陰影用於一般使用者介面。
將粗體文字用於關鍵字(Statement 高亮群組)。這是增加顏色辨識障礙人士易讀性的一個重要選擇,因為它不依賴實際顏色。
綠色用於字串、hl-DiffAdd (作為背景)、hl-DiagnosticOk 和一些次要的文字使用者介面元素。
青色作為主要的語法顏色,也就是說,用於函式使用(Function 高亮群組)、hl-DiffTexthl-DiagnosticInfo 和一些次要的文字使用者介面元素。
紅色通常表示使用者高度注意,也就是說,錯誤;特別是對於 hl-ErrorMsghl-DiffDeletehl-DiagnosticError
黃色非常謹慎地表示使用者輕微注意,也就是說,警告。也就是說,hl-DiagnosticWarnhl-WarningMsg
藍色非常謹慎地作為 hl-DiagnosticHint 和一些額外重要的語法群組 (例如 Identifier)。
洋紅色非常小心地使用 (如果有的話)。
在 16 種顏色的情況下
依賴於「背景顏色可以用作背景;其他顏色可以用作前景」的假設。這表示在任何前景/背景組合中,都應該有背景和一個非背景顏色。
根據正常背景是淺色還是深色,使用 0 (黑色) 或 15 (亮白色) 作為非灰色背景的前景。
主要
指令索引
快速參考