# 个人主页

**Repository Path**: mpyd/home

## Basic Information

- **Project Name**: 个人主页
- **Description**: 本仓库是基于 imsyy 个人主页源码，经南淮花酱修改后，由冒泡负责长期维护、功能迭代与问题修复的第三版本仓库。旨在提供一个美观、易用且可高度定制的个人主页解决方案。
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://mpzy.729520.xyz/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-23
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 个人主页, HTML, CSS, JavaScript, PHP

## README

# 个人主页源码仓库

![主页预览图](./preview.png)  
<!-- 上方换成自己的截图；若放在 docs 文件夹外，可写成 ./preview.png -->

## 仓库介绍

本仓库存储由 **imsyy** 创建的个人主页源码经过 **南淮花酱** 修改后获取的，现在是第三版本仓库，当前由 **冒泡** 负责长期维护、功能迭代与问题修复。  
项目基于原生 HTML / CSS / JavaScript 开发，无第三方框架依赖，轻量高效、易于定制，适合快速搭建个人展示页、博客入口或个性化导航站点。

## 语言切换
- 英文版本：[README.en.md](README.en.md) （点击即可查看英文说明）

## 项目版本
当前最新版本：v1.2.0

## 更新日志（CHANGELOG）
### v1.2.0（2025-12-26）
- 修复：修复随机背景图调用逻辑
  新增：页面访问统计卡片，全新的页面提示组件，新增页面设置板块，优化进入页面的欢迎


## 核心信息

| 角色        | 负责人            |
|-------------|-------------------|
| 初始创作者  | imsyy   |
| 二次修改者  | 南淮花酱   |
| 当前维护者  | 冒泡              |
| 技术栈      | HTML + CSS + JS   |
| 部署方式    | 本地预览 / 服务器部署 |

## 快速开始

### 环境要求

- 浏览器：Chrome、Firefox、Safari、Edge 等现代浏览器（版本 ≥ 90）
- 无额外依赖（无需 Node.js、PHP 等运行环境）

### 1. 本地预览（推荐）

```bash
# 克隆仓库
git clone https://gitee.com/mpyd/home.git
cd 个人主页

# 双击 index.html 即可本地预览
```

## 2. 服务器部署

```bash
将仓库内(所有文件及文件夹)完整上传至网站根目录（如 `wwwroot`）或子目录；  
访问对应域名或 IP 即可。
```

## 功能特性

- ✅ 响应式布局：完美适配移动端、平板、桌面端  
- ✅ 高度定制：个人信息、导航链接、配色方案、展示模块均可改  
- ✅ 轻量高效：原生代码无冗余，加载速度快  
- ✅ 易于拓展：结构清晰、注释规范，方便二次开发  
- ✅ 无依赖部署：无需构建工具，直接上传即可运行  

---

## 目录结构

```bash
├── index.html      # 主页入口
├── css/
│   └── style.css   # 核心样式
├── js/
│   └── main.js     # 交互逻辑
├── img/         # 图片资源
└── LICENSE         # MIT 许可证
```

## 定制指南

| 需求         | 操作位置                          |
|--------------|-----------------------------------|
| 修改个人信息 | `index.html` 对应标签内容         |
| 调整样式     | `css/style.css` 变量与参数        |
| 新增导航     | `index.html` 导航栏追加 `<a>` 标签 |
| 替换图片     | 放入 `images/` 并更新引用路径     |

## 贡献指南

1. **提交 Issue**：反馈 Bug 或功能需求，请注明复现场景  
2. **发起 Pull Request**：
   - Fork 本仓库 → 基于 `main` 创建功能分支（`feature/xxx` 或 `fix/xxx`）  
   - 确保本地测试通过 → 提交 PR，并写明改动内容与测试情况

## 常见问题

**Q1：本地打开样式错乱？**  
A：确认 `css/`、`js/`、`images/` 与 `index.html` 处于同一层级，且路径未改动。

**Q2：服务器部署后 404 或空白？**  
A：检查文件是否完整上传、目录权限是否 755、域名/IP 是否解析生效。

## 许可证

本项目采用 [MIT](./LICENSE) 开源许可证，允许自由使用、修改与分发，请保留原作者声明与许可证文件。