这是本站的第一篇文章,也是这份脚手架的自述。

为什么选 SSG

博客的内容在写作时就定下来了,没有评论也没有登录,所以完全不需要服务端。把页面在构建时全部预渲染成 HTML,部署就只剩复制文件这一步。

好处很直接:

  • 没有运行时依赖,任意静态服务器都能跑
  • 首屏是现成的 HTML,不用等 JavaScript
  • 出问题时不用翻日志,因为根本没有服务进程

技术栈

用途选型
框架Nuxt 4
样式Tailwind CSS 4
组件daisyUI 5
内容@nuxt/content v3

目录结构

app/               页面、布局、组件、样式
content/posts/     Markdown 文章
shared/            页面与构建脚本共用的配置
deploy/            nginx 示例配置
dist/              构建产物(不进 git)

写一篇新文章

在 content/posts/ 下新建一个 .md 文件,填好 frontmatter 就够了。列表页、标签页、RSS 和 sitemap 都会自动带上它。

全部页面在 pnpm generate 时预渲染,因此不需要任何服务端进程。