Nord 调色板 changelog 全解读:0.1.0 至 0.2.0 的色板设计、语法高亮规范与工具链演进

原创2026-10-14 15:34:231,348 阅读
文章标签:UI组件设计系统

Nord 调色板 changelog 全解读:0.1.0 至 0.2.0 的色板设计、语法高亮规范与工具链演进

Nord 是一个 "an arctic, north-bluish color palette"(北极、偏北蓝配色方案)开源项目,本篇文章以仓库根目录的 changelog.md 为核心线索,完整梳理其 0.1.0 与 0.2.0 两个里程碑版本的功能演进、色板设计决策、文档体系与工程化任务,并结合 src/ 下的真实源码(CSS/Less/SCSS/Stylus 变量与六种原生色板文件)逐项印证。读完本文,你将掌握 Nord 16 色体系的命名与语义分工、语法高亮色彩分配规范的来龙去脉,以及如何在你的项目中安装、引用并以多种色板格式落地使用。

版本脉络与 changelog 结构

changelog.md 遵循"按版本倒序"的惯例,自顶向下记录了从 Project Initialization(2016-09-04 项目初始化) 至今的完整演进过程。结合当前仓库的 package.json,可以建立如下版本时间线:

版本 发布日期 核心内容
Project Initialization 2016-09-04 项目立项,同名日期与 0.1.0 一致
0.1.0 2016-09-04 首次发布:Sass/Less 源码、Sassdoc 与 KSS 文档、五种原生色板
0.2.0 2016-11-22 兼容性改进、语法高亮配色规范正式化、新增 Port 项目与 CI 配置
0.2.1(当前仓库) — package.json 中声明的最新版本,changelog 尚未单独记录

每个版本条目均分为 Improvements(改进)、Features(特性) 与 Tasks(任务) 等分类小节,并用 ❯ 符号逐条列出要点,同时附带对应的 GitHub Issue 编号(如 #1~#5)与提交哈希(如 30ae2f4b、2a95e4c0),便于追溯每项变更的代码落点——这正是阅读 changelog 时值得保留的溯源习惯。

0.1.0:初始版本的功能基线

0.1.0(2016-09-04)是 Nord 的第一个发布版本,其 Features 小节奠定了项目后续所有版本的基础架构,核心围绕"源码 + 文档 + 色板"三条线展开。

Sass 源码与 CSS 模板

0.1.0 引入了两个关键文件:

  • Sass 源码 nord.scss:即当前仓库 src/nord.scss,以 $nord0 到 $nord15 共 16 个 SCSS 变量承载全部颜色;
  • CSS 模板 template-css.scss:可在安装 Gulp 后通过以下命令编译为 nord.css:
gulp compile-css-template

编译产物即当前仓库的 src/nord.css——它以 CSS 自定义属性(Custom Properties)的形式在 :root 伪类下声明 --nord0 ~ --nord15 全部 16 个变量。值得注意的是,随着项目演进,当前 package.json 的 scripts 已改用 npm-run-all 组合的 lint/test/format 系列命令,Gulp 已不再是现役构建工具,上述命令属于 0.1.0 时代的历史用法。

Sassdoc 与 KSS 文档

同一版本还为两种 CSS 预处理器配套了文档体系:

  • Sass 文档采用 Sassdoc 注释语法(///),可通过 Gulp 命令 gulp sassdoc 编译为静态 HTML 文档;
  • Less 文档采用 KSS 文档语法,styleguide 的生成方式参见官方 KSS 文档。

这些注释至今仍完整保留在 src/nord.scss 与 src/nord.less 中。以 SCSS 为例,每个变量都标注了 @author、@access public、@group(如 polarnight、snowstorm、frost、aurora)与 @since 0.1.0 等元信息,甚至附带可执行的 @example 代码片段;CSS 与 Less 源文件则使用 KSS 风格的 Styleguide Nord / Styleguide Nord - Polar Night 分组注释。

五种原生色板

0.1.0 首次发布了五类原生色板文件,全部保留在当前仓库的 src/swatches/ 目录中:

文件 格式 适用软件
nord.aco Adobe Photoshop Palette Adobe Photoshop
nord.ase Adobe Swatch Exchange Adobe 系产品(Photoshop / Illustrator)
nord.gpa Gpick Palette Gpick
nord.gpl GIMP Palette GIMP、Inkscape、Krita
nord.mtl Alias / Wavefront Material 3D 建模软件

其中 nord.gpl 是纯文本格式,可直接打开查看其结构:GIMP Palette 头部声明 Name: Nord 与 Columns: 1,随后以 R G B name 三列逐一列出 nord0 ~ nord15 的 RGB 整数值(如 46 52 64 nord0)。nord.mtl 则以 newmtl nordX 声明 16 个材质,并用 Kd(漫反射)浮点值(如 0.180392 0.203922 0.25098)精确映射 16 色——从十六进制 #2e3440 换算出的十进制分量 46/52/64 除以 255 后正是 0.180392/0.203922/0.25098,可见各格式间数值完全自洽。

0.2.0:语法高亮配色规范的正式化

0.2.0(2016-11-22)的 Improvements 小节记录了 Nord 设计史上最重要的一步:将此前已在各 Port 项目中实践、但从未落笔成文的语法高亮配色分配方案,正式写入官方文档。这些决策到今天仍是整个 Nord 生态的色彩语义基石,并与当前 src/nord.css 中的注释逐一对应。

nord8 与 nord14 的角色交换

❯ 交换了 nord8 与 nord14 的颜色定义(#1, 2a95e4c0):

  • nord8(#88c0d0) 作为调色板的核心强调色(accent color),负责 方法 / 函数(methods and functions);
  • nord14(#a3be8c) 负责 字符串与属性值(strings and attribute values)。

查看 src/nord.css 的注释,--nord8 明确写着 "Represents the accent color of the color palette. Main color for primary UI elements and methods/functions",并提示可用于 Markup 引用与链接 URL;--nord14 则标注为 "Main color for strings and attribute values",同时承担 UI 层 git/diff 新增与成功态可视化。

nord4 与 nord6 的角色交换

❯ 交换了标点与变量/常量的颜色(#2, f8231acd):

  • nord4(#d8dee9) 用于 变量与常量(variables and constants);
  • nord6(#eceff4) 用于 标点符号(punctuations)。

src/nord.css 中 --nord4 注释为 "Main color for text, variables, constants and attributes",--nord6 则注明 "Used for punctuations, carets and structuring characters like curly- and square brackets"。

nord13 接管正则表达式

❯ 新增 nord13 用于 正则表达式(regular expressions)(#3, adfcac5c)。在 src/nord.css 中,--nord13(#ebcb8b)的注释为 "Used for escape characters, regular expressions and markup entities",UI 层则对应警告与 git/diff 重命名。

新增 SVG 组件图

0.2.0 还随文档新增了配色组件的 SVG 矢量图变体,包括 Polar Night、Snow Storm、Frost、Aurora 四组组件图,可用于作品展示(showcases)或品牌概念设计。这些视觉素材当时位于 src/assets 目录(提交 78ef70b8),属于文档附属资产而非运行时依赖。

新增官方 Port 项目

同一版本注册了四个新的官方 Port 项目(eacf9078、51f46d1b、d51a995b),覆盖不同工具形态:

Port 项目 目标平台
Nord Eclipse Syntax Eclipse 语法高亮
Nord gedit gedit 编辑器
Nord Java Java 相关工具
Nord Tilix Tilix 终端模拟器

这正是 Nord "统一日常工具栈外观" 生态策略的体现:以同一套 16 色规范去覆盖代码编辑器、终端与 UI 库。

0.2.0:色板文件兼容性改进与工具链任务

除了文档层面的规范化,0.2.0 还包含一项关键的色板文件工程改进与两项工程化任务。

nord.ase 对 Adobe Photoshop CS6 的完全兼容

Improvements 中明确指出:原先的 nord.ase(Adobe Swatch Exchange 格式)由 Gpick 生成,0.2.0 起改用 Adobe Photoshop CS6 重新创建,从而与厂商格式规范完全兼容(#5, 30ae2f4b)。从当前仓库的二进制内容可以印证其结构:nord.ase 以 ASEF 魔数开头,随后按版本号、块计数、颜色块(RGB 模型,RGB 标记 + 三通道 float)与名称块(UTF-16 编码的 nord0 ~ nord15)排布——这是符合 Adobe Swatch Exchange 规范的标准布局。

工具链任务

Tasks / Toolbox 小节记录了 0.2.0 的工程化投入(#4, 00beff7d):

  • 新增 Travis CI 与 Circle CI 配置:为项目引入持续集成能力,保证源码、文档与色板在多环境下的一致性与可构建性;
  • 新增 npm registry 徽章:在 README 展示最新发布版本与下载量(提交 2c061e15)。

这些任务与当前仓库的工程化布局一脉相承:现代版本的 package.json 已把质量门禁扩展为 lint(stylelint 检查 CSS/Less/SCSS、eslint 检查 JS、remark 检查 Markdown、prettier 检查格式)与 test(即 lint 全量),并通过 .husky/pre-commit 配合 lint-staged.config.js 在提交前对暂存文件执行格式化与校验,配合 prettier.config.js 的 160 列换行与 less/scss/sh 解析器覆写,构成了比 0.2.0 时代更完整的质量体系。

源码级印证:16 色体系与四大色组

0.2.0 文档化的配色规范,其底层是 nord0 ~ nord15 四个具名色组的 16 个颜色。从 src/nord.css 可以提取完整色值及其语义分工:

色组 变量 色值 语法高亮语义
Polar Night --nord0 #2e3440 文本、背景、光标、花括号/方括号等结构字符
Polar Night --nord1 #3b4252 UI 元素较浅背景(如状态栏)
Polar Night --nord2 #434c5e 编辑器行高亮;UI 层选区/高亮色
Polar Night --nord3 #4c566a 注释、不可见字符、缩进/换行辅助线;UI 层禁用态
Snow Storm --nord4 #d8dee9 文本、变量、常量、属性
Snow Storm --nord5 #e5e9f0 UI 状态栏等较浅背景
Snow Storm --nord6 #eceff4 标点、光标、结构字符;UI 层背景/选区/高亮
Frost --nord7 #8fbcbb 类、类型、文档标签
Frost --nord8 #88c0d0 强调色:方法/函数、主要 UI 元素、引用与链接 URL
Frost --nord9 #81a1c1 关键字、运算符、标签、单位、分号/逗号/花括号类标点
Frost --nord10 #5e81ac doctype、import/include/require、预处理语句与 at-rules(@)
Aurora --nord11 #bf616a 错误、git/diff 删除、linter 标记
Aurora --nord12 #d08770 注解(annotations)
Aurora --nord13 #ebcb8b 转义字符、正则表达式、Markup 实体;UI 层警告与 diff 重命名
Aurora --nord14 #a3be8c 字符串、属性值;UI 层 diff 新增与成功态
Aurora --nord15 #b48ead 数字

同样的 16 色以四种语法形式在仓库中保持一致:CSS 自定义属性 --nordX(src/nord.css)、Less 变量 @nordX(src/nord.less)、SCSS 变量 $nordX(src/nord.scss)与 Stylus 变量 nordX = ...(src/nord.styl)。这种"一源多形式"的发布策略,保证了无论项目使用哪种 CSS 预处理技术栈,都能以最原生的方式接入同一套色板。

安装与使用

Nord 以 npm 包形式发布,package.json 的 files 字段明确打包了 src/nord.css、src/nord.less、src/nord.scss 与 src/nord.styl 四个源码文件。安装方式:

# npm
npm install --save nord

# yarn
yarn add nord

安装后可根据技术栈直接引用对应变量文件,例如在 SCSS 中:

@import "nord";

// 深色环境主题:nord0 用作背景
.background {
  background-color: $nord0;
}

// 浅色环境主题:nord4 用作文本
.text {
  color: $nord4;
}

(以上示例取自 src/nord.scss 中 $nord0 与 $nord4 的 @example 注释。)若使用原生 CSS,则直接引用 nord.css,随后以 var(--nord8) 等形式使用变量。对于设计工具场景,可改用 src/swatches/ 下的六种色板文件,将 Nord 一键导入 Photoshop、Illustrator、GIMP/Krita/Inkscape、Gpick、macOS 取色器乃至 3D 建模软件,与代码中的 16 色保持严格一致。

结语

从 changelog.md 可以清晰看到 Nord 的演进逻辑:0.1.0 完成"源码 + 文档 + 色板"三位一体的发布基线,0.2.0 则将散布于各 Port 项目的语法高亮配色实践正式沉淀为文档规范,并同步完成色板文件兼容性与 CI 工程化。今天仓库中的 src/nord.css、src/nord.less、src/nord.scss、src/nord.styl 与 src/swatches/ 六种色板,正是这两次版本决策的完整落地——无论你是想为编辑器定制语法高亮,还是为产品 UI 引入一套克制而丰富的北极蓝配色,都可以直接以这份 changelog 为索引,深入源码找到可复用的每一行定义。

登录后查看全文
nord