docs(changelog): 教程页三栏重排版条目

This commit is contained in:
3970260761 committed 2026-11-12 11:01:32 +08:00
1 parent 42e5b11c13
commit 2af613d8be
1 file changed
+6
+6
View File
@@ -6,6 +6,12 @@
## 2026-11-12
### ✨ 教程页三栏重排版(/article/* 可读性优化)
- 三栏布局:左浮动目录(224px sticky,`nav[aria-label="文章目录"]`,IntersectionObserver 滚动高亮 + 点击锚点平滑跳转,scroll-margin 让开 60px fixed 导航)+ 正文白卡(940px,段落/列表/标题/引用/代码间距全面加大,h2 加分隔线)+ 右浮动「更多教程」(256px sticky,原底部区块移至右侧固定)
- `<1280px` 回退单栏:目录隐藏、更多教程回正文下方全宽
- 验证:about / local-deploy-guide / mcp-guide 三页 1440 桌面三栏几何(toc x=28 / 正文 x=280 / 右栏 x=1141)、滚动 sticky 固定、目录点击跳转(scrollY=2589 + hash + active 同步)、900 窄屏单栏回退,验毕 FolderGuard 遮蔽还原(新 tab picker=function)
### 🐛 修复:文章列表被浏览器缓存导致「没有找到这篇文章」
- 根因:`/articles/` 下的 `index.json`/`.md` 此前无 `Cache-Control`,浏览器走启发式缓存,新增文章后用户端仍读旧列表,`ArticleDetail` 找不到条目即报「没有找到这篇文章:<slug>」
- nginx 修复:`location /articles/` 与 `location = /index.html` 加 `Cache-Control: no-cache`(每次协商校验,命中 304 不费流量;入口页不缓存可避免旧 html 引用已失效的 chunk hash);`/homeAssets/` 30 天 immutable 长缓存保留不变