创建个人作业

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

Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. For more information on classroom admins, see "About management of classrooms."

关于个人作业

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

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

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

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

基本要求

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

创建作业

  1. 登录 GitHub Classroom
  2. 导航到教室。
  3. 作业 选项卡中,创建作业。
    • 如果这是您的第一次作业,请单击 Create assignment(创建作业)创建第一次作业
    • 否则单击 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 roles 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(继续)”按钮

选择集成开发环境 (IDE)

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

要为作业选择 IDE,请选择 Add an editor(添加编辑器)下拉菜单,然后单击您希望学生使用的 IDE。

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

为作业提供反馈

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

自动测试作业

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

在“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 上的用户帐户与您的名册中的标识符相关联。

You can see whether a student has joined the classroom and accepted or submitted an assignment in the Classroom roster tab for the assignment. You can also link students' GitHub aliases to their associated roster identifier and vice versa in this tab. To prevent acceptance or submission of an assignment by students, you can change the "Assignment Status" within the "Edit assignment" view. When an assignment is Active, students will be able to accept it using the invitation link. When it is Inactive, this link will no longer be valid.

个人作业

Monitoring students' progress

The assignment overview page provides an overview of your assignment acceptances and student progress. You may have different summary information based on the configurations of your assignments.

  • Rostered students: The number of students on the Classroom's roster.
  • Added students: The number of GitHub accounts that have accepted the assignment and are not associated with a roster identifier.
  • Accepted students: The number of accounts have accepted this assignment.
  • Assignment submissions: The number of students that have submitted the assignment. Submission is triggered at the assignment deadline.
  • Passing students: The number of students currently passing the autograding tests for this assignment.

后续步骤

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

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

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

延伸阅读

此文档对您有帮助吗?

隐私政策

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

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

做出贡献

或者, 了解如何参与。