LapinEX 计算机社团网站

这是一个基于Hexo框架和Butterfly主题的大学计算机社团官方网站。

项目介绍

LapinEX计算机社团网站是为大学计算机社团设计的官方网站，提供社团信息、活动公告、技术博客、项目展示等功能。网站采用现代化设计，响应式布局，支持多种设备访问。

技术栈

• Hexo：静态网站生成框架
• Butterfly：美观、功能丰富的Hexo主题
• GitHub Pages：网站托管平台

功能特点

• 响应式设计，适配各种设备
• 社团介绍、团队成员展示
• 技术博客文章发布
• 项目作品展示
• 招新信息发布
• 保研和就业指南
• 站内搜索功能
• 评论互动系统

本地开发

环境要求

• Node.js (>= 12.0.0)
• Git

安装步骤

1. 克隆仓库

git clone https://github.com/PaxonHuang/LapinEX.git
cd LapinEX

2. 安装依赖

npm install

3. 本地预览

npm run server

4. 生成静态文件

npm run build

部署方式

方式一：GitHub Actions 自动部署（推荐）

本项目已配置 GitHub Actions 工作流，当您推送代码到 main 分支时，会自动构建并部署到 GitHub Pages。

1. 确保您的仓库已启用 GitHub Pages，并设置为从 gh-pages 分支部署
2. 推送代码到 main 分支

git add .
git commit -m "更新内容"
git push origin main

3. GitHub Actions 会自动构建并部署网站，您可以在仓库的 Actions 标签页查看部署进度

方式二：手动部署

如果您需要手动部署，可以使用以下命令：

npm run deploy

这将构建网站并推送到 gh-pages 分支

目录结构

LapinEX/
├── _config.yml          # Hexo配置文件
├── _config.butterfly.yml # Butterfly主题配置文件
├── package.json         # 项目依赖
├── scaffolds/           # 模板文件夹
├── source/              # 源文件
│   ├── _posts/          # 博客文章
│   ├── about/           # 关于页面
│   ├── contact/         # 联系页面
│   ├── projects/        # 项目页面
│   ├── teams/           # 团队页面
│   ├── jobs/            # 招新页面
│   ├── graduate/        # 保研页面
│   ├── career/          # 就业页面
│   └── img/             # 图片资源
└── themes/              # 主题文件夹（由npm安装）

贡献指南

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

联系方式

• 项目维护者：LapinEX团队
• 邮箱：[email protected]
• GitHub：https://github.com/PaxonHuang/LapinEX