Jupyter Notebook 5.1.0 Documentation

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

摘要

文档为Jupyter Notebook 5.1.0版本的官方文档。Jupyter Notebook是一个交互式计算环境，包含三个核心组件：笔记本网络应用（用于编写和运行代码）、内核（运行用户代码并返回输出）、笔记本文档（自包含的记录文件）。文档介绍了UI组件、配置方法、安全机制等内容。在安全方面，文档详细说明了笔记本签名机制：当用户执行并保存笔记本时，会基于内容摘要和密钥计算签名并存储在数据库中，用于验证笔记本的可信度。未匹配签名的笔记本中HTML和JavaScript输出将不被信任。用户可通过命令行工具'jupyter trust'显式信任笔记本。此外，文档还提供了ContentsManager类的内容API接口，用于管理虚拟文件系统中的文件操作，默认实现FileContentsManager使用本地文件系统进行存储。

AI总结

Jupyter Notebook 5.1.0 是一个交互式计算环境，让用户创建包含代码、交互式小部件、图表、叙述文本、方程、图像和视频的笔记本文档。它由三个核心组件构成：笔记本Web应用（用于编写和运行代码）、内核（独立进程，运行用户代码并返回输出）和笔记本文档（记录所有计算内容）。

文档的核心内容包括扩展机制、配置、安全性和变更日志。

**1. 扩展笔记本 (Extending the Notebook)**
笔记本服务器允许用户扩展自定义行为。主要内容包括：
* **Contents API**: 定义了在虚拟文件系统中操作文件的抽象接口。默认的 `FileContentsManager` 使用本地文件系统。用户可以创建子类来覆盖默认行为（例如自定义存储介质）。文件系统实体通过包含名称、路径、类型和内容的“模型”字典来表示。

**2. 安全机制 (Security)**
* **签名机制**: 为防止不信任代码执行，笔记本在元数据中存储签名。服务器打开笔记本时验证签名，不匹配则不会显示HTML和JavaScript输出，需重新执行单元格。
* **信任核心**: “当前用户是否执行过此操作？”是信任的中心问题。签名由笔记本内容摘要和密钥计算生成，存储在用户数据库中。
* **更新信任**: 笔记本保存时更新信任。所有不信任输出都清除或重新执行后，笔记本才被视为信任。
* **显式信任**: 用户可以通过命令行 (`jupyter trust notebook.ipynb`) 或菜单中的“文件/信任笔记本”手动信任笔记本。
* **安全报告**: 安全问题应报告至 `[e-mail]`。

**3. 变更日志 (Changelog)**
* **5.1.0 (2018年2月)**: 主要更新包括初步国际化（i18n）、公开带认证令牌的URL、根据ID排序空闲内核、会话特定图标、修复多处界面样式和快捷键冲突。
* **5.0.0**: 自IPython与Jupyter分离后的首个大版本，合并了超过300个PR。主要功能包括仪表盘文件排序、单元格标签（Cell tags）以及为未来过渡到JupyterLab做准备。

**4. 其他关键特性**
* **浏览器兼容性**: 官方支持Chrome、Safari和Firefox的最新稳定版。
* **主要功能**: 支持代码内联编辑、代码执行、丰富媒体输出（HTML、LaTeX、PNG、SVG）、Markdown富文本编辑、数学公式渲染（MathJax）以及绘图（如matplotlib集成）。