https://github.com/zhitrend/personal-blog
个人博客项目:react + ts + cloudflare
https://github.com/zhitrend/personal-blog
Last synced: 11 months ago
JSON representation
个人博客项目:react + ts + cloudflare
- Host: GitHub
- URL: https://github.com/zhitrend/personal-blog
- Owner: zhitrend
- Created: 2024-12-22T15:23:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-23T16:23:07.000Z (over 1 year ago)
- Last Synced: 2025-03-24T09:17:33.153Z (about 1 year ago)
- Language: JavaScript
- Size: 769 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 个人技术博客系统
## 项目概述
这是一个现代化的个人技术博客系统,使用 Vue 3 + TypeScript 构建前端,Cloudflare Workers 作为后端,D1 作为数据库。项目追求极致的开发体验和卓越的用户交互。
## 技术栈
### 前端
- Vue 3
- TypeScript
- Tailwind CSS
- Vue Router
- Vite
### 后端
- Cloudflare Workers
- Hono 框架
- Cloudflare D1 数据库
- OpenAPI 规范
## 功能特性
- 响应式设计
- 深色/浅色模式切换
- 博客文章列表
- 博客文章详情页
- 在线写博客
- 科技感交互动画
- 移动端友好
## 项目结构
```
personal-blog/
├── frontend/ # Vue 3 前端项目
│ ├── src/
│ │ ├── views/ # 页面组件
│ │ ├── router.ts # 路由配置
│ │ └── index.css # 全局样式
├── cloudflare-workers/ # Cloudflare Workers 后端
│ ├── src/
│ │ ├── index.ts # 主入口
│ │ └── routes.ts # API 路由
└── wrangler.toml # Cloudflare 部署配置
```
## 本地开发
### 前提条件
- Node.js 18+
- npm 或 pnpm
- Cloudflare 账号
- Wrangler CLI
### 安装步骤
1. 克隆仓库
```bash
git clone https://github.com/zhangrongwu/personal-blog.git
cd personal-blog
```
2. 安装前端依赖
```bash
cd frontend
npm install
```
3. 安装后端依赖
```bash
cd ../cloudflare-workers
npm install
```
### 本地运行
1. 前端开发服务器
```bash
cd frontend
npm run dev
```
2. 后端开发服务器
```bash
cd cloudflare-workers
npm run dev
```
## 部署
### 前端部署 (Cloudflare Pages)
```bash
cd frontend
npm run build
npx wrangler pages deploy dist
```
### 后端部署 (Cloudflare Workers)
```bash
cd cloudflare-workers
npm run deploy
```
## 环境变量
在 `wrangler.toml` 中配置:
- `DATABASE_ID`: Cloudflare D1 数据库 ID
- `API_KEY`: 可选的 API 密钥
## 性能优化
- 使用 Vite 构建
- Tailwind CSS 按需加载
- Workers 边缘计算
- 响应式图像
- 代码分割
## 安全性
- CORS 配置
- 输入验证
- 可选的 API 鉴权
## 贡献指南
1. Fork 仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交代码 (`git commit -m '添加了一些很棒的特性'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request
## 许可证
MIT 许可证
## 联系方式
- 邮箱:zhangrongwuios@gmail.com
- GitHub:[@zhangrongwu](https://github.com/zhangrongwu)
## 最新部署
- 前端:`https://93c9ba5e.personal-blog-593.pages.dev`
- 后端 API:`https://personal-blog-workers.zhangrongwuios-c13.workers.dev/api/posts`
---
**注意**:项目正在持续开发中,功能和设计可能会有变化。