Category 布局使用说明
Category 布局是一个专门用于展示游戏分类页面的布局,提供了分页和网格展示功能,需要当前目录有一个同名文件夹
布局特性
-
游戏网格展示:
- 响应式网格布局
- 1-4 列自适应
- 每页显示 12 个游戏
-
分页功能:
- 自动计算总页数
- 显示页码导航
- 支持上一页/下一页
- URL 参数控制页码:
?page=2
-
空状态处理:
- 当分类下没有游戏时显示提示信息
- 提供友好的视觉反馈
使用方法
1. 基础配置
在 .mdx
文件的 frontmatter 中配置:
---
title: 分类名称 # 必填:页面标题
layout: 'category' # 必填:指定使用 category 布局
description: 分类描述 # 可选:分类描述
cover: '/path/to/img' # 可选:分类封面图
---
2. 目录结构示例
games/
├── fighting/ # 分类目录
│ ├── game1.mdx # 游戏页面
│ ├── game2.mdx # 游戏页面
│ └── game3.mdx # 游戏页面
└── fighting.mdx # 当前分类页面
布局功能说明
-
自动收集游戏:
- 自动收集当前目录下的所有游戏文件
- 不包含 index.mdx 文件
- 支持子目录中的游戏文件
-
分页处理:
- 每页显示 12 个游戏
- 自动根据游戏数量计算分页
- 通过 URL 参数
page
控制当前页
-
游戏卡片展示:
- 标题(必填)
- 描述(可选)
- 封面图(可选)
- 分类标签(可选)
- 发布日期(可选)
-
面包屑导航:
- 自动生成基于当前路径的导航
- 帮助用户了解当前位置
注意事项
-
确保分类目录下有游戏文件
-
游戏文件的 frontmatter 配置:
--- title: 游戏标题 # 必填 layout: default # 可选,默认使用 default 布局 description: 描述 # 可选 game: 游戏链接 # 可选:游戏 iframe 链接 cover: 封面图片 # 可选:游戏封面图 date: 2024-03-20 # 可选:发布日期 tags: # 可选:游戏标签 - action - multiplayer ---
-
游戏文件布局说明:
default
布局提供:- 游戏 iframe 嵌入
- 游戏信息展示
- 分享按钮
- 面包屑导航
- 也可以使用其他布局,但建议使用
default
以保持一致性
-
URL 中的分页参数格式为
?page=1
-
建议为分类页面添加合适的描述内容