# firefly

**Repository Path**: li-xing-language/firefly

## Basic Information

- **Project Name**: firefly
- **Description**: 简单的流萤展示单页
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 流萤 · Firefly 展示单页

《崩坏：星穹铁道》角色 **流萤** 的非官方粉丝展示单页。纯静态 HTML/CSS/JS，可部署至 Gitee Pages 或任意 Web 服务器。

## 本地预览

在项目根目录启动静态服务后访问：

```bash
# Python 3
python -m http.server 8080

# 或 Node（需已安装 npx）
npx serve .
```

浏览器打开：<http://localhost:8080>

> 直接双击 `index.html` 也可浏览，但部分浏览器对本地 `file://` 路径限制较严，建议使用上述方式。

## 目录结构

```
5_18/
├── index.html      # 单页入口
├── css/style.css   # 样式
├── js/main.js      # 交互（导航、滚动动画）
├── img/            # 图片素材
├── doc/            # 策划与文案文档
└── README.md
```

## 上传 Gitee

### 1. 在 Gitee 新建仓库

登录 [Gitee](https://gitee.com) → 右上角「+」→ 新建仓库 → 填写仓库名（如 `firefly-showcase`）→ 创建（可不初始化 README）。

### 2. 本地初始化并推送

在项目根目录 `e:\AI\5_18` 执行（将下方地址换成你的仓库 SSH 或 HTTPS 地址）：

```bash
git init
git add .
git commit -m "feat: 流萤角色展示单页"
git branch -M main
git remote add origin https://gitee.com/li-xing-language/firefly.git
git push -u origin main
```

### 3. 开启 Gitee Pages（可选）

仓库 → **服务** → **Gitee Pages** → 选择分支 `main`、目录 `/` → 启动。

部署完成后可通过 `https://你的用户名.gitee.io/firefly-showcase/` 访问（以 Gitee 实际域名为准）。

## 部署到自有服务器（Nginx 示例）

### 1. 上传文件

将项目全部文件上传到服务器，例如：

```text
/var/www/firefly/
├── index.html
├── css/
├── js/
└── img/
```

可用 `scp`、`rsync`、FTP 或 Git 拉取：

```bash
# 服务器上
cd /var/www
git clone https://gitee.com/你的用户名/firefly-showcase.git firefly
```

### 2. Nginx 配置示例

```nginx
server {
    listen 80;
    server_name your-domain.com;   # 改成你的域名或 IP

    root /var/www/firefly;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location ~* \.(css|js|png|jpg|jpeg|gif|webp|ico|svg)$ {
        expires 7d;
        add_header Cache-Control "public";
    }
}
```

重载 Nginx：

```bash
sudo nginx -t && sudo systemctl reload nginx
```

### 3. 子路径部署

若站点不在根路径（如 `https://domain.com/firefly/`），需将 `index.html` 内所有 `href="css/..."`、`src="img/..."` 改为带前缀路径，或使用 `<base href="/firefly/">` 标签。

## 说明

- 本站为非官方粉丝作品，版权归 miHoYo / HoYoverse 所有。
- 详细文案见 `doc/02-流萤角色介绍.md`。