book.imoons.cn 重新搭建完成:从 WordPress 到 Astro 的迁移复盘#

今天把 book.imoons.cn 彻底重新搭了一遍。不是小修小补,而是从底层框架到视觉呈现的一次完整重建。这篇记录一下过程、思路,以及我自己的一些体会。

为什么要重建#

book 之前跑在旧框架上,用的是 Next.js + contentlayer 的方案。说实话这套方案有两个一直让我头疼的问题:

一是发布太重。每发一篇文章要构建、要部署、要重启进程,流程长,还容易踩坑(比如 contentlayer 静默跳过文档导致文章 404,构建还显示成功)。

二是维护成本高。框架链路长,依赖多,出了问题排查起来费劲。

我想要的是一个”写完 markdown 就能上线”的轻量方案。正好 read.imoons.cn 的内容也需要一个更好的归宿,就决定一起解决。

做了什么#

1. 内容全量迁移#

read.imoons.cn 是 WordPress,里面沉淀了一百多篇文章。我把它们全部导出、转成干净的 markdown,迁移到了新站的 src/content/blog/ 目录。

迁移不是简单的搬文件,还做了几件事:

  • 文章正文从 HTML 转成 Markdown,统一格式
  • 图片本地化处理
  • 每篇文章的 frontmatter 规范化(标题、描述、日期、分类、标签)

2. 主题复刻#

新站用 Astro 静态框架承载,然后把 read 原站那套我很喜欢的主题(imoons-future)完整复刻了过来。导航、卡片、文章页、目录、页脚,核心结构全部保持一致。

这样迁移前后,读者看到的界面是连贯的,不会有”换了个网站”的割裂感。

3. UI 科技感升级#

在复刻的基础上,又做了一层视觉增强:

  • 深邃蓝黑的科技感底色,带细微网格和光晕
  • 毛玻璃导航,滚动时带阴影
  • 首页 hero 加了动态徽章和数据统计(文章数、标签数、分类数)
  • 卡片悬浮上浮、渐变描边、封面放大动效
  • 文章页排版打磨,标题渐变、代码块、引用块都做了优化

整体往”高端科技感”方向走,视觉上比之前精致了不少。

4. 标签体系补齐#

迁移后发现一个数据问题:124 篇文章里有 56 篇没有标签,标签云稀稀拉拉。

于是逐篇分析内容,把缺失的标签全部补齐。现在 124/124 篇文章都有标签,标签云扩展到 40 个标签,点击标签能正确搜索到对应文章,标签也会显示在文章内容页里。

5. 品牌焕新#

站点名从「不二的轻创业笔记」统一改为「不二笔记」,导航、标题、页脚、RSS 全部同步。

6. 发布流程重写#

重建后发布流程变得非常简单:

  1. 写一篇文章(markdown + frontmatter)
  2. 跑一次构建(自动生成搜索索引)
  3. nginx 直接伺服,立即生效

不需要重启进程,不需要复杂的部署步骤。整个过程从”写”到”上线”几分钟搞定。

现在的样子#

  • 框架:Astro 7 静态站,构建即发布
  • 内容:120+ 篇文章,覆盖运营日志、自我进化、生活随笔、最新项目等分类
  • 搜索:全站可搜,标签体系完整
  • 视觉:科技感主题,暗色优先,适配明暗切换
  • 证书:Let’s Encrypt 免费证书,自动续期

我的体会#

这次重建让我有几个比较深的感受:

轻量优先。博客这种内容站,最重要的是”写”和”发”的顺畅。越轻的链路,越能让人坚持记录。之前那套重框架,某种程度上成了我更新的阻力。

标签是内容的地图。补齐标签不只是数据完善,它让整个站点的内容有了结构。读者按标签能找到相关内容,我整理思路时也有据可依。

界面即诚意。一个用心设计的界面,本身就是对读者的尊重。科技感的视觉不是为了炫技,而是让阅读体验更好、更专注。

下一步#

book.imoons.cn 会作为新的主阵地,后续「生活随笔」「自我进化」这类内容都会发在这里。保持轻量、保持更新。

新站上线,欢迎来逛:https://book.imoons.cn/