Category 布局使用说明

Category 布局是一个专门用于展示游戏分类页面的布局,提供了分页和网格展示功能,需要当前目录有一个同名文件夹

布局特性

  1. 游戏网格展示

    • 响应式网格布局
    • 1-4 列自适应
    • 每页显示 12 个游戏
  2. 分页功能

    • 自动计算总页数
    • 显示页码导航
    • 支持上一页/下一页
    • URL 参数控制页码:?page=2
  3. 空状态处理

    • 当分类下没有游戏时显示提示信息
    • 提供友好的视觉反馈

使用方法

1. 基础配置

.mdx 文件的 frontmatter 中配置:

---
title: 分类名称          # 必填:页面标题
layout: 'category'      # 必填:指定使用 category 布局
description: 分类描述    # 可选:分类描述
cover: '/path/to/img'   # 可选:分类封面图
---

2. 目录结构示例

games/
├── fighting/           # 分类目录
│   ├── game1.mdx      # 游戏页面
│   ├── game2.mdx      # 游戏页面
│   └── game3.mdx      # 游戏页面
└── fighting.mdx       # 当前分类页面

布局功能说明

  1. 自动收集游戏

    • 自动收集当前目录下的所有游戏文件
    • 不包含 index.mdx 文件
    • 支持子目录中的游戏文件
  2. 分页处理

    • 每页显示 12 个游戏
    • 自动根据游戏数量计算分页
    • 通过 URL 参数 page 控制当前页
  3. 游戏卡片展示

    • 标题(必填)
    • 描述(可选)
    • 封面图(可选)
    • 分类标签(可选)
    • 发布日期(可选)
  4. 面包屑导航

    • 自动生成基于当前路径的导航
    • 帮助用户了解当前位置

注意事项

  1. 确保分类目录下有游戏文件

  2. 游戏文件的 frontmatter 配置:

    ---
    title: 游戏标题        # 必填
    layout: default      # 可选,默认使用 default 布局
    description: 描述     # 可选
    game: 游戏链接        # 可选:游戏 iframe 链接
    cover: 封面图片       # 可选:游戏封面图
    date: 2024-03-20    # 可选:发布日期
    tags:               # 可选:游戏标签
      - action
      - multiplayer
    ---
  3. 游戏文件布局说明:

    • default 布局提供:
      • 游戏 iframe 嵌入
      • 游戏信息展示
      • 分享按钮
      • 面包屑导航
    • 也可以使用其他布局,但建议使用 default 以保持一致性
  4. URL 中的分页参数格式为 ?page=1

  5. 建议为分类页面添加合适的描述内容