【亲测免费】 nbgrader 使用教程

项目介绍

nbgrader 是一个用于创建和评分 Jupyter Notebook 作业的工具。它允许教师轻松创建包含编程练习和自由回答的笔记本作业，并提供了一个简化的界面来快速评分完成的作业。nbgrader 的核心功能包括生成学生版本的作业、发布作业给学生、收集作业、自动评分和手动评分。

项目快速启动

安装 nbgrader

首先，确保你已经安装了 Python 和 Jupyter Notebook。然后，使用以下命令安装 nbgrader：

pip install nbgrader

配置 nbgrader

创建一个 nbgrader_config.py 文件，并添加以下基本配置：

c = get_config()

# 配置交换目录
c.Exchange.course_id = 'example_course'
c.Exchange.root = '/path/to/exchange'

创建作业

使用以下命令创建一个新的作业：

nbgrader generate_assignment assignment1

发布作业

将作业发布给学生：

nbgrader release_assignment assignment1

收集作业

收集学生提交的作业：

nbgrader collect assignment1

应用案例和最佳实践

应用案例

nbgrader 在教育领域有广泛的应用，特别是在编程和数据科学课程中。教师可以使用 nbgrader 创建包含编程任务和理论问题的作业，学生可以在 Jupyter Notebook 中完成这些作业，并通过 nbgrader 提交。

最佳实践

1. 自动化评分：尽可能使用 nbgrader 的自动评分功能来减少手动评分的工作量。
2. 清晰的作业说明：在作业笔记本中提供清晰的说明和示例，帮助学生理解作业要求。
3. 定期更新：定期更新作业和评分标准，确保与课程内容同步。

典型生态项目

nbgrader 是 Jupyter 生态系统的一部分，与其他 Jupyter 项目紧密集成。以下是一些典型的生态项目：

1. JupyterHub：用于管理多用户 Jupyter Notebook 服务器，可以与 nbgrader 结合使用，为学生提供一个集中的作业提交平台。
2. JupyterLab：Jupyter Notebook 的下一代界面，支持更多的扩展和自定义功能，可以与 nbgrader 一起使用，提供更好的用户体验。
3. Binder：允许用户在云端运行 Jupyter Notebook，可以与 nbgrader 结合，为学生提供一个无需本地安装的作业环境。

通过结合这些生态项目，可以进一步增强 nbgrader 的功能和用户体验。