使用修订控制机制扩展#

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

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

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

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

使用“状态”按钮#

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

单击“状态”按钮显示

使用“检出”按钮#

“检出”按钮允许您查看以前的修订点列表,检出以前的修订版本或比较修订版本之间的差异。

单击“检出”按钮显示

检出以前的修订版本#

要检出早期修订点的笔记本

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

  2. 单击“确定”按钮。

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

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

比较修订版本#

要比较 2 个以前的修订点

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

  2. 单击“查看差异”按钮。

    将显示并排比较。

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

使用“提交”按钮#

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

单击“提交”按钮显示

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

  2. 单击“确定”按钮。

    您的更改已提交,并创建了一个修订点。

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

配置 Git,然后重试提交。

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

使用“配置 git”按钮#

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

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

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

首次设置 RCM#

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

  1. 转到项目主页。

  2. 打开终端应用程序。

  3. 在终端窗口中,运行

    git config --global user.email "[email protected]"
    git config --global user.name "Your Name"
    

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

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