Notebook 基础#

Notebook 仪表板#

当您首次启动 Notebook 服务器时,您的浏览器将打开 Notebook 仪表板。仪表板是 Notebook 的主页。其主要用途是显示当前目录中的 Notebook 和文件。例如,以下是 Jupyter 仓库中 examples 目录的仪表板页面截图。

Jupyter dashboard showing files tab

Notebook 列表的顶部会显示当前目录的可点击面包屑导航。通过点击这些面包屑或 Notebook 列表中的子目录,您可以在文件系统中导航。

要创建一个新的 Notebook,请点击列表顶部的“New”按钮,并从下拉菜单中选择一个内核(如下图所示)。列出的内核取决于服务器上安装了哪些内核。下面截图中显示的某些内核可能您无法选择。

Jupyter "New" menu

通过将 Notebook 文件拖到 Notebook 列表上,或者点击列表上方的“click here”文本,可以将 Notebook 和文件上传到当前目录。

Notebook 列表会在正在运行的 Notebook 旁边显示绿色的“Running”文本和绿色的 Notebook 图标(如下图所示)。Notebook 会一直保持运行状态,直到您明确关闭它;仅仅关闭 Notebook 页面是不够的。

Jupyter dashboard showing one notebook with a running kernel

要关闭、删除、复制或重命名一个 Notebook,请勾选它旁边的复选框,Notebook 列表顶部会显示一组控件(如下图所示)。您也可以对目录和文件执行同样适用的操作。

Buttons: Duplicate, rename, shutdown, delete, new, refresh

要查看所有正在运行的 Notebook 及其所在目录,请点击“Running”选项卡。

Jupyter dashboard running tab

此视图提供了一种便捷的方式来跟踪您在长期运行的 Notebook 服务器中导航文件系统时启动的 Notebook。

Notebook 用户界面(UI)概览#

当您创建一个新的 Notebook 或打开一个现有的 Notebook 时,您将被带到 Notebook 用户界面(UI)。这个 UI 允许您交互式地运行代码和编写 Notebook 文档。Notebook UI 包含以下主要区域:

  • 菜单

  • 工具栏

  • Notebook 区域和单元格

Notebook 提供了一个关于这些元素的交互式导览,可以通过“Help:User Interface Tour”菜单项启动。

鼠标导航#

Notebook 中的所有导航和操作都可以通过鼠标使用菜单栏和工具栏来完成,它们都位于主 Notebook 区域的上方。

Jupyter notebook menus and toolbar

基于鼠标导航的第一个概念是可以通过点击来选择单元格。当前选中的单元格会有一个灰色或绿色的边框,具体取决于 Notebook 是处于编辑模式还是命令模式。如果您在单元格的编辑器区域内点击,您将进入编辑模式。如果您点击单元格的提示符或输出区域,您将进入命令模式。

如果您正在一个实时会话中运行此 Notebook(而不是在 https://nbviewer.jupyter.org 上),请尝试选择不同的单元格并在编辑模式和命令模式之间切换。尝试在一个单元格中输入内容。

基于鼠标导航的第二个概念是单元格操作通常应用于当前选中的单元格。因此,如果您想运行某个单元格中的代码,您需要先选中它,然后点击工具栏中的按钮或“Cell:Run”菜单项。同样,要复制一个单元格,您需要选中它,然后点击工具栏中的按钮或“Edit:Copy”菜单项。通过这种简单的模式,您应该能够用鼠标完成大部分所需操作。

Markdown 单元格还有一种可以用鼠标修改的状态。这些单元格可以被渲染或不被渲染。当它们被渲染时,您会看到单元格内容的优美格式化表示。当它们未被渲染时,您会看到单元格的原始文本源代码。要用鼠标渲染选中的单元格,请点击工具栏中的按钮或“Cell:Run”菜单项。要取消渲染选中的单元格,请双击该单元格。

键盘导航#

Jupyter Notebook 的模式用户界面为高效的键盘使用进行了优化。这是通过拥有两套不同的键盘快捷键实现的:一套在编辑模式下激活,另一套在命令模式下激活。

最重要的键盘快捷键是 Enter(进入编辑模式)和 Esc(进入命令模式)。

在编辑模式下,大部分键盘操作都用于在单元格编辑器中输入内容。因此,在编辑模式下的快捷键相对较少。而在命令模式下,整个键盘都可用于快捷键,所以快捷键要多得多。Help->Keyboard Shortcuts 对话框列出了可用的快捷键。

我们建议您大致按以下顺序学习命令模式的快捷键:

  1. 基本导航:entershift-enterup/kdown/j

  2. 保存 Notebook:s

  3. 更改单元格类型:ym1-6t

  4. 创建单元格:ab

  5. 编辑单元格:xcvdz

  6. 内核操作:i0(按两次)