本页内容
  1. 想法
  2. 网格
  3. 字体
  4. 颜色
  5. 色板
  6. 规则
  7. 状态
  8. 取自终端历史的细节
  9. 纸带
  10. 光标
  11. 无障碍

本页规定站点的样子:网格、字体、颜色,以及取自终端历史的细节。样式表 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 也要满足同样的下限。有一项检查会读样式表:某个颜色低于下限,或者样式表和上面的色板表不一致,检查就失败。

规则

  1. 蓝色标出你能去哪。 链接、标题下面的记号、纸带上的数据孔、已定的状态。
  2. 玫红标出你在哪,以及什么需要你。 当前所在的栏目和页面、“本页内容"里正在读的那个标题、焦点环、等待决定的状态、搜索结果里的匹配、引文的边线。
  3. 玫红限量使用。 注意力是稀缺的,所以索取注意力的颜色也要稀缺。一屏之内蓝色比玫红多,墨色比两者都多得多。
  4. 没有第三种色相。 不用绿色表示好,也不用红色表示坏。状态靠文字和形状来表达,从不只靠颜色。
  5. --rose-signal 只用于记号。 在 Paper 主题里,它达不到小字需要的对比度。它用在形状上,也用在名字上,因为名字又大又粗。
  6. 浅色调是混出来的,不是加进来的。 高亮是把某个颜色按固定比例混进底色。色板里不增加新颜色。

状态

状态 颜色 形状
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 字节处截断。
  • 纸带是装饰。读屏软件读不到它。

光标

光标闪四次就停下。页面上没有任何东西持续运动超过五秒。读者要求减少动效时,它完全不闪。

无障碍

  • 文字满足上面表格里的对比度下限。
  • 键盘走到的每个控件都显示玫红色的焦点环。
  • 页面上的第一个链接可以直接跳到正文。
  • 通向站外的链接带一个箭头。
  • 打印时去掉导航,并把链接的地址打印出来。