2026-05-24 收拾桌子 — 布局重构与框架页协作
本次会话做了什么
- 页面布局从 Quartz 默认改为:上通栏(黑底金字)+ 下三栏(左sticky/中可滚/右sticky)+ 底 footer
- 生成独立框架页 HTML 供用户直接修改样式,建立”用户改框架页→伯喈同步源文件”协作流
- 经历 30+ 次迭代调整顶栏高度/字号/搜索/footer 等细节
- 发现并修复 4 层 CSS 阻隔(body 8px → sidebar padding → grid gap → footer.scss 覆盖)
决定
- 框架页协作模式确立:框架页-完整版.html 作为中间媒介,用户直接改 CSS 预览,满意后伯喈同步到源文件
- 搜索保持 Quartz 默认模态(按钮弹出),不改为内联输入框
- 删除 ArticleTitle + PageTitle 组件,ContentMeta 移至左栏顶部
- 黑暗模式完全移除,仅保留 Specimen 暖纸底
新经验
- ✅ 成功模式:base.scss → custom.scss 的覆盖必须检查三点:①具体度 ②!important ③加载顺序(组件 scss 在 custom.scss 之后)
- ✅ 成功模式:CSS 子选择器
> 陷阱——DOM 中间多了 <header> 导致 .page-header > .search 永不命中
- ✅ 成功模式:Quartz Grid 覆盖需同时设
grid-template-areas: none,否则 base.scss 的 area 分配残留
- ⚠️ 教训:浏览器默认
body{margin:8px} 是最底层阻隔,排查时应从外到内逐层检查
- ⚠️ 教训:Quartz 组件 scss(如 footer.scss)在 custom.scss 之后加载,同选择器会覆盖,必须用
!important
自检
待办
- 框架页-完整版.html 与源文件之间如有差异需手动同步
- 移动端响应式未充分测试