Ink 与 Terminal 实验,2026-10-05
Ink 与 Terminal 已编入主题样式表并使用外观控件。两者仍为需要显式开启的实验,等待视觉定稿。
输入与方法
本实验基于 10 月 5 日工作树中的 Paper/Slate 实现。 工具为 macOS ARM64 上的 Hugo Extended 0.166.0、Go 1.27.1、Node 26.9.0、 Playwright 1.62.1。集成检查使用文档站与同级本地主题;站点公开 pin 仍为 v1.1.0。
首页、配置、提示块与标签页以相同内容比较四套预设、EN/ZH、390/1440 px 和浅深色。 检查真实字体、溢出、外观控件与本地字体请求。进一步的组件检查覆盖代码、参数字段、 Blog、Book、API、Mermaid、ECharts、搜索与打印。沿用站点既有边界,axe 不检查 API 供应商自有 DOM。
设计选择
| 选择 | 改善 | 代价 / 限制 |
|---|---|---|
| Ink:黑白画布、Inter、红色标记、正文链接下划线与粗标题线 | 少量装饰即可形成清楚的层级与链接信号 | 高字重标题与重复分隔线仍需长页编辑式评审 |
| Terminal:等宽控件与标题,无衬线正文与表格,青色链接与琥珀强调 | 保留段落可读性,同时形成明确的技术界面 | 长英文导航会更早换行,中文使用平台回退字体 |
| Ink 直角、Terminal 2 px 圆角,组件无阴影 | 相同内容与布局也能呈现明显不同的界面 | 局部组件规则增加 CSS,未抽离全局间距/圆角 token 层 |
| 只压紧 Terminal 桌面导航 | 展示更多有效导航行,不缩小正文 | 密度随预设固定 |
| 复用本地字体与状态管理 | 不新增字体文件、外部字体服务、框架或持久化机制 | 所有预设 CSS 仍在同一个样式表内 |
| 显式实验菜单选项 | 评审者可即时切换,普通菜单范围保持稳定 | 开启四张卡片后菜单更高 |
Ink 使用 #ffffff / #0b0b0b 画布、#141414 / #ededed 正文与
#c8102e / #ff5c4d 强调。Terminal 使用 #f4f5f2 / #0c0f0e 画布、
#1d211f / #d3dbd6 正文、#0a6560 / #4cc9bd 链接与
#935400 / #f0a73a 强调。站点与栏目强调色覆盖仍然优先。
Terminal 的标题标记使用空的无障碍替代文字,不支持的引擎省略标记。首页光标为
静态图形,不引入打字、闪烁、扫描线或发光效果。
试用
本地文档站已开启此列表。在外观菜单选择 Ink 或 Terminal,再独立选择亮色、暗色或
跟随系统。10 月 5 日菜单修订后,四个选项统一使用图标与名称按钮,不显示实验标记。
站点可以直接将任一实验设为 preset,不依赖读者菜单。preset_menu: true 仍提供
Paper/Slate 与站点默认值。选择站点默认预设会清除保存的预设。
字体覆盖、系统排版与 CSS 加载前初始化沿用
Paper/Slate 的契约。
验证
| 已执行检查 | 结果与范围 |
|---|---|
check-presets.py |
三类背景的正文/链接/强调色 AA、浅深色 token 对称、建议性背景亮度、冻结的 Slate v1.1.0 色板;七次严格构建、28 个文档根元素 |
| 主题检查 | 参数、字体角色、32 个语言包的 205 个键、生成 schema、组件/输出契约、运行时隔离与命名空间通过;52 个既有输出 golden 未改动 |
| 运行时测试 | 49 项 Node 测试通过 |
make check |
57 项非浏览器测试通过;EN/ZH 覆盖 142/142,Markdown、渲染内容与站内链接检查通过 |
| 标准浏览器套件 | 八套通过 170 项;修复下述默认 Terminal 构建问题后,外观套件 49 项全通过(初次运行加专项重跑合计 219 项) |
| 外观覆盖 | 四预设 × EN/ZH × 390/1440 px × 浅深色,检查首页、配置、提示块与标签页;本地字体请求、菜单 axe、状态、键盘、打印、Giscus 资源;四组实验/明暗检查覆盖 11 类页面与搜索,并检查共享 Mermaid 对比度 |
| 字体/配置构建 | 真实文档站以 Terminal 为默认值重建:系统字体、不带与带显式覆盖,以及 technical 显式字体覆盖,三组均通过 |
| 浏览器引擎 | Chromium、Firefox、WebKit 在 390/1440 px 下六项通过,覆盖 CSS 前状态、键盘依次选择 Ink/Terminal、持久化与焦点返回;桌面 Chromium 另用 4 倍 CPU 降速 |
| 视觉复核 | 96 张真实输出视口截图,查看了代表性首页、文档与手机菜单;本地对照页按内容、语言、尺寸与明暗选择截图,不注入样式 |
标准 sitemap axe 检查覆盖 15 个路径:EN/ZH 首页、配置、提示块、标签页、OpenAPI;
英文搜索、Mermaid、ECharts、Blog 与 /book/04-design/。既有响应式 axe 矩阵另行
运行。标准浏览器检查使用 4173 样例服务器;引擎专项使用同级主题 1313 开发服务器。
外观矩阵未观察到外部字体请求。
首次默认 Terminal 字体构建发现建议性背景亮度表漏项,造成强调色对比度误报警。 现已登记两套实验背景,并由检查器断言与显式强调色样例覆盖。修正后仅重跑受影响的 外观套件。新增研究索引和更新的提案描述经逐项审阅后,刷新 LLMS golden 中对应的 两处变化。
实验暴露了两处新增样式问题:全局禁用下划线的规则覆盖了 Ink 链接,Terminal 搜索
选中行的摘要仍使用弱化文字色。两者均作了局部修正。另一个继承问题是 Mermaid 深色
标签(#cccccc 配 #585858,4.43:1),在 Paper 与 Slate 中同样复现。共享的
明暗色板默认标签背景现改为 #404040,作者显式配置仍优先。
后续工作
晋升稳定选项前仍需真实 Windows 与 Android 设备评审,包括中文回退字体、下划线、 等宽标题换行与长参数表。人工屏幕阅读器朗读和首屏逐帧截图仍未验证。
Mermaid/ECharts 保留明暗色板,API 组件保留供应商样式;Giscus 检查针对生成的 色板资源。是否晋升 Ink/Terminal、是否重做图表色板仍待决定。