系列文章

静态博客搭建

1 / 3

·随笔

欢迎来到 Rainy Den

博客的第一篇文章,介绍这个项目的初衷与基本结构。

目录 (4)

系列导读 · 静态博客搭建 第 1 / 3 篇
打开任意系列文章,页顶会出现系列导航卡片,可跳转到上一篇、下一篇或系列目录。

欢迎来到这里。这是一个用 Next.js 构建的静态博客,文章以 Markdown 文件的形式存放在 Git 仓库中。

为什么这样做

  • 内容即代码:文章 diff 清晰,版本可追溯
  • 写作自由:本地用任意编辑器写 Markdown,无需在线 CMS
  • 风格可控:前端完全自定义,没有模板束缚
  • 部署灵活:静态导出后可托管到 Vercel、Nginx、对象存储等任意平台

项目结构

content/posts/    # 文章 Markdown 文件
src/app/          # Next.js 页面
src/lib/          # 文章读取与渲染逻辑

系列文章怎么写

在 Frontmatter 里加上 series 字段即可:

series:
  name: "静态博客搭建"
  order: 1

同一 name 的文章会自动归为一组,按 order 排序。导航栏的 系列 页面也会列出全部连载。

下一步

你可以:

  1. 修改 src/lib/constants.ts 中的站点信息
  2. content/posts/ 添加新文章
  3. 运行 pnpm dev 本地预览
  4. 运行 pnpm build 生成静态站点

系列下一篇静态导出与暗色模式实践

祝你写作愉快。

相关文章