← 全部项目

技术案例

unknownparticles.github.io

本站:静态内容工程

把个人网站当作一个持续验证的工程

  1. 01Markdown
  2. 02Content schema
  3. 03Static routes
  4. 04Browser checks
01

问题:内容持续增长,入口保持稳定

技术博客要容纳文章、项目和案例,也要让旧链接继续可读。本站使用内容集合描述文章字段,在构建阶段生成日期路径和静态页面,把内容错误尽量前移到发布之前。页面无需常驻应用服务器。

02

实现:内容模型与渐进增强

content.config.ts 校验标题、日期和标签等字段,posts.ts 集中生成文章地址。静态 HTML 提供中文内容及导航;少量脚本负责语言、主题、标签过滤和几何交互。案例与项目共用数据,标题和摘要分别提供中文与英文。

03

取舍:静态交付与客户端状态

静态输出减少运行时服务依赖,代价是内容更新需要重新构建。语言偏好和主题保存在本地;英文内容依赖脚本切换,当前没有独立的英文 URL。Service Worker 提供离线回退,同时也需要考虑旧缓存与新部署的一致性。

04

验证:从类型到浏览器行为

npm run check 检查 Astro 和类型,npm run build 生成全部页面。Playwright 用例覆盖导航、语言持久化、主题、图片、标签过滤与离线回退。性能文章另通过 npm run test:article 提取并编译正文代码,校验示例不会只停留在文案层面。

05

边界:测试与实际体验

浏览器回归只能验证覆盖到的行为,不能替代真实读者反馈或完整无障碍审计。当前部署工作流运行类型检查与构建,浏览器回归和 C++ 示例校验可在本地执行。本案例没有用未测量的性能分数或访问量证明质量。

实现依据

从这些具体文件继续查看实现与验证范围。外部项目链接固定到审阅版本。

← 继续看精选项目