← 所有文章

你好,世界:这个博客的第一篇文章

博客上线啦。简单说说为什么写、写什么,以及这个站点是怎么搭起来的。

终于把博客搭起来了。这是第一篇文章,也是一个占位:你可以直接改掉它,或者把它删掉。

为什么要写

想把平时折腾过的东西、踩过的坑、想明白的事情记录下来。写下来的过程本身,就是在把一件事真正想清楚。

这里会写什么

  • 技术笔记:工具、项目、踩坑记录
  • 折腾日志:做过的小东西
  • 偶尔的随笔

这个站点是怎么搭的

  • 用 Astro 生成静态页面,文章就是 src/content/posts/ 下的 Markdown 文件
  • 源码放在私有仓库,GitHub Actions 构建后把成品推送到公开仓库,由 GitHub Pages 发布
  • 评论用 giscus(基于 GitHub Discussions),搜索用 Pagefind,访问统计用 Cloudflare Web Analytics

怎么写新文章

在项目目录里运行:

npm run new "文章标题" my-first-post

它会在 src/content/posts/ 下生成一个带好 frontmatter 的草稿文件。草稿(draft: true)只在本地 npm run dev 里可见,把它改成 false 再推送,文章才会出现在线上。

写作的第一步永远是先写出来,哪怕写得不好。

评论