创建个人作业

您可以为课程中的学生创建需单独完成的作业。

关于个人作业

个人作业是为参加 GitHub 课堂 课程的每个学生提供的课程。 学生应在没有其他学生帮助的情况下完成个人作业。

当学生接受作业时, GitHub 课堂 会自动为学生创建一个新仓库。 仓库可以是空的,您也可以从模板仓库创建这个仓库,加入启动代码、文档、测试和其他资源。 每个作业仓库都属于您在 GitHub 上的组织帐户。

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

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

基本要求

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

创建作业

  1. 登录 GitHub Classroom
  2. 导航到教室。
  3. In the Assignments tab, create the assignment.
    • If this your first assignment, click Create an assignment. 创建第一次作业
    • Otherwise, click New assignment. “New assignment(新作业)”按钮

设置作业的基本信息

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

指定作业名称

对于个人作业,GitHub 课堂 使用仓库前缀和学生的 GitHub 用户名对仓库命名。 默认情况下,仓库前缀是作业标题。 例如,如果您对作业 "assignment-1" 命名,学生在 GitHub 上的用户名是 @octocat,则 @octocat 的作业仓库的名称将是 assignment-1-octocat

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

作业标题和前缀

分配作业的截止时间

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

作业截止日期选择器

选择作业类型

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

选择作业仓库的可见性

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

您也可以决定是否授予学生对作业仓库的管理员权限。 如果学生应该能够执行作业仓库的管理任务,则授予管理员权限。 For more information, see "About repositories" and "Repository permission levels for an organization."

在“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(选择仓库)”下拉菜单查找用作作业启动代码的模板仓库

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

“Continue(继续)”按钮

Choosing an integrated development environment (IDE)

You can optionally configure an assignment to use an integrated development environment (IDE). IDEs allow your students to write code, run programs, and collaborate without installing Git and a full development toolchain on the student's computer. If you choose an IDE for an assignment, students can still check out and run code locally on a computer with the necessary software. 更多信息请参阅“集成 GitHub 课堂 与 IDE”。

To choose an IDE for the assignment, select the Add an editor drop-down menu and click the IDE you'd like your students to use.

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

为作业提供反馈

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

自动测试作业

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

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

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

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

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

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

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

为反馈创建拉取请求

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

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

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

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

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

邀请学生参加作业

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

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

您可以在作业的 All students(所有学生)选项卡中查看学生是否已进入教室或提交作业。 为防止学生接受或提交作业,取消选择 Enable assignment invitation URL(启用作业邀请 URL)。 要编辑作业,请单击 Edit assignment(编辑作业)

个人作业

后续步骤

  • 在创建作业后,学生可以使用 Git 和 GitHub 的功能开始处理作业。 学生可以克隆仓库、推送提交、管理分支、创建和审查拉取请求、解决合并冲突以及讨论议题的更改。 您和学生都可以审查仓库的提交历史记录。 For more information, see "Getting started with GitHub," "Repositories," and "Collaborating with issues and pull requests."

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

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

延伸阅读

此文档对您有帮助吗?

隐私政策

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

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

做出贡献

或, 了解如何参与。