文档设计
一套用于独立HTML文档的设计系统。目标:在屏幕上正确显示,打印为PDF时干净整洁,且无需构建步骤——一个可在任何地方打开的文件。
复制 references/cv-template.html 作为起点;它已预先集成了以下所有内容。
设计令牌
将所有颜色和表面放在 :root 的自定义属性中,并添加深色模式覆盖。切勿在规则中硬编码十六进制值,这是文档可主题化和可打印的关键。
:root {
--doc-background: #ffffff;
--doc-background-mid: #eef0ee; /* 页面环绕 */
--doc-border-light: #e3e3e0;
--doc-text-primary: #1d1f22;
--doc-text-secondary: #5f6368;
--doc-accent: #1f6f5c; /* 一个强调色,谨慎使用 */
--doc-accent-soft: #e7f1ee; /* 标签/微色调背景 */
}
html[data-theme='dark'] {
--doc-accent: #4fbfa3;
--doc-accent-soft: #16332b;
}
规则:
- 使用一个强调色。 仅用于标记章节标题、职位/公司名称、项目符号,其他情况不用。到处使用强调色会被视为装饰。
- 使用两种文本颜色。 主要颜色用于内容,次要颜色用于元数据(日期、地点、注释)。
- 使用微色调,而非填充。 对于标签,使用
--doc-accent-soft而非实心强调色块。
布局
- 页面最大宽度 820px,居中,顶部外边距 24px。超过此宽度会影响行长度,降低可读性。
- 页面内边距 38–42px。 内边距承载视觉重量,因此无需外层边框。
- 页面环绕 使用
--doc-background-mid,使白色页面看起来像一张纸。 - 各部分之间以 15px 间距 堆叠。结构来自于间距和每个章节标题下方的一条细线,而非使用盒子或面板。
排版
- 系统字体栈,无网页字体:
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif。无需加载任何内容,离线也不会出错。 - 基准字号较小:屏幕上为 12.8px,行高 1.38。这是一份文档,而非博客文章——密度是特点之一。
- 字号缩放:姓名字号 28px/字重 700,章节标题字号 11.5px/字重 700 大写,字间距 1.3px,职位标题字号 13.5px/字重 700,正文 12–12.5px,元数据 11px。
- 章节标题使用大写和强调色,下方有一条细线。这是唯一的标题处理方式;不要添加另一层视觉层级。
- 断字和对齐:保持文本左对齐,切勿两端对齐。
打印规则
打印为 PDF 是主要用途,因此打印样式块与屏幕样式同样重要。
@page { size: letter; margin: 0 }并将内边距移至页面容器中,从而实现对边距的控制。- 强制白色背景并设置
print-color-adjust: exact,以便保留着色标签。 - 字号降至约 10pt,行高 1.3。屏幕上的字号在纸张上显得过大。
- 在每个职位、子职位和页眉上设置
break-inside: avoid,确保没有工作条目被分页断开。 - 隐藏交互式装饰——打印时隐藏按钮、样式化为控件的链接。
无障碍性
- 保持对比度:主要文本在白色背景上,强调色仅用于标题和标记。切勿将强调色用于长篇正文。
- 按合理顺序使用真正的标题元素(
h1、h2);通过 CSS 设置大写样式,而非在 HTML 中直接输入大写字母。 - 为链接提供描述性文本;不要仅依靠颜色来区分链接。
- 为项目符号保留语义列表结构——屏幕阅读器会播报列表长度,这在长简历中很有帮助。
反模式
- 多列布局——它们在打印中会出错,且屏幕阅读器会以错误的顺序阅读。
- 使用表格进行布局。
- 使用图片或图标字体代替文本;它们无法在 PDF 文本提取或 ATS 解析中幸存。
- 实心强调色页眉、渐变、内容上的投影,或每个部分之间的装饰性分隔线。
- 由浏览器注入的页眉和页脚(日期、URL、页码)——在打印对话框中禁用它们。