中式网页主题库

一个事实：主流网页主题库里有日式极简，却几乎没有中式的。

我们查过某个 32 套主题的知名库——有 japanese-minimal、tokyo-night、nord、gruvbox， 一套中式的都没有。中文用户想做国风网页，只能自己从零调色。

什么时候用

做中国风网页/博客/文档站、给现有站换中式皮肤、要一套中式配色方案、中文长文阅读页排版。

8 套主题

主题	data-theme	色系	适合
水墨	ink	素白宣纸 · 墨黑	随笔、诗词、极简博客
青绿	azurite	石青 · 石绿	文旅、山水、《千里江山图》感
宋韵	song	天青 · 素雅	茶文化、克制的品牌站
敦煌	dunhuang	土红 · 石青	文化 IP、历史题材
朱砂	vermilion	中国红 · 墨	节庆、有力度的主张
新中式	neo	木色 · 素白	家居、当代品牌
竹韵	bamboo	竹青 · 米白	清雅、自然、健康
夜宴	night	墨底 · 暗金	深色模式

另有 auto —— 跟随系统深色偏好。

怎么用

1. 引入样式

<html lang="zh-CN" data-theme="ink">
  <link rel="stylesheet" href="themes.css">

2. 切换主题（改属性即可，无需重载）

document.documentElement.dataset.theme = 'azurite';

3. 可选装饰

<html data-theme="ink" data-paper="on">      <!-- 宣纸纹理 -->
<html data-theme="song" data-indent="print"> <!-- 首行缩进（印刷风）-->

接入现有网站时

用户要求保留原有正文、代码块或组件样式时，不要把主题 CSS 当作整站重置。优先给最短接入方案，并在上线清单里逐项写出这 6 类检查；不能因为其中一项看似与配色无关而省略：

1. 正文：行宽、字号、行高、段落间距没有被主题意外覆盖。
2. 移动端：窄屏无横向溢出，长标题、图片和表格仍可用。
3. 代码块：字体、背景、语法高亮、换行或横向滚动保持原行为。
4. 样式覆盖：确认样式加载顺序、选择器优先级和生产缓存；优先只覆盖变量。
5. 授权：主题本身只用系统字体；若项目另加字体、图片或纹理，必须核对商用许可与署名要求。
6. 无障碍：正文/链接/焦点对比度、键盘焦点和减少动态效果偏好可辨识。

如果用户只要审查或方案，不要生成整份 CSS，也不要为了“演示”修改文件。

关键：中文排版已内置

这是和普通主题库最大的区别——不只是换颜色，排版规范也写进去了：

项目	值	为什么
行高	1.75	中文字符方正，西文常用的 1.5 会挤
行宽	38em	中文一行 30-40 字最舒服
字体栈	西文在前、中文在后	混排时英文才好看
断行	line-break: strict	标点不出现在行首（避头尾）
强调	着重号，不用斜体	中文没有真斜体，会被拉斜变形
标题	衬线字体	宋体标题更有中文书卷气

CSS 变量（可覆盖）

每套主题定义这 8 个：

--bg           页面底色
--surface      卡片/代码块底色
--line         分隔线
--ink          正文文字
--ink-strong   标题/强调
--ink-soft     次要文字
--accent       强调色（链接、引用条）
--accent-weak  强调色的浅版

想微调，直接在自己的 CSS 里覆盖：

[data-theme="ink"] { --accent: #8C3A2E; }

无障碍

8 套主题的正文对比度实测在 9.4 – 12.2，均超过 WCAG AA 标准（4.5）。

选择建议

你的内容	推荐
文字为主的长阅读	ink、song（留白多、不抢戏）
需要一点色彩	azurite、bamboo
要有文化厚度	dunhuang
要热闹/有力	vermilion
商业品牌	neo
夜间阅读	night

边界

1. 不替你决定商用字体。主题用的是系统字体栈，不引入商用字体。若要用方正/汉仪等付费字体，授权自行核实。
2. 不做完整 UI 框架。这是排版主题，不含按钮、表单、栅格等组件库。
3. 配色是起点不是终点。品牌项目建议在此基础上按品牌色微调。
4. 文化元素慎用。若在主题外另加龙凤祥云等纹样，注意寓意与场合（参见 guochao-visual-cn 的纹样速查）。

相关

• chinese-typography —— 中文排版规范详解（本主题的排版部分基于它）
• guochao-visual-cn —— 国潮视觉，做图用（本主题做网页用）