使用 nbgitpuller 向用户分发材料

目标

使用 JupyterHub 时，一个非常常见的需求是轻松地将学习材料/实验笔记本分发给学生。

学生应该能够

1. 轻松获取材料的最新版本，包括讲师对学生已经拥有的材料所做的任何更新。

2. 确信他们不会丢失任何工作。如果讲师修改了学生也修改过的内容，学生的修改永远不会被覆盖。

3. 不必处理手动合并冲突或其他复杂的操作。

讲师应该能够

1. 使用现代协作版本控制工具来创作和存储他们的材料。目前这意味着使用 Git。

nbgitpuller 是一个 Jupyter 服务器扩展，它有助于实现这些目标。本教程将引导您完成创建魔术 nbgitpuller 链接的过程，您的 JupyterHub 用户可以点击该链接从 git 仓库获取最新版本的材料。

先决条件

1. 使用 The Littlest JupyterHub 设置的 JupyterHub

2. 包含要分发材料的 git 仓库

步骤 1：生成 nbgitpuller 链接

生成链接的最快方法是使用 nbgitpuller.link，但其他选项也存在，如 nbgitpuller 项目的文档 中所述。

步骤 2：用户点击 nbgitpuller 链接

1. 以某种方式将链接发送给您的用户 - 电子邮件、Slack、在墙上发布缩短的版本（使用 bit.ly ），或将其放在您的课程大纲页面上（例如 加州大学伯克利分校的 data8）。无论什么对您有效 :)

2. 当用户点击链接时，如果他们尚未登录，系统会要求他们登录到集线器。

3. 用户将看到一个进度条，显示 git 仓库正在被获取，并且正在执行任何所需的自动合并。

   

4. 用户现在将被重定向到 URL 中指定的笔记本！

此工作流程允许用户直接进入您指定的笔记本，而无需了解有关 git 或 JupyterHub 界面的太多信息。