站点设计
本页规定站点的样子:网格、字体、颜色,以及取自终端历史的细节。样式表 site/assets/css/site.css 是它的实现。两者不一致时,以本页为准。
想法
整体朴素,细节在局部。三个决定撑起整个设计。
- 一张网格。 页面是一块屏幕,用字符来量。它的各个宽度,就是它之前那些终端的宽度。
- 两种声音。 正文用无衬线字体。标签、元数据、导航和代码用等宽字体。人在说话,机器在标注。
- 两种颜色。 蓝色标出你能去哪。玫红标出你在哪,以及什么需要你。
线只画在有含义的地方:状态行、表格的横线、页面结尾的记号。页头下面没有线,页脚上面也没有线。
网格
一列是一个代码字符的宽度。
| 部分 | 列数 | 最小宽度 | 原因 |
|---|---|---|---|
| 正文 | 80 | 36 rem | VT100 屏幕的宽度。80 个字符的一行代码不用滚动就能放下。 |
| 导航 | 24 | 12 rem | |
| 本页内容 | 20 | 10 rem | |
| 栏间距,两处 | 4 | 2 rem | |
| 整页 | 132 | VT100 的宽模式。 |
- 读者的代码字体很窄时,最小宽度保证页面仍然好读。它们的比例和列数的比例接近。
- 代码块向两侧页边各伸出两列。这样代码的文字和正文对齐,80 列也保持完整。
- 屏幕放不下三部分时,本页内容折叠成正文上方的一行。再窄一些,导航移到正文下面。
- 比正文宽的表格在自己的框里横向滚动。
字体
- 字体。 用读者自己系统里的无衬线字体和等宽字体。不下载任何字体。
- 字号。 正文是 17 px。
- 阶梯。 每一级乘以黄金比例的平方根,约 1.272。两级正好乘以黄金比例。
| 级 | 字号 | 用途 |
|---|---|---|
| −1 | 0.786 rem | 标签、元数据、代码 |
| 0 | 1 rem | 正文 |
| 1 | 1.272 rem | 三级标题 |
| 2 | 1.618 rem | 二级标题 |
| 3 | 2.058 rem | 页面标题 |
| 4 | 2.618 rem | 纸带的高度 |
| 6 | 4.236 rem | 首页上的名字 |
- 节奏。 正文一行高 1.618 rem,这是一行。段落之间的距离是一行除以黄金比例,也就是 1 rem。更小的距离继续除:0.618 rem 和 0.382 rem。更大的距离是整数行。
颜色
色板
浅色主题叫 Paper,深色主题叫 Glass。页面跟随读者系统的设置。
| 名称 | Paper | Glass | 用途 |
|---|---|---|---|
--paper |
#ffffff |
#070b18 |
页面 |
--surface |
#f3f5fb |
#0f1528 |
代码块、行内代码、按键 |
--ink |
#0a0f1f |
#eef1fa |
文字 |
--ink-2 |
#454e69 |
#a9b2cc |
次要文字 |
--ink-3 |
#5e6781 |
#7f89a6 |
标签、记号、输入框的边 |
--rule |
#d3d9e8 |
#27304d |
细线。从不单独承担任何含义 |
--blue |
#0047ff |
#7aa5ff |
链接、结构、已定的状态 |
--rose |
#db0a6c |
#ff6ba6 |
需要注意的文字和填充 |
--rose-signal |
#ff1f7a |
#ff5c9d |
只用于记号:当前位置、焦点环、名字 |
相对页面底色的对比度,按 WCAG 2 的公式计算:
| 名称 | Paper | Glass | 下限 |
|---|---|---|---|
--ink |
19.1 | 17.4 | 7 |
--ink-2 |
8.3 | 9.3 | 7 |
--ink-3 |
5.6 | 5.6 | 4.5 |
--blue |
6.3 | 8.1 | 4.5 |
--rose |
4.9 | 7.4 | 4.5 |
--rose-signal |
3.7 | 6.8 | 3 |
相对 --surface 也要满足同样的下限。有一项检查会读样式表:某个颜色低于下限,或者样式表和上面的色板表不一致,检查就失败。
规则
- 蓝色标出你能去哪。 链接、标题下面的记号、纸带上的数据孔、已定的状态。
- 玫红标出你在哪,以及什么需要你。 当前所在的栏目和页面、“本页内容"里正在读的那个标题、焦点环、等待决定的状态、搜索结果里的匹配、引文的边线。
- 玫红限量使用。 注意力是稀缺的,所以索取注意力的颜色也要稀缺。一屏之内蓝色比玫红多,墨色比两者都多得多。
- 没有第三种色相。 不用绿色表示好,也不用红色表示坏。状态靠文字和形状来表达,从不只靠颜色。
--rose-signal只用于记号。 在 Paper 主题里,它达不到小字需要的对比度。它用在形状上,也用在名字上,因为名字又大又粗。- 浅色调是混出来的,不是加进来的。 高亮是把某个颜色按固定比例混进底色。色板里不增加新颜色。
状态
| 状态 | 颜色 | 形状 |
|---|---|---|
draft、planning |
玫红 | 描边 |
discussion、active |
玫红 | 填充 |
accepted |
蓝色 | 描边 |
implemented、shipped |
蓝色 | 填充 |
rejected、withdrawn、superseded |
墨色 | 虚线描边,加删除线 |
描边是较早的状态,填充是较晚的状态。填充的状态用的是反显。
取自终端历史的细节
| 细节 | 位置 | 出处 |
|---|---|---|
| 纸带 | 每页标题下面 | 电传打字机读写的是八位纸带。 |
| 两种颜色的名字 | 页头、首页、页脚 | cotty 是 co + tty,tty 是 teletype(电传打字机)的缩写。 |
| 块状光标 | 名字后面 | 视频终端的光标。 |
| 下划线光标 | 每个二级标题下面 | VT100 的另一种光标形状。 |
| 反显 | 填充的状态、选中的文字 | 视频终端用来突出文字的属性。 |
| 80 列和 132 列 | 网格 | VT100 屏幕的两种宽度。 |
| Paper 和 Glass | 主题的名字 | 电传打字机把字打在纸上。最早的视频终端被叫作 glass teletype(玻璃电传)。 |
EOT |
每页的结尾 | 传输结束,ASCII 的控制字符 04。 |
/ 键 |
搜索 | ed 的搜索命令,后来 vi 和 less 也用它。 |
| 一段 shell 会话 | 地址不存在时显示的页面 | 文件不存在时 shell 打印的那句话。 |
纸带
- 标题下面的纸带就是这个标题本身:按 UTF-8 编码,每个字节打成一列孔。
- 最低位在最上面。和真实的纸带一样,输送孔上面有三条数据轨,下面有五条。
- 比例取自真实的纸带:轨距和列距都是 0.1 英寸,数据孔直径 0.072 英寸,输送孔直径 0.046 英寸。
- 数据孔是蓝色的。输送孔标记的是时间,用玫红。
- 超过 64 字节的标题在第 64 字节处截断。
- 纸带是装饰。读屏软件读不到它。
光标
光标闪四次就停下。页面上没有任何东西持续运动超过五秒。读者要求减少动效时,它完全不闪。
无障碍
- 文字满足上面表格里的对比度下限。
- 键盘走到的每个控件都显示玫红色的焦点环。
- 页面上的第一个链接可以直接跳到正文。
- 通向站外的链接带一个箭头。
- 打印时去掉导航,并把链接的地址打印出来。