欢迎来到我的博客

分类: 技术
Next.jsReact博客

欢迎来到我的博客

这是一个使用 Next.js App RouterReact Server Components 构建的现代博客。

特性

  • React Server Components - 减少客户端 JS 体积
  • 静态站点生成 (SSG) - 构建时预渲染所有页面
  • Markdown 支持 - 使用 Markdown 编写文章
  • 类型安全 - 完整的 TypeScript 支持
  • 现代化设计 - 简洁美观的 UI
  • 文章封面 - 支持为每篇文章设置封面图片,显示在详情页和列表页

技术栈

  • Next.js 14 - React 框架
  • React Server Components - 服务端组件
  • TypeScript - 类型安全
  • Markdown - 内容格式
  • remark/rehype - Markdown 处理

开始使用

  1. 安装依赖:
npm install
  1. 启动开发服务器:
npm run dev
  1. content/posts/ 目录下添加 Markdown 文件即可创建新文章。

文章格式

每篇文章需要包含 Front Matter:

---
title: 文章标题
date: 2024-01-15
excerpt: 文章摘要
tags:
  - 标签1
  - 标签2
category: 分类
coverImage: /images/cover.jpg  # 可选:封面图片链接
---

封面图片

coverImage 字段用于设置文章的封面图片,支持以下格式:

  • 相对路径/images/cover.jpg - 图片放在 public/images/ 目录下
  • 绝对路径https://example.com/image.jpg - 使用外部图片链接
  • 不设置:如果不设置 coverImage,将使用默认的渐变背景

封面图片会显示在:

  • 文章详情页的顶部(占满文章内容区域宽度)
  • 首页和列表页的文章卡片顶部

然后就可以开始写正文了!

下一步

  • 添加代码高亮
  • 添加搜索功能
  • 添加 RSS 订阅
  • 自定义主题

祝你使用愉快!🎉

目录