Featured Games
Welcome to Game Launch Boost! Here you can find a curated collection of amazing games across different categories.
Featured 布局配置说明
Featured 布局通过 categories
配置来展示不同分类的游戏。每个分类最多显示 20 个游戏,以轮播的形式展示。
对应游戏卡片轮播图组件 src/components/GameCarousel.tsx
Categories 配置
在 frontmatter 中使用 categories
数组指定要展示的游戏分类:
categories:
- games/fighting # 格斗游戏分类
- games/arcade # 街机游戏分类
- games/popular # 热门游戏(自动收集)
- games/new # 最新游戏(自动收集)
建议文件结构如下:
pages/
├── en/ # 英文内容
│ ├── games/ # 游戏根目录
│ │ ├── fighting/ # 分类目录
│ │ │ ├── game1.mdx # 游戏页面
│ │ │ └── game2.mdx # 子分类
│ │ ├── arcade/ # 分类目录
│ │ │ └── game.mdx # 游戏页面,不需要配置 layout,使用默认布局
│ │ ├── sports/ # 分类目录
│ │ │ └── game.mdx # 游戏页面,不需要配置 layout,使用默认布局
│ │ ├── fighting.mdx # 分类页面,使用 Category 布局
│ │ └── arcade.mdx # 分类页面,使用 Category 布局
│ ├── index.mdx # 首页,建议使用 Featured 布局
│ └── download.mdx # 下载页面,这里是一个 landing 布局的示例
└── zh/ # 中文部分省略
└── ... # 文件夹省略
分类路径说明
- 路径格式要求:
- 路径区分大小写
- 子文件夹处理:
- 系统会自动遍历指定分类下的所有子文件夹
- 例如:配置
games/fighting
会包含:games/fighting/*.mdx
games/fighting/street/*.mdx
games/fighting/versus/*.mdx
- 以及更深层的子文件夹
- 游戏文件要求:
- 只收集
.mdx
文件 - 不收集
index.mdx
文件 - 文件必须包含有效的 frontMatter
注意事项
- 分类路径必须以
games/
开头 - 会递归收集子文件夹中的所有游戏
- 每个分类最多显示 20 个游戏,并以 4 个一组进行轮播展示
- 游戏文件要求:
- 必须是
.mdx
文件 - 不能是
index.mdx
- 必须包含有效的 frontMatter(至少需要 title)
- 必须是
- 分类标题会自动格式化(例如:‘fighting-games’ 显示为 ‘Fighting Games’)
- 如果分类下没有有效的游戏文件,该分类不会显示
- 游戏卡片显示内容:
- 标题(必填)
- 描述(可选)
- 封面图(可选)
- 分类(可选)
- 日期(可选)
分类目录结构
游戏分类使用文件夹结构组织,支持多级目录。基本结构如下:
pages/
├── en/ # 英文内容
│ ├── games/ # 游戏根目录
│ │ ├── fighting/ # 格斗游戏分类
│ │ │ ├── game1.mdx # 游戏页面
│ │ │ └── street/ # 子分类
│ │ │ └── game2.mdx
│ │ ├── arcade/ # 街机游戏分类
│ │ │ └── index.mdx
│ │ └── sports/ # 体育游戏分类
│ │ └── index.mdx
│ └── index.mdx # 当前页面
└── zh/ # 中文内容
└── games/ # 对应的中文游戏目录
支持的分类结构
- 基础分类:
games/fighting
- 格斗游戏games/arcade
- 街机游戏games/sports
- 体育游戏games/puzzle
- 益智游戏games/action
- 动作游戏
- 子分类示例:
games/fighting/street
- 街机格斗games/fighting/versus
- 对战格斗games/arcade/retro
- 复古街机games/sports/football
- 足球游戏
- 特殊分类:
games/popular
- 热门游戏(自动收集)games/new
- 最新游戏(自动收集)games/featured
- 精选游戏(手动配置)
分类页面配置
每个分类文件夹都可以包含一个 index.mdx
文件来配置分类页面:
---
title: Fighting Games
layout: category
description: Explore our fighting games collection
cover: /images/fighting-games.jpg
---
在 Featured 布局中使用分类
可以在 frontmatter 中指定任意层级的分类路径:
categories:
- games/fighting # 所有格斗游戏
- games/fighting/street # 仅街机格斗游戏
- games/arcade/retro # 复古街机游戏
注意事项
- 分类路径必须以
games/
开头 - 支持无限层级的子分类
- 每个分类文件夹建议创建
index.mdx
- 分类名称会自动格式化显示(例如:‘fighting-games’ 显示为 ‘Fighting Games’)
- 子分类会继承父分类的配置
Adding New Games
要添加新游戏,请按照以下步骤:
- 选择或创建适当的分类文件夹
- 在分类文件夹中创建新的
.mdx
文件 - 配置游戏的 frontmatter
- 添加游戏描述和内容
示例:
---
title: Street Fighter
layout: default
description: Classic fighting game
game: https://example.com/street-fighter
cover: /images/street-fighter.jpg
date: 2024-03-20
tags: [fighting, arcade, classic]
---