耶温博客

关于本站

耶温

项目简介

SimpleBlog 是一个现代化、极简风格的个人博客系统，基于 React 18 + TypeScript + Vite 构建。

核心特性：静态站点生成 (SSG)、响应式设计、性能优化、SEO 友好、支持 Markdown。

技术栈

React 18、TypeScript 5、Vite 5、React Router 6、markdown-it、highlight.js

快速开始

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建生产版本
npm run build

环境要求：Node.js >= 20.11.0

写文章

在 blogs/ 目录下创建 .md 文件：

---
title: 文章标题
date: 2025-12-28
category: 分类/子分类
description: 文章描述
tags:
  - 标签1
  - 标签2
---

文章内容...

文章 ID 会在首次运行时自动生成。

常见问题

如何修改网站标题和描述？

编辑 src/config/index.ts 中的 SITE_CONFIG 和 SEO_CONFIG。

如何修改默认文章？

编辑 src/config/index.ts 中的 BLOG_CONFIG.defaultBlogId。

文章 ID 是如何生成的？

首次运行时自动生成 8 位随机 ID（小写字母+数字）。

项目结构

SimpleBlog/
├── blogs/          # 博客文章
├── public/         # 静态资源
├── scripts/        # 构建脚本
├── src/
│   ├── components/ # React 组件
│   ├── config/     # 项目配置
│   ├── pages/      # 页面组件
│   ├── hooks/      # 自定义 Hooks
│   └── utils/      # 工具函数
└── package.json

联系方式