# qizhilu-template-v3

**Repository Path**: youidian/qizhilu-template-v3

## Basic Information

- **Project Name**: qizhilu-template-v3
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-01
- **Last Updated**: 2025-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 七只鹿游戏网站模板 V3

这是一个基于Next.js的模板网站项目。主要搭配qizhilu.com的快速建站工具使用。通过这个模板可以在编译期间调用api接口获取qizhilu.com上配置的网站数据，最终构建出一个纯静态的游戏网站，用于部署到任意服务器或者第三方平台上。

## API数据获取

本项目在构建时（SSG模式）通过API获取数据，支持以下功能：

1. 在构建时（generateStaticParams、generateMetadata等阶段）从API获取数据
2. 支持mock数据和真实API切换
3. 所有API请求都包含locale和project_id参数
4. 支持Next.js Draft Mode实时预览功能

### 环境变量配置

在`.env.local`文件中配置以下环境变量：

```
# 是否使用mock数据（true/false）
NEXT_PUBLIC_USE_MOCK_DATA=true

# API基础URL
NEXT_PUBLIC_API_URL=https://api.example.com

# 项目ID
NEXT_PUBLIC_PROJECT_ID=default-project

```

### API端点

项目使用以下API端点：

- `/game-cards` - 获取游戏卡片数据
- `/similar-games` - 获取相似游戏数据
- `/translations` - 获取翻译文本
- `/game-strategies` - 获取游戏策略数据

所有API请求都包含以下参数：

- `locale` - 语言代码
- `project_id` - 项目ID

### 使用方法

在页面组件中使用API客户端获取数据：

```typescript
import { getGameCards, getSimilarGames, getTranslations } from "@/lib/services/api-client";

export default async function Page({ params }) {
  const { locale } = params;

  // 从API获取数据
  const gameCards = await getGameCards(locale);
  const similarGames = await getSimilarGames(locale);
  const translations = await getTranslations(locale);

  return (
    // 使用获取的数据渲染页面
  );
}
```

## Draft Mode预览

项目支持Next.js的Draft Mode功能，用于实时预览内容。


## 开发

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建项目
npm run build

# 启动生产服务器
npm run start
```