代码与开发

Astro 与 EmDash CMS 混合内容架构实战

探讨如何在同一个项目中同时融合 Astro 本地 Markdown 文件与 EmDash 无头 CMS,兼顾开发灵活性与在线管理便捷性。

在构建现代网站时,很多团队经常面临一个权衡:选择 Git 代码库管理的 Markdown,还是选择带后台界面的 CMS?

  • 本地 Markdown 的优势:开发者可以通过 VS Code 快速编写,结合 Git 进行精确的版本控制、Code Review 和 CI/CD 自动构建。
  • CMS 的优势:随时随地通过手机或浏览器登录后台快速发布动态、支持 Passkey 无密认证、实时管理媒体资产与读者互动。

为什么选择混合方案?

通过将本地 Markdown 文章与 EmDash CMS 动态查询合并,我们实现了:

  1. 统一数据流:无论是数据库中的文章还是本地仓库文件,在首页、列表页和 RSS 中均统一排序呈现。
  2. 渐进式迁移:现有的历史 Markdown 归档文件可以直接保留在仓库中,新增的动态文章则可在 CMS 后台在线撰写。
  3. 高可用性:即便在离线或者数据库维护阶段,本地静态内容依然稳固可读。

总结

这种设计不仅保留了极佳的代码整洁度,也让博客平台拥有了面向未来的扩展空间。