本文摘要
jabinwan 的个人网站上线:基于 Refined-X(Astro + Starlight)模板深度定制的双语(中文/英文)个人站点,静态部分部署在 Cloudflare Pages,访问计数等轻量功能由 Cloudflare Workers 提供。

网站上线了。这里是第一篇文章,简单记录这个站点是怎么搭起来的。

技术选型

本站以 Refined-X 为模板,它是一个基于 Astro + Starlight 的 AI 友好型个人发布模板:

  • 一份内容,多种输出:同一份 Markdown/YAML,同时生成面向读者的网站、面向大语言模型的 llms.txt 与 Markdown 镜像、面向程序的 JSON API 与 OpenAPI 描述;
  • 纯静态优先:默认不需要任何后端服务,托管成本为零。

双语定制

模板原生只支持单一界面语言,本站在其基础上做了双路由改造:中文页面位于根路径(如 /writing/),英文页面位于 /en/ 前缀下(如 /en/writing/),页头提供了语言切换按钮。实现方式是”双遍构建”——构建时分别以两种语言各生成一份静态站点再合并,同一篇文章的中英文版本使用相同的 slug 与日期,从而一一对应。

部署

整站部署在 Cloudflare 上:

  • Cloudflare Pages 托管静态站点,推送代码到 GitHub 后自动构建发布;
  • Cloudflare Workers 提供一个轻量的访问计数 API,配合 KV 存储实现。

接下来

这里会持续更新我的写作与项目记录。欢迎通过关于页上的方式联系我。