背景
旧站每个章节都是独立页面，导航和搜索各有一套实现，深链接经常落到错误位置，移动端的表格也会撑破阅读栏。
重写把内容收进统一的目录结构，路由、搜索与侧边导航共用一份数据；阅读页保持窄栏，代码块与表格在移动端可以横向滚动。
做法
- 01
先把目录变成数据
章节、锚点与搜索索引来自同一份结构，深链接不再各自维护，新增页面只需要加一条数据。
代码编辑器中的目录与路由实现 - 02
重建阅读页
正文限定在可读宽度，代码块、表格和提示块统一组件；窄屏下表格改为可横向滚动，不挤压正文。
桌面与移动设备上的响应式页面 - 03
按性能预算验收
首屏只加载当前章节，图片与代码高亮延迟加载；用真实网络条件检查首屏可读时间。
图集
交付了什么
以可核对的交付物记录结果，不换算成无法验证的业绩数字。
- 统一的目录与路由结构
- 导航、搜索与深链接共用一份章节数据。
- 阅读页组件集
- 代码块、表格、提示块与锚点的统一实现。
- 无障碍与性能清单
- 键盘可达、对比度与首屏加载的检查项。
以上为过程与交付说明；站点访问数据由项目方统计。
搜索的第一版只做了标题匹配，正文关键词命中很差。后来补了分词与摘要，才真正可用。