这个博客是怎么搭起来的

从首页的粒子字标到文章的分类和标签,这篇记录 jamba.blog 的设计取舍:为什么用 Markdown 文件写文章、为什么是静态网站、文章怎么分类和发布。

写博客最怕两件事:搭得太复杂,最后懒得更新;做得太简陋,打开就不想读。这个博客的设计就是在这两件事之间找平衡。

先定两个原则

第一,打开就能读。首页第一屏就要看到文章列表,而不是一整屏的自我介绍。文章页只有一栏正文,字号和行距都按长时间阅读来定。

第二,写文章不能比写笔记更麻烦。一篇文章就是一个 Markdown 文件,写完提交,网站自动更新。

首页的粒子字标

首页顶部的 Jamba 字样由几千个光点组成,鼠标划过时光点会被推开,再慢慢飞回原位;没有鼠标的时候,每隔几秒会有一阵「风」扫过。

它是一个很轻的 Canvas 动画,不依赖任何动画库。系统开启「减少动态效果」时,动画只会变慢,不会停住。

文章怎么组织

每篇文章的开头写几行信息:

title: 这个博客是怎么搭起来的
date: 2026-11-03
category: tech
tags: [blog, nextjs]
series: building-this-blog
status: published
  • 分类只有四个,每篇文章选一个:AI 工作流、做产品、技术、随笔。
  • 标签可以随时加,用来串起同一个话题,比如 Claude Code、开源。
  • 系列用来放连载,文章页会显示这个系列的全部篇目和顺序。
  • 草稿把 status 写成 draft,正式网站就不会出现。

分类、标签、系列各自有列表页,全部文章页按月份排列,也可以用 RSS 订阅。

为什么是静态网站

整个博客在发布前就生成好所有页面,访问时不需要服务器现算。好处是打开快、几乎不会挂、搜索引擎拿到的是完整的正文。

博客的核心是内容,技术越少越好。

接下来

下一步是把这些年做开源项目的经验慢慢写下来。如果你对某个话题特别感兴趣,欢迎发邮件告诉我。

关注我,看下一篇更新,或 用 RSS 订阅