Nord 调色板 changelog 全解读:0.1.0 至 0.2.0 的色板设计、语法高亮规范与工具链演进
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 为索引,深入源码找到可复用的每一行定义。