框架决策

继续使用 Quartz v4 · 最小化定制策略 · 分析于 2026-05-23

当前定制清单(vs Quartz 默认)

维度Quartz 默认本站当前定制原因
桌面 Explorer 排序 默认排序 固定板块顺序 + 按日期倒序 阅读列表 / 仓库列表两个板块独立,用户按时间浏览
PrevNext 导航 无此功能 自定义组件,仅阅读列表页面显示 借鉴博客框架的连续阅读体验,仓库列表不需要
Backlinks 去重 侧栏 + afterBody 各一份 桌面侧栏显示,移动端 afterBody 显示 避免同一份内容出现两次
Backlinks 标题 "Backlinks" / "反向链接" 重命名为 "关联阅读" 对非技术读者更友好
移动端图谱 显示 隐藏 Canvas/WebGL 在移动端不可交互,浪费渲染资源
移动端页面标题 显示 隐藏 文章标题已在正文中,节省顶部空间
移动端触摸优化 默认 touch-action: manipulation 消除 iOS Safari 双击缩放延迟
移动端 Explorer 溢出 overflow: hidden(会裁剪 drawer) 展开时 overflow: visible 修复移动端 drawer 展开内容被截断的 Quartz bug
移动端文件夹缩进 默认多层缩进 减小缩进 窄屏下多层缩进过大,标题被挤成几个字
桌面 ReaderMode 原生 toggle opacity 隐藏侧栏 + 浮动退出按钮 保留布局占位(不跳动),hover 失效时仍可退出
RSS 内容清洗 原样输出 HTML 剥除锚点 SVG 邮件客户端无法渲染锚点图标
邮件订阅 NewsletterFooter inline 表单 静态站点零成本获取订阅者
评论系统 Giscus + 暗色模式适配 为读者提供互动渠道
页脚部署时间 仅版本号 部署时间戳 方便确认站点维护状态
主题色 默认紫/灰 蓝色系 视觉偏好
字体 Inter + 等宽 Inter + JetBrains Mono(自托管) 代码阅读更舒适,无 Google Fonts 依赖

被放弃的定制(已回退)

早期版本 custom.scss 有 230+ 行移动端重写,后在审查中被认定为「过度定制」,与 Quartz 原生行为冲突。已全部回退,包括:

选型结论

评估维度Quartz替代方案 (Nextra/VitePress)结论
知识图谱D3.js + PixiJS 原生支持需手动实现或插件Quartz 胜
Obsidian 兼容[[wikilinks]]、反向链接、图谱原生需大量自定义Quartz 胜
构建速度~3s类似持平
静态输出纯 HTML + Vercel 部署同样支持持平
H5 体验原生可用,最小化定制即可更成熟的开箱体验略逊,但已通过回退解决
迁移成本需转换所有 wikilinks + frontmatter
个人品牌Digital garden 定位明确普通文档站Quartz 更匹配

核心原则

Let Quartz be Quartz。