Purexua's Blog

📝 项目简介

这是一个个人博客网站的源代码仓库。该博客基于 Astro 构建，旨在分享技术和生活相关的文章和思考。通过这个平台，我希望能够记录生活点滴和分享技术经验。

✨ 特点功能

• 响应式设计，在不同设备上都能获得良好的浏览体验
• 文章分类与标签系统，方便内容组织和查找
• 极速加载体验（基于 Astro 的静态站点生成）
• 内置深色模式支持
• 支持 Markdown 和 MDX 写作
• SEO 友好的内容结构

🛠️ 技术栈

• 前端框架：Astro + TypeScript
• 样式解决方案：Tailwind CSS + Typography
• 部署平台：Cloudflare Workers & Cloudflare Pages

🚀 本地运行

# 克隆项目
git clone https://github.com/purexua/blog.git

# 进入项目目录
cd blog

# 安装依赖
npm install # 或 yarn install

# 启动开发服务器
npm run dev # 或 yarn dev

📁 项目结构

blog/
├── public/             # 静态资源文件
├── src/
│   ├── components/     # UI 组件
│   ├── content/        # 博客内容 (Markdown/MDX)
│   │   └── blog/       # 博客文章
│   ├── layouts/        # 页面布局组件
│   ├── pages/          # 路由页面
│   └── styles/         # 全局样式
├── astro.config.mjs    # Astro 配置
└── README.md           # 项目说明

🤝 参与贡献

感谢您对本博客项目的关注！以下是参与贡献的两种主要方式：

如何提交 Issue 分享您的看法

如果您对文章有任何意见、建议或发现了错误，欢迎通过 Issue 与我交流：

1. 访问本仓库的 Issues 页面
2. 点击 "New Issue" 按钮
3. 按以下格式填写内容：

针对文章内容的问题

标题规范：

针对文章的标题，请使用以下格式：about/fix/comment/other [post-id] 您的反馈/问题 - 文章标题 例如：fix [post-1] 代码示例有误 - 在 Ubuntu 上安装 MySQL 数据库 或 comment [post-2] 写得太好了，赞！

描述规范：

## 文章信息
- 文章标题：[例如：在 Ubuntu 上安装 MySQL 数据库]
- 文章文件路径：[例如：src/content/blog/post-id.md]
- 文章链接：[如有，例如：https://blog.purexua.com/posts/post-id]

## 我的看法/发现的问题
[详细描述您的观点或发现的问题]

## 建议的改进（可选）
[如果您有具体的改进建议，请在此说明]

## 环境信息（如适用）
- 浏览器：[例如：Chrome 134.0.6998.35]
- 设备：[例如：iPhone 12, Windows 11]

针对网站设置、布局等问题

标题规范：

针对网站设置、布局等问题的标题，请使用以下格式：about/fix/comment/other [文件名] 您的反馈/问题 - 文章标题 例如：fix [astro.config.mjs] 网站布局不合理 - 博客页面 或 comment [index.astro] 网站功能建议

描述规范：

## 问题类型
- [ ] 网站布局
- [ ] 功能建议
- [ ] 性能问题
- [ ] 兼容性问题
- [ ] 其他

## 问题描述
[详细描述您遇到的问题或建议]

## 复现步骤（如适用）
1. [第一步]
2. [第二步]
3. [...]

## 预期行为
[描述您期望的行为]

## 实际行为
[描述实际发生的行为]

## 截图（如有）
[可以附上相关截图]

## 环境信息
- 浏览器：[例如：Chrome 134.0.6998.35]
- 设备：[例如：iPhone 12, Windows 11]
- 屏幕分辨率：[例如：1920x1080]

4. 提交 Issue

我会认真阅读每一条反馈，并在适当的时候回复或采纳您的建议。

如何提交 PR 修正文章内容

如果您希望直接参与改进文章内容，可以通过 Pull Request 提交修改：

1. Fork 此仓库到您的 GitHub 账号
2. 克隆您 fork 的仓库到本地

   git clone https://github.com/您的用户名/blog.git

3. 创建一个新的分支用于修改

   git checkout -b fix/article-content

4. 进行必要的修改（文章位于 src/content/blog/ 目录）
5. 提交您的更改

   git commit -m 'fix: 修正了 MySQL 安装指南中的命令错误'

6. 推送到您的 GitHub 仓库

   git push origin fix/article-content

7. 在 GitHub 上创建一个 Pull Request，详细说明您的修改内容和原因

📌 未来计划

• 添加评论功能
• 优化移动端体验
• 集成搜索功能
• 添加多语言支持
• 集成访问统计

📝 许可证

暂无

📞 联系方式

• 📧 邮箱：purexua@gmail.com
• 🌐 个人网站：https://blog.purexua.com
• 💬 社交媒体：Twitter | GitHub

---

❤️ 感谢您的访问和支持！