创建组分配

您可以为参加您课程的学生团队创建协作作业。

关于组分配

小组作业是在 GitHub 课堂 为学生组提供的合作课程。 学生可以像专业开发人员团队一样,在共享仓库中共同完成小组作业。

当学生接受小组作业时,该学生可以创建新团队或加入现有团队。 GitHub 课堂 将任务团队保存为集合。 您可以在创建作业时为特定作业指定一组团队,并且在后面的作业中可以重复使用该组团队。

对于每个组的作业,GitHub 课堂 自动为团队创建一个单独的共享仓库进行访问。 这个仓库可以是空的,您也可以从模板仓库创建这个仓库,加入启动代码、文档、测试和其他资源。 仓库属于您在 GitHub 上的组织帐户,GitHub 课堂 授予学生在接受作业时创建或加入的团队访问权限。

每项作业都有标题和可选的截止日期。 您可以选择 GitHub 课堂 创建的仓库的可见性,并选择访问权限。 您还可以对作业自动评分,并创建专用空间与学生讨论作业。

您可以决定一个任务可以拥有多少个团队,以及每个团队可以拥有多少成员。 学生为作业创建的每个团队都是 GitHub 上组织内的团队。 团队的可见性是秘密。 您在 GitHub 上创建的团队不会出现在 GitHub 课堂 中。 更多信息请参阅“关于团队”。

有关创建小组作业的视频演示,请参阅“设置 GitHub 课堂 的基本知识”。

基本要求

您必须先创建一个课堂才能创建作业。 更多信息请参阅“管理教室”。

创建作业

如果在课堂中没有现有作业

要创建第一次作业:

  1. 登录 GitHub Classroom
  2. 导航到教室。
  3. 作业 选项卡中,单击 Create an assignment(创建作业)
创建第一次作业

如果在课堂中已经有现有作业

要创建作业:

  1. 登录 GitHub Classroom
  2. 导航到教室。
  3. 作业 选项卡中,单击 New assignment(新作业)
“New assignment(新作业)”按钮

设置作业的基本信息

指定作业的名称,决定是否分配截止时间,确定团队,并选择作业仓库的可见性。

指定作业名称

对于小组作业,GitHub 课堂 使用仓库前缀和团队名称对仓库命名。 默认情况下,仓库前缀是作业标题。 例如,如果将作业命名为 "assignment-1",而团队在 GitHub 上的名称是 "student-team",则团队成员的作业仓库的名称将是 assignment-1-student-team

输入作业的标题。 (可选)单击 以编辑前缀。

作业标题和前缀

分配作业的截止时间

(可选)您可以为作业分配一个截止日期。 在“Deadline (optional)(截止日期 [可选])”下,单击文本字段,然后使用日期选择器指定截止日期。

作业截止日期选择器

选择作业类型

在“Individual or group assignment(个人或小组作业)”下,选择下拉菜单,然后单击 Group assignment(小组作业)。 创建作业后不可更改作业类型。 如果要创建个人作业,请参阅“创建个人作业”。

确定作业的团队

如果已为教室创建了小组作业,可以对新作业重复使用一组团队。 要使用学生为作业创建的团队创建一个新组,请输入组的名称。 (可选)键入团队成员和团队总数的最大数量。

提示

  • 我们建议在组的名称中包含有关该组团队的详细信息。 例如,如果要对某个作业使用团队组,请以作业命名该组。 如果要在整个学期或课程中重复使用该组,请以学期或课程命名该组。

  • 如果想将学生分配到特定团队,请为学生指定团队的名称并提供成员列表。

用于参与小组作业的团队的参数

选择作业仓库的可见性

作业的仓库可以是公开或私有的。 如果您使用私有仓库,只有学生或团队可以查看您提供的反馈。

您也可以决定是否授予学生对作业仓库的管理员权限。 如果学生应该能够执行作业仓库的管理任务,则授予管理员权限。 更多信息请参阅“关于仓库可见性”和“组织的仓库权限级别”。

在“Repository visibility(仓库可见性)”下,选择可见性。 (可选)选择 Grant students admin access to their repository(授予学生对其仓库的管理员权限)

作业仓库的可见性选项

完成后,单击 Continue(继续)以配置起始代码和作业的开发环境。

“Continue(继续)”按钮

添加起始代码并配置开发环境

(可选)决定是提供空仓库还是启动代码,并为您的学生预配置开发环境。

选择模板仓库

默认情况下,新作业将为学生创建的每个团队创建一个空仓库。 您可以选择一个模板仓库作为作业的启动代码。 有关模板仓库的更多信息,请参阅“创建模板仓库”。

注意:模板仓库必须属于您的组织或是在 GitHub 上的公共仓库。

在“Add a template repository to give students starter code(添加模板存储库给学生启动代码)”下,选择 Select a repository(选择仓库 下拉列表,然后键入搜索查询。 在结果列表中,单击您想要用于启动代码的模板仓库。

使用“Select a repository(选择仓库)”下拉菜单查找用作作业启动代码的模板仓库

选择在线集成开发环境 (IDE)

您可以选择性地配置作业来使用在线集成开发环境 (IDE)。 在线 IDE 允许您的学生编写代码、运行程序并在浏览器中进行协作, 而无需在学生的计算机上安装 Git 和完整的开发工具链。 如果您为作业选择在线 IDE,学生仍然可以在本地查看并使用必要软件在计算机上运行代码。 更多信息请参阅“集成 GitHub 课堂 与 IDE”。

要为作业选择在线 IDE,请选择 Select an online IDE(选择在线 IDE)下拉菜单,然后单击您希望学生使用的 IDE。

使用“Select an online IDE(选择在线IDE)”下拉菜单对作业单击在线 IDE

完成后,单击 Continue(继续)配置项目的自动评分和反馈。

“Continue(继续)”按钮

提供反馈

(可选)您可以自动对作业进行分级,并创建一个空间,用于与团队讨论每个提交。

自动测试作业

您可以使用自动评分来自动检查学生在 GitHub 课堂 上的工作。 您可以为作业配置测试,每次学生推送到 GitHub 上的作业库时,测试就会立即运行。 学生可以查看测试结果,进行更改,并推送以查看新结果。 更多信息请参阅“创建自动评分”。

在“Add autograding tests(添加自动评分测试)”下,选择 Add test(添加测试)下拉菜单,然后单击您想要使用的评分方法。 更多信息请参阅“评分方法”。

使用“Add test(添加测试)”下拉菜单点击评分方法

定义测试案例的参数,如名称、命令、输入、输出、超时和点。 完成后,单击 Save test case(保存测试案例)

'用于自动评分测试的“Save test case(保存测试案例)”按钮

您可以在 Add test(添加测试)下拉菜单中添加更多测试,并且可以通过 编辑或删除现有测试。

用于编辑或删除自动评分测试的铅笔和垃圾桶图标

防止对重要文件的更改

您可以防止学生更改包含自动评分测试的文件,或作业仓库中其他重要文件。

在“Protected file paths(受保护的文件路径)”下,键入仓库内的相对路径以进行保护。

用于键入受保护文件路径的文本字段

为反馈创建拉取请求

您可以自动创建拉取请求,以在其中提供反馈并回答学生有关作业的问题。 有关拉取请求中更改审查的更多信息,请参阅“审查拉取请求中的更改”。

要创建用于讨论反馈的拉取请求,请选择 Enable feedback pull requests(启用反馈拉取请求)

“启用反馈拉取请求”复选框

要创建作业,请单击 Create assignment(创建作业)

“Create assignment(创建作业)”按钮

邀请学生参加作业

默认情况下, GitHub 课堂 会为您创建的每个作业启用邀请 URL。 当邀请 URL 启用时,学生可以接受并提交作业。 您可以在 LMS、课程主页或您发布作业的任何地方与您的学生分享 URL。 如果学生已接受课堂作业,学生也可以在 GitHub 课堂 上导航到作业。

警告:在分享邀请 URL 时要小心。 任何拥有作业邀请 URL 的人都可以接受邀请并将 GitHub 上的用户帐户与您的名册中的标识符相关联。

您可以在作业的 Teams(团队)选项卡中查看正在处理或已提交作业的团队。 为防止学生接受或提交作业,取消选择 Enable assignment invitation URL(启用作业邀请 URL)。 要编辑作业,请单击 Edit assignment(编辑作业)

组分配

后续步骤

  • 在创建作业和学生组成团队后,团队成员可以使用 Git 和 GitHub 的功能开始处理作业。 学生可以克隆仓库、推送提交、管理分支、创建和审查拉取请求、解决合并冲突以及讨论议题的更改。 您和团队都可以审查仓库的提交历史记录。 更多信息请参阅“GitHub 使用入门”、“创建、克隆和存档仓库”、“使用 Git”和“协作处理议题和拉取请求”,以及 GitHub Learning Lab 中的管理合并冲突课程。

  • 当团队完成作业时,您可以查看仓库中的文件,或者查看仓库的历史和可视化内容,以更好地了解团队如何协作。 更多信息请参阅“使用图表可视化仓库”。

  • 您可以通过在拉取请求中评论个别提交或行来提供作业反馈。 更多信息请参阅“评论拉取请求”和“从代码打开议题”。 有关创建已保存回复以对常见错误提供反馈的信息,请参阅“关于已保存回复”。

延伸阅读

此文档对您有帮助吗?隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。