使用修订控制机制扩展

修订控制机制 (RCM) Jupyter Notebook 扩展为笔记本文件提供了简单的版本控制。它使用内部 Jupyter 功能来执行任务。

表面上,RCM 使用一个简单的线性模型,但在其之下是一个更复杂的基于 git 的分支模型。为了防止合并冲突,该模型使用“最新获胜”策略作为其主要合并策略。

RCM Jupyter Notebook 扩展添加了四个按钮:

../../../../../../_images/aen-user-extensions_rcm.png

提示:如果您没有看到 RCM 按钮,请参阅第一次设置 RCM

使用状态按钮

“状态”按钮允许您查看您所在的版本。

单击状态按钮显示:

../../../../../../_images/aen-user-extensions_rcm_status.png

使用结账按钮

Checkout 按钮允许您查看先前修订点的列表、检查先前修订或比较修订之间的差异。

单击结帐按钮显示:

../../../../../../_images/aen-user-extensions_rcm_checkout.png

检查以前的修订

要在较早的修订点签出笔记本:

  1. 选中所需修订点旁边的复选框。

  2. 单击确定按钮。

    将显示选定修订点处的笔记本副本。

注意:如果您尚未在当前项目窗口中保存工作,则检查以前的修订会破坏它。如果有疑问,请单击取消按钮并在恢复到以前的修订点之前保存您的工作。

比较修订

要比较 2 个以前的修订点:

  1. 选中要比较的修订点的复选框。

  2. 单击查看差异按钮。

    显示并排比较。

    单击取消按钮关闭差异窗口。

使用提交按钮

Commit 按钮允许您保存或保留当前更改,永久记录引入的任何更改,这样您就不必担心丢失重要数据。

单击提交按钮显示:

../../../../../../_images/aen-user-extensions_rcm_commit.png

  1. 输入提交中更改的描述作为提醒,以防您稍后需要恢复。

  2. 单击确定按钮。

    您的更改已提交并创建修订点。

如果未设置 Git 用户名和用户电子邮件,则会出现以下窗口:

../../../../../../_images/aen-user-extensions_rcm_commit_error.png

配置 Git,然后再次尝试提交。

提示:您可以通过检出以前的版本来回滚已提交的更改。

使用配置 git 按钮

配置 git 按钮允许您配置 Git 用户名和电子邮件值。

单击配置 Git 按钮后,将出现以下窗口:

../../../../../../_images/aen-user-extensions_rcm_git_config.png

输入用户名和电子邮件地址。完成后单击“确定”按钮。

第一次设置RCM

如果您在笔记本中没有看到 RCM 按钮:

  1. 转到项目主页。

  2. 打开终端应用程序。

  3. 在终端窗口中,运行:

    git config --global user.email "you@example.com"
    git config --global user.name "Your Name"
    

    注意:更改you@example.com为您的电子邮件地址和您的实际姓名。Your Name

  4. 打开 Jupyter Notebook 并刷新页面。