笔记本#

Jupyter 笔记本是将可运行的实时代码与叙述性文本(Markdown)、方程式(LaTeX)、图像、交互式可视化和其他丰富输出相结合的文档。

JupyterLab 完全支持 Jupyter 笔记本(.ipynb 文件)。 JupyterLab 中使用的 笔记本文档格式 与经典 Jupyter Notebook 中使用的格式相同。您现有的笔记本应该可以在 JupyterLab 中正常打开。如果它们无法打开,请在我们的 GitHub 问题 页面上提交问题。

通过单击文件浏览器中的 + 按钮,然后在新的启动器选项卡中选择一个内核来创建一个笔记本。

将创建一个具有默认名称的新文件。通过右键单击文件浏览器中文件的名称,然后从上下文菜单中选择“重命名”来重命名文件。

JupyterLab 中笔记本的用户界面与经典 Jupyter Notebook 的用户界面非常相似。经典笔记本的键盘快捷键仍然有效(使用命令模式和编辑模式)。但是,JupyterLab 中的笔记本可以实现许多新功能。

拖放单元格以重新排列笔记本。

在笔记本之间拖放单元格以快速复制内容。

创建单个笔记本的多个同步视图。

使用“视图”菜单或每个单元格左侧的蓝色折叠按钮来折叠和展开代码和输出。

通过右键单击单元格并选择“为输出启用滚动”来为长输出启用滚动。

创建单元格输出的新同步视图。

制表符完成(使用 Tab 键激活)现在可以包含有关匹配项类型的附加信息。

注意:IPython 6.3.1 暂时禁用了类型注释。要重新启用它们,请将 c.Completer.use_jedi = True 添加到 ipython_config.py 文件中。

工具提示(使用 Shift Tab 激活)包含有关对象的附加信息。

您可以将 代码控制台 连接到笔记本内核,以获取内核中执行的计算的日志,按执行顺序排列。附加的代码控制台还提供了一个地方,可以在不更改笔记本的情况下交互式地检查内核状态。右键单击笔记本,然后选择“为笔记本创建新控制台”。

您可以使用 Alt Up-ArrowAlt Down-Arrow 在文档单元格中遍历内核历史记录。要使用此功能,请在笔记本设置中启用内核历史记录访问。

单元格工具栏#

如果空间足够,每个单元格都将有一个工具栏,提供对常用功能的快速访问。如果您想禁用单元格工具栏,请运行

jupyter labextension disable @jupyterlab/cell-toolbar-extension

在命令行上。您可以通过运行以下命令重新启用它

jupyter labextension enable @jupyterlab/cell-toolbar-extension

信任#

在其他机器上创建的笔记本中的 JavaScript 和 HTML 代码不受信任,这会导致 HTML 代码被清理,并且交互式输出在笔记本被明确信任之前不会显示。

活动笔记本的信任状态由状态栏中的盾牌图标指示;盾牌中的勾号 (trusted) 表示受信任的笔记本,而叉号 (not-trusted) 表示不受信任的笔记本。要信任笔记本(并呈现任何被阻止的输出),请使用 Trust Notebook 命令,该命令可在 命令面板 中找到。

JupyterLab 遵循 Jupyter Notebook 的 安全模型,其中当前用户生成的任何输出都被信任,以下与高级用户相关的实现细节

  1. 手动重新运行不受信任的单元格将将其标记为受信任的单元格,

  2. 如果任何代码单元格不受信任,则整个笔记本都被视为不受信任,并且在重新打开时不会信任任何输出(虽然很少见笔记本只有一个不受信任的单元格,但这可能发生在从不受信任的笔记本复制粘贴单元格时),

  3. 只有代码单元格可以被信任;Markdown 单元格始终被清理。