按分类与合集组织文档 URL,收紧导航与阅读排版 #2
Reference in New Issue
Block a user
Delete Branch "codex/docs-navigation"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
文档此前使用带编号的源文件路径作为公开地址,合集切换也缺少统一分类。现在为 33 篇文档登记稳定的语义 URL,保留旧地址永久跳转,语言设计与对象关系统一归入语言与运行时分类。顶部使用分类下拉选择,移除返回全部文档入口;目录、搜索、正文链接、源码入口与相邻文章使用相应身份。
侧栏收窄并压缩行高、分组和缩进,使用本地系统字体区分导航、正文、标题及代码,保留现有 TOC 布局与交互。
已通过 ESLint、tsc --noEmit --incremental false、33 篇路径与 28 条内部链接审查、git diff --check。用户已确认使用 ces-control runner。远程构建待本 PR CI 验证;浏览器刷新/前进后退/锚点交互验收尚未完成;auth-cli 已增加全部旧 URL 跳转与 TOC 锚点检查。Supabase 文档页面已读取,但浏览器视觉截图多次超时,尚未完成视觉比对。
配图 PR #3 已由用户手动合并至 main(7a9c88a)。本分支通过
c49c834合入最新主线并解决冲突,保留双图轮播与导航链接转换,将配图验收改用新的公开 URL。组合后的 ESLint、tsc --noEmit --incremental false 和 git diff --check 通过。远程 CI 以最新e286139为准;首次运行在 npm 依赖下载阶段超时,未进入代码检查。等待用户手动合并。远程构建发现旧地址不能在 getStaticProps 预生成阶段返回 redirect。e286139 将旧地址的 308 跳转移到登录验证通过后的 proxy 层,只预生成正式 URL;保留查询参数与 no-store。验收覆盖所有 33 个旧地址、查询参数、认证边界、TOC 与轮播。修复后的本地 lint、无输出类型检查通过,完整构建继续仅在 ces-control 执行。
最终验证:e286139 的 ces-control CI #434 已通过生产构建、图片压缩与一致性检查、SVG 可复现性测试、认证单元测试、Authentication exercise 和 verify(覆盖全部正式文档、33 个旧地址 308、查询参数、搜索、TOC 唯一锚点、轮播 WebP、重启后认证状态及 404)。导航 PR 尚未合并或部署,等待用户手动合并。浏览器人工视觉与前进后退操作尚未单独验收。
codex-bot referenced this pull request2026-10-28 10:57:22 +00:00