跳转到内容
~/tosaki
返回

不再为了功利而写,博客内容与框架的同步升级

编辑页面

模板项目:AstroPages-Bilingual

截图

demo1.avif

demo2.avif

背景

正如我在关于所说,我的博客搭建初衷是为了求职,内容自然会以展现自己为主。而在秋招结束的现在,我不仅不再需要展示自己,反而需要隐藏之前为了求职而写的个人信息。另一方面,之前选择的AcademicPages框架本身就比较冗杂,特别是有非常多学术需求的代码和页面,对我来说并不需要;以及在一年来的自定义中也积累了许多屎山代码。此外,GitHub Actions + Pages + Cloudflare这种经典组合对编辑不是特别友好,需要本地编辑、Git提交等,为了中国大陆访问必须增加的CF CDN也容易导致更新不及时。因此我决定直接迁移到一个新的框架。

选型

我的需求主要包括简洁、美观、支持中英双语(母语和居住地语言),最好能支持直接提交而不是使用Git提交新文章。尽管我朋友的博客(详见底部友链)都使用了Hugo,但Gemini 3 Pro和ChatGPT 5.2都推荐我使用Astro (框架) + Keystatic (编辑管理),主题可选更偏向文档的Starlight或偏向简洁博客的AstroPaper。最后,我选择了基于 Astro v5 + AstroPaper、Keystatic CMS 和 Cloudflare Pages 搭建。以下是AI生成的对比:

维度AcademicPages (Old)Hugo (常规方案)Astro + StarlightAstro + AstroPaperAstroPaper Mod + Keystatic (Final)
底层框架Jekyll (Ruby)Hugo (Go)Astro (TS/Vite)Astro (TS/Vite)Astro v5 (TS/Vite)
核心定位学术履历、Paper 展示通用静态站文档站 (Documentation)极简博客 (Minimalist Blog)现代双语博客 + CMS
构建速度慢 (Ruby Gems 依赖)极快 (Go 二进制)快 (但逊于 Hugo)
UI/UX 风格传统简历风,较陈旧主题多样,但质量参差侧边栏导航,信息密度高纸张质感,排版舒适保留 AstroPaper 原貌,增加双语切换
i18n 支持 (需大量魔改 Liquid) (原生支持,但需主题适配) (原生路由级 i18n) (原生不支持多语言)自研适配 (利用 Astro v5 路由 + Collections 实现)
内容管理纯 Git 操作纯 Git / 配合外部 CMS结合 MDX结合 MDXKeystatic (Git-based CMS)
弃用/选用理由弃用:代码冗余,非学术场景显得臃肿,维护成本高。弃用:Go Template 修改门槛高,难找到完美支持双语的极简主题。弃用布局不符。虽 i18n 完美,但它是为文档设计的,作为以时间线的“博客”使用需要魔改太多布局。基底UI/UX 完美符合审美。代码结构清晰,虽缺 i18n,但自行补全的成本低于魔改 Starlight 的布局。选用:在 AstroPaper 的优秀 UI 基础上,补齐了 i18n 短板,并引入 Keystatic 解决发布流程痛点。

开发

开发这块没啥好讲的,比较繁琐,我直接让AI总结了一下:

基于该用户的 Git 提交记录,自版本 5.5.1(commit 25d2543)之后,其对框架进行了大量的二次开发,主要集中在双语支持 (i18n) 的深度集成、阅读进度条功能的增强以及部署文档的完善。

以下是所做修改的详细总结:

1. 核心功能:全站双语/多语言支持 (Bilingual Support)

这是所做改动最大、最核心的部分,将原本单语言的博客改造成了支持中英双语的系统。

2. 部署与文档 (Deployment & Documentation)

针对所使用的 Cloudflare Pages 部署环境进行了文档和说明的更新。

总结

该开发者在原有 AstroPaper(v5.5.1)的基础上,成功实施了完整的国际化改造,使其具备了生产环境可用的双语能力(包括路由、内容管理、偏好记忆、RSS等),同时对进度条 UI 进行了定制,并完善了相关的部署维护文档

其他

部署

部署直接使用Cloudflare Pages连接Git仓库即可,仓库修改后CF会自动重新构建并更新。部署后需要对Keystatic进行相关配置,具体流程详见模板仓库页面。

中国大陆优化

理论上像EdgeOne等服务应该能提供类似的Pages构建服务,同时有更好的中国大陆网络优化。不过近期我自己没有相关需求,因此暂时先用已经习惯的Cloudflare Pages,大多数情况下已经足够联通,至于直连访问速度你别管。若有大陆访问需求可以考虑用EdgeOne等类似服务。

SEO

这网站也没直接经济收益,所以肯定不会花太多精力在SEO上。不过目前看来.com域名对收录速度的提升很大,而且在Google Search Console中添加网站并输入sitemap效果也会好一些。网站架构本身对SEO应该是比较友好的。

版权说明

除非另有声明,本站文章均采用 CC BY-NC-SA 4.0 许可协议,这意味着您可以自由分享与演绎,但必须署名非商业使用并以相同方式共享。博客底层的源码(Codebase)和博客内容中的代码则遵循 MIT 协议,欢迎各位在 GitHub 上自由 Fork 或进行二次开发。


编辑页面
分享到:

下一篇
实测 Gemini 3 Pro:从零快速开发自走棋游戏