班级功能的使用

# 班级功能的使用

> 网站的基本功能与介绍请移步《学生篇》阅读。本文档只介绍仅教师需要了解的功能。

## 如何创建班级

> 教师需要为个人的每个教学进度的班级创建一个独立的班级，用于在班级内进行教学工作。
>
> 每位教师可以拥有的班级数量目前没有做限制。
>
> 普通学员目前不允许创建班级。

鼠标放在网页右上角个人用户名初，点击“我的班级“，或者访问链接：[我的班级 - TopsCoding](https://www.topscoding.com/home/domain)，即可进入个人班级列表，然后点击”创建班级“即可开始创建班级。

在弹出的页面上填入班级信息，然后点击确定即可创建好班级并自动跳转到该班级。创建班级的填表说明如下：

- ID(必填)：班级的全站唯一 ID，不可和其他班级的 ID 重复，它也将成为访问此班级的链接，创建后，浏览器访问网址 `www.topscoding.com/d/<填写的ID>/` 即可进入该班级；

- 名称(必填)：可以但不推荐重复，最好包含班级的年份、学习阶段、时间、学校等信息，例如”2023五十中信息社团“、”2024拓尔思宗师4班周六下午2-4点“；

- Gravatar Email 地址：可以不填，用于设置班级的头像，具体如何设置可参见 https://cn.gravatar.com/；【TODO: 班级头像功能后面会优化】

- 排行榜上的黑名单：此功能的作用在于将不需要参与班级排名的老师排除在外，只对学生进行排名，填入时，填写用户的 UID 即可，用英文逗号（,) 隔开；

- 当前班级的类型：班级共分为四种类型（状态）——

- 默认班级类型：主题库即此种班级类型，该类型班级在功能不做任何限制
    - 教学监督班级：设为此种类型的班级将会列入教师的后台管理中，方便教师对该班级进行教学管理，**如果教师希望在教学管理后台中能看见该班级，则应选择此类型**
    - 个人博客：此类班级不执行排名、更新 RP 等班级相关操作，也无法使用作业和比赛功能【TODO: 目前并未做额外限制】 
    - 关闭的班级：将会收起在已结业班级列表中，且不会做排名更新

- 公告：支持 markdown 语法，内容将显示在班级的”首页“的开头

- 倒计时：YAML 语法格式，用于设置班级内的一些重要事件（比赛、考试的倒计时），这些事件的倒计时将会显示在班级”首页“的右侧栏中。每个事件以 `-` 开头，以 `title,time,desc,url` 为关键字，其中描述(desc)和链接(url)选填，一个示例如下——

```yaml
    # 此段为注释说明，实际填写时请删除所有注释行
    # 填写顺序任意，但是必须填写 time 和 title
    # yaml 语法对空格缩进敏感，请保证缩进对齐，不要混用空格和 TAB
    # 如果有更多事件，依次填入即可
    # 各参数说明参加下面注释
    - desc: 全部都是选择判断题           # desc: 描述事件，选填，如填写，用户鼠标放在事件标题上会显示该说明
      time: 2024-09-21 00:00:00       # time: 时间格式只可以为 yyyy-mm-dd 或者 yyyy-mm-dd hh:mm:ss
      title: CSP-J/S2024第一轮认证      # title: 事件的名称
      url: https://www.noi.cn/xw/2024-02-04/813796.shtml   # url: 事件的链接，用户点击事件标题会跳转到该链接
    - time: 2024-10-26 00:00:00
      title: CSP-J/S2024第二轮认证
      url: https://www.noi.cn/xw/2024-02-04/813796.shtml
    ```

## 班级的权限设置

## 如何管理学员

### 1. 添加学员

添加学员有如下两种方法

使用网页前台页面添加班级成员

### 2. 移除学员

### 3. 修改学员权限

### 4. 如何批量添加班级成员

此功能需要在教学管理后台中实现，请移步对应文档阅读。

## 如何管理

TODO