技术案例
unknownparticles.github.io
本站:静态内容工程
把个人网站当作一个持续验证的工程
- 01
Markdown - 02
Content schema - 03
Static routes - 04
Browser checks
问题:内容持续增长,入口保持稳定
技术博客要容纳文章、项目和案例,也要让旧链接继续可读。本站使用内容集合描述文章字段,在构建阶段生成日期路径和静态页面,把内容错误尽量前移到发布之前。页面无需常驻应用服务器。
实现:内容模型与渐进增强
content.config.ts 校验标题、日期和标签等字段,posts.ts 集中生成文章地址。静态 HTML 提供中文内容及导航;少量脚本负责语言、主题、标签过滤和几何交互。案例与项目共用数据,标题和摘要分别提供中文与英文。
取舍:静态交付与客户端状态
静态输出减少运行时服务依赖,代价是内容更新需要重新构建。语言偏好和主题保存在本地;英文内容依赖脚本切换,当前没有独立的英文 URL。Service Worker 提供离线回退,同时也需要考虑旧缓存与新部署的一致性。
验证:从类型到浏览器行为
npm run check 检查 Astro 和类型,npm run build 生成全部页面。Playwright 用例覆盖导航、语言持久化、主题、图片、标签过滤与离线回退。性能文章另通过 npm run test:article 提取并编译正文代码,校验示例不会只停留在文案层面。
边界:测试与实际体验
浏览器回归只能验证覆盖到的行为,不能替代真实读者反馈或完整无障碍审计。当前部署工作流运行类型检查与构建,浏览器回归和 C++ 示例校验可在本地执行。本案例没有用未测量的性能分数或访问量证明质量。
实现依据
从这些具体文件继续查看实现与验证范围。外部项目链接固定到审阅版本。