# 网站用 Vim 的语法来读

> source: 想法/草稿/网站用Vim的语法来读.md

> 前一轮的讨论在 [Vim 是一门描述文本变换的语言](/doc/dfeff37)。

## 问题

> 我的想法是，把Vim的操作以及文本编辑器的哲学融入这个网站里，而不只是做一个针对它的教程。我希望做的是让更多人了解到，这个编辑器原来不只是通过冒号加Q来退出，也不只是它那个永远退不出的梗。

## 核心判断

网站已经是一个 shell（见 [网站就是一个 shell](/doc/dab5a34)）：`ls` `cd` `cat`，是**在文件之间**移动的命令语言。shell 管不到的是**一页里面**：段落、句子、公式、代码块。Vim 正好是那一半——**对文档内部说话的语言**。

所以融进来的不是「Vim 键位」，而是一套**读者对页面内容说话的语法：动词 × 对象**。不教，只让人用；每次用鼠标做了一件事，提示符就回显它对应的那句 Vim。人是在回显里发现「原来这是一门语言」的。

### 现在的键位恰好是 Vim 的反面（2026-11-04 看 `app.ts`）

- 单个字母直接跳栏目（`NAV_KEYS`，取自顶栏 `data-key`），`s` 是 fzf，`v` 是唱片机，`q` 退出，`1–4` 切缩放，`j/k` 在列表里移动。
- 这是「一键一功能」的快捷键模型，也就是 GUI 的模型：字母是一袋按钮，不能组合。Vim 的发明恰恰是让字母变成词。
- 数字被缩放占了，就没法当次数用（`3}`）。

## 方案

### 1. 腾出字母：栏目放到 `g` 底下，缩放放到 `z` 底下

- 跳栏目 `ga` `gw` `gm` …（Vim 的 `g` 本来就是「去往」的前缀，GitHub、Gmail 也这么用）。
- 缩放就是 Vim 的折叠：`zM` 全收 = 一句话，`zR` 全开 = 全貌，`zm` / `zr` 一级一级收放，`zo` / `zc` 只开关光标所在的那一折。文章里已经有 `<!-- fold -->` 标记，正好是折叠点。
- 数字空出来当次数。

### 2. 页面自己的文本对象

| 对象 | 是什么 | 例 |
|---|---|---|
| `p` | 段落 | `yap` 复制这一段 |
| `s` | 句子 | `yis` |
| `$` | 公式 | `yi$` 复制这条公式的 LaTeX |
| `c` | 代码块 | `yic` 只复制代码，不带行号 |
| `h` | 小节 | `vah` 选中整节 |
| `l` | 链接 | `gx` 打开 |
| `f` | 脚注 | |

动词只要几个，每个都真的有用：

- `y` 复制：带出处，复制出来是「原文」——kihara.cn/…#p12。
- `v` 选中：高亮，并把地址改成能分享的锚点 `#p12-p14`，别人打开就看到同一段高亮。
- `z` 折叠（见上）。
- `K` 查：光标停在「巴塞尔问题」这种词上按 `K`，跳到知识库的条目（Vim 里 `K` 就是查光标下的词）。

光标就是当前段落左边的一条细线，`j/k` 按段走，`}` `{` 按节走，`gg` `G` 到头到尾。

### 3. 让语法看得见（这是 Vim 本身最缺的）

- **showcmd**：按下 `y`，底下那一行显示 `y_`，并列出这一页能接的对象（`p 段落 · $ 公式 · c 代码 …`），像 which-key。Vim 难学是因为语法看不见，网站可以把它摆出来。
- **回显**：每执行一句，终端打出它，比如 `yap → 已复制第 12 段（带出处）`。
- **反向回显**：读者用鼠标点了公式旁边的「复制」，提示符轻轻显示一次 `yi$`。不教，只是告诉你「刚才那件事，有一句话可以说」。每种操作每位访客只提示一次。

### 4. 寄存器 = 摘抄本

`"ayap` 把这段摘进 a 本；`:reg` 列出你在全站摘过的东西；`:w 摘抄.md` 导出成带出处的 Markdown。只存在读者自己的浏览器里。

### 5. 宏 = 可以分享的阅读路线

`qa` 开始录，读者正常地读、跳、折叠、摘抄，`q` 停；`@a` 重放。录下来的按键串放进链接 `#@=…`，别人打开就按同样的路线走一遍。

这是那段解读里最深的一句话的实物：**操作也是数据**。而且它顺手就是第 3 层「人和 Agent 同一个接口」——一串按键就是一个驱动网站的程序，Agent 可以生成它，人可以读它。

### 6. `:g` = 全站过滤

- `:g/拉格朗日/`：全站每一行含「拉格朗日」的，按文章分组列出，每一行能跳。
- `:v` 取反。
- 现有的 `/open`（未答之问）其实就是 `:g/还没想通的/`，可以这样回显。

### 7. `:earlier` / 撤销树 = 文章的历史

- 在一篇文章里 `u` / `Ctrl-r` 一版一版往回走，`:earlier 3mon` 直接看三个月前的样子。网站已经有重编阅读、edition 行号、「草稿留在原地，能看见想法是怎么变的」。
- Vim 的撤销是一棵**树**不是一条线；想法草稿长出几篇文章，正好是分叉。

### 8. 跳转列表和标记

- `Ctrl-o` / `Ctrl-i`：沿着读过的位置前后走，回到的是那一段，不是页面顶上（比浏览器后退准）。
- `ma` 在这一段做记号，下次来 `'a` 直接回到这里。

### 9. 模式写在状态行上

网站其实已经有模式，只是没名字：在读 = NORMAL，在终端里打字 = 插入，选了一段 = VISUAL，敲 `:` = 命令行。底下那一行写出来 `-- VISUAL --`，`Esc` 永远回到读。

### 10. 关于那个梗：反过来用

- 在这个网站上 `:q` **永远有效**，而且是最轻松的出口：在文章里 `:q` 回到你来的那一段。`:wq` 把摘抄本存好再走。
- 连按三次 `Esc`、或者在终端里打 `exit` `quit`，状态行说：`输入 :q 退出——在这里它一直有效`。
- `Ctrl-c` 回显 Vim 自己那句「Type :qa! and press <Enter> to abandon all changes and exit Vim」，算致敬。

### 11. 外观上的小东西（便宜，但最先被看见）

- 每篇文章最后一行之后，左边一列 `~`，就像 Vim 空缓冲区。首页本来就叫 `~`。
- 状态行 `"文章/vim/index.md" 329L`。
- `:set nu` / `:set rnu` 打开段落编号——不只是装饰，引用 `#p12` 时要用。
- `:colorscheme` 切主题。

### 12. 手机：顺序反过来

手机没有键盘，那就长按一段，弹出 `y` `v` `z` `K` 四个动词——先选对象、再选动词，是 GUI 的顺序。键盘上是先动词再对象，是 Vim 的顺序。两种都在，`文章/vim` 可以正好拿这一对比来讲：**同一件事，两种语序**。

### 13. vim 那篇文章变成什么（2026-11-05 写成了 `文章/vim-language`，见 [Vim 是一门描述文本变换的语言](/doc/dfeff37)）

不再是教程。它是这套语法的说明书，开头一句：「你刚才在这个网站上按的，就是它。」演示区就是网站本身。

## 先做什么

1. **腾字母 + 文本对象 + showcmd + 回显**：`g` / `z` 前缀，`p s $ c` 四个对象，`y v` 两个动词，`:q`，文章末尾的 `~`。这一步做完，后面都只是加词。
2. 摘抄本（寄存器）、标记和跳转列表。
3. 宏路线、`:g` 全站过滤、`:earlier`。

## 定下来、做了的（2026-11-04）

> 做第一步

site 提交 `9048958`（已部署）：

- 栏目改成 `gh ga gw gb gi gm`，唱片机 `gr`；缩放改成 `zM zR zm zr z1–4`；数字空出来当次数。按旧的单字母（比如 `a`）会提示「去关于现在是 ga」。
- 文章里 `j k } { gg G` 移动段落光标（左边一条橙线，只移动视线，不留命令）；`y{i|a}{p s $ c h}` 和 `yy` 是新命令 `yank`，`v{i|a}{对象}` 和 `V` 是新命令 `visual`。`a` 统一表示「连边界」：段落、句子、小节连出处链接，公式连 `$$`，代码连 ``` 和语言。
- 选中后地址变成 `#p3-p5`，别人打开这个链接就是同样几段亮着。段号按阅读页里的块数，折叠的也算，所以在哪一级分辨率下都一样。
- 提示符下面一行是 showcmd：按到一半时列出能接什么；用鼠标点公式或代码的复制按钮时，提示一次对应的说法（每种只提示一次）。
- `:q :wq :x` 是 `exit` 的别名，`ZZ` 也行；连按三次 Esc 提示 `:q`。文章末尾有一列 `~` 和 `"路径" [只读] 行数L`。
- 手机宽度下不画光标线，只用底色表示选中。

暂时保留的：`q` 仍然是退出（宏录制是第三步）、`s` 仍然是搜索、`/` 仍然打开终端、文章列表里的 `f` `c` `r` 不变。在终端里打 `:q` 回车时，补全菜单会先亮出 `exit`，回车后记下的是 `exit`，不是 `:q`。

## 还没想通的

- 改掉单字母跳栏目，已经习惯的人（主要是作者自己）会不会觉得变慢了？`g` 前缀多按一下，换来的是字母能组合。
- 宏路线的链接里要不要限制能执行的命令（只读的：跳转、折叠、高亮），防止有人做一个「打开就把你摘抄本清空」的链接？
- 光标（当前段落）在鼠标滚动时跟不跟着走？跟着走就要定义「视口中的哪一段」。
- 不懂 Vim 的人第一次来，完全不知道这些存在——反向回显够不够让人发现？还是首页要有一行入口？

## 模式用颜色说出来（2026-11-05）

作者的想法：整个网站都按 Vim 的三种模式走，每种模式一个主题色，换模式时整站的强调色跟着换，一眼就知道现在按键会被当成什么。这正是 lualine / airline 状态栏的做法，搬到整个页面上。

已经有的：普通模式（`j k` 移动段落光标）、可视模式（`v` `V` 选段落、地址变成 `#p3-p5`）、命令行（`:`），打字的地方（终端提示符、搜索框、文章里的 Vim 练习框）就是插入模式。缺的是一个全站的「当前模式」状态，和每种模式一套颜色。

做法草案：

- `<html data-vmode="normal|insert|visual|cmdline">`，由 `src/vim.ts` 和焦点事件维护；练习框拿到键盘时，框里的模式也写到这里。
- 每套配色多定义 `--mode-insert` `--mode-visual`（普通模式就是这套配色本来的 `--accent`）。换模式时把 `--accent` `--accent-bg` `--accent-ink` 换成那个模式的颜色，0.2s 过渡。
- 惯例色：普通 = 配色本来的强调色（默认橙）；插入 = 绿；可视 = 紫；命令行 = 黄。phosphor 配色本来就是绿，插入要换成别的颜色。
- 页头右边加一个模式标签（`NORMAL` / `INSERT` / `VISUAL`），底色就是模式色。

作者选了「只换和按键有关的那几处」，但要更明显、要有过渡。做成了：顶边一条 3px 的模式色线，换模式时从左往右扫一遍；页头一个实心模式标签（`NORMAL` / `INSERT` / `VISUAL` / `COMMAND`），换的时候从上面落下来；`--mode` 用 `@property` 注册，所有用它的地方一起渐变 0.3s。练习框拿到键盘时把自己的模式借给全站。规则写在网站的 DESIGN.md「模式色」。

还没想通的：

- 四套配色 × 三种模式，每种都要看对比度；红色已经给了「错误」，不能拿来当模式色。
- 手机上没有键盘，模式还有意义吗？大概只剩「正在打字」和「选中了段落」两种。
