# 站点设计

地址: https://nowa.im/cotty/zh/handbook/site-design/  
状态: 草稿  
创建: 2026-11-22

本页规定站点的样子：网格、字体、颜色，以及取自终端历史的细节。样式表 `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 字节处截断。
- 纸带是装饰。读屏软件读不到它。

### 光标

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

## 无障碍

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