Jupyter Notebook 6.5.0 Documentation

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

摘要

该文档是Jupyter Notebook 6.5.0版本的官方文档。文档首先介绍了Jupyter Notebook是一个交互式计算环境，允许用户创建包含实时代码、交互式控件、图表、叙述文本、方程、图像和视频的笔记本文档。它由三个主要组件构成：笔记本Web应用程序（用于编写和运行代码）、内核（运行用户代码的独立进程）和笔记本文档（包含所有内容的独立文档）。文档还列出了该版本的关键特性，例如支持Python 3.6的f-string语法、更新jquery-ui到1.12、新增“另存为”菜单选项、通过检查Host头防止DNS重绑定攻击、添加内核超时配置选项、支持Windows终端等。此外，文档提供了安全修复列表，包括修复开放重定向漏洞（CVE-2019-10255）和跨站包含漏洞（CVE-2019-9644）。变更日志部分记录了6.5.0版本的bug修复和贡献者信息。

AI总结

Jupyter Notebook 6.5.0 文档总结了该交互式计算环境的核心功能、组件、更新内容和安全修复。

**核心概念与组件**
Jupyter Notebook 是一个交互式计算环境，允许用户创建包含实时代码、交互式控件、图表、叙述文本、方程、图片和视频的文档。它由三个核心组件构成：
1. **Notebook Web 应用程序**：用于编写和运行代码的交互式界面，支持语法高亮、自动缩进和Tab补全。
2. **内核 (Kernels)**：独立的后台进程，负责执行用户代码并返回结果。每个笔记本文档都有自己独立的内核。
3. **Notebook 文档**：自包含的文件，记录了所有计算内容、输入、输出和富媒体展示。

**主要功能与操作**
- **运行代码**：用户可以在浏览器中编写并运行代码，计算结果会直接展示在代码下方。可以通过点击单元格输入提示中的图标或使用快捷键 (如 `Shift-Enter`) 来运行。
- **文本与展示**：支持使用Markdown编写叙述性文本，并能够展示HTML、LaTeX、PNG、SVG、PDF等富媒体输出。
- **交互式控件**：支持创建和使用的交互式JavaScript控件。
- **键盘快捷键**：提供便捷的键盘操作模式，例如 `Esc` 进入命令模式，`Enter` 进入编辑模式。
- **文件管理**：仪表板中的文件可按最后修改日期或名称排序。

**安全与信任机制**
- **信任笔记本**：为防止恶意代码自动执行，Jupyter 会为受信任的笔记本生成签名。未签名的笔记本在打开时不会显示JavaScript和HTML输出，用户可以通过 `jupyter trust` 命令手动信任笔记本。
- **DNS 重绑定保护**：当在环回接口上提供服务时，会检查浏览器发来的主机头以防止 DNS 重绑定攻击。
- **安全修复**：版本6.0修复了多个安全漏洞，包括开放重定向漏洞 (CVE-2019-10255)、跨站脚本包含漏洞 (CVE-2019-9644) 和Bootstrap中的XSS漏洞 (CVE-2018-14041)。

**重要更新与变更（截至版本 6.5.0）**
- **Python 版本**：从6.0版本起停止支持Python 2.x，仅支持Python 3.5及以上版本。
- **新功能**：增加了对慢速内核重启的支持 (`kernel_info_timeout`)、可配置的自定义显示主机名、Prometheus监控指标端点 (`/metrics`)、对Windows终端支持、以及“重启并运行全部”按钮。
- **API 改进**：增加了 `?no_track_activity=1` 参数，允许外部监控的API请求不触发活动记录。
- **UI/UX**：更新了jQuery UI和Bootstrap (至3.4) 以修复安全问题和提升兼容性，并新增“另存为”菜单选项。
- **贡献与开发**：文档提供了详细的贡献指南，包括如何设置开发环境、修改JavaScript/CSS（需在nbclassic仓库中）以及运行Python测试（使用 pytest）。

**版本历史亮点**
- **6.0.0**：这是一个里程碑式的大版本，移除了Python 2支持，增加了多个可访问性和翻译改进，原生支持Jupyter Gateway，并增强了SSL/TLS安全。
- **5.0.0**：自Jupyter从IPython分离后的首个大版本，合并了超过300个拉取请求，新增了文件排序、单元格标签以及对自定义导出格式的支持。