Jupyter Notebook 5.7.3 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: jupyter-notebook.readthedocs.io

摘要

该文档是Jupyter Notebook 5.7.3版本的官方文档。文档介绍了Jupyter Notebook的核心概念，包括笔记本文档（.ipynb文件）、用户界面组件、内核（支持Python、Julia、R等多种语言）、代码单元和Markdown单元等基本组成部分。文档详细说明了如何启动笔记本服务器、使用键盘快捷键、进行绘图操作、安装内核以及信任笔记本的安全机制。此外，文档还涵盖了变更日志，其中5.7.3版本包含安全改进和修复，如使用本地文件启动浏览器以防止令牌泄露，以及升级Bootstrap修复XSS漏洞。其他版本如5.7.2修复了恶意目录名执行JavaScript的安全问题。文档还提供了配置文件和命令行选项的说明，以及如何在笔记本中编辑代码、运行代码、显示丰富输出（HTML、LaTeX、图像等）和创建交互式JavaScript小部件。

AI总结

Jupyter Notebook 5.7.3 文档主要介绍了该交互式计算平台的核心功能、组件和使用方法。文档结构清晰，涵盖用户界面、内核、安全、配置和扩展等方面。

**核心概念与架构**
- **Notebook文档**：以 `.ipynb` 格式保存的JSON文件，包含代码、执行结果和叙述性文本，可进行版本控制。
- **内核**：负责执行代码的独立进程，支持Python、Julia、R等多种语言。每个文档对应一个内核。
- **Web应用**：提供基于浏览器的编辑、运行、显示富媒体结果（HTML、LaTeX、图片、视频）及交互式控件功能。

**用户界面与操作**
- **界面组成**：包括笔记本名称、菜单栏、工具栏和单元格。
- **单元格类型**：代码单元格（可执行并显示输出）、Markdown单元格（含LaTeX公式）和Raw单元格。
- **快捷键**：`Shift-Enter` 运行单元格，`Esc` 进入命令模式，`Enter` 进入编辑模式。

**关键功能与特性**
- **绘图**：IPython内核与matplotlib无缝集成，支持在笔记本中直接显示图表。
- **导出与分享**：可通过nbconvert导出为HTML、PDF、LaTeX等格式，或通过nbviewer分享。
- **安全机制**：
- **信任机制**：通过对可信笔记本签名来防止未授权代码执行。未签名的笔记本不会显示HTML和JavaScript输出。
- **隐私**：本地运行的Jupyter（`localhost`）不会将数据发送到外部。
- **密码配置**：可通过 `jupyter notebook password` 命令设置密码。

**版本更新亮点（5.7.3 及之前版本）**
- **5.7.3**：修复了安全漏洞（CVE-2018-14041），通过本地文件重定向启动浏览器，防止认证令牌被窃取。
- **5.7.2**：修复了恶意目录名执行JavaScript的安全问题。
- **4.x 系列**：新增了跨笔记本复制粘贴单元格、文件列表排序、Markdown图片拖拽嵌入、多文件移动、内核忙碌状态图标变化等功能。

**配置与启动**
- **启动服务器**：命令行运行 `jupyter notebook`，默认地址为 `http://127.0.0.1:8888`。
- **配置文件**：可通过 `jupyter notebook --generate-config` 生成 `jupyter_notebook_config.py` 文件进行自定义设置。
- **命令行选项**：支持通过 `--help` 查看所有可用参数，如日志级别、配置文件路径等。