Jupyter Notebook 5.7.4 Documentation

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

摘要

本文档是Jupyter Notebook 5.7.4版本的用户手册。Jupyter Notebook是一个基于Web的交互式计算环境，支持创建和共享包含代码、文本、数学公式和富媒体输出的文档。文档介绍了Notebook的启动方法、用户界面组件、键盘快捷键、绘图功能、内核安装以及笔记本信任机制。此外还详细说明了版本更新日志，包括5.7.4修复的bug、5.7.3的安全改进、5.0.0的文件排序和复制粘贴功能，以及4.x版本的令牌认证、CSRF漏洞修复等。文档涵盖配置概述、服务器安全、扩展开发、贡献指南等内容，并建议用户升级pip至9+版本以更新Notebook。

AI总结

Jupyter Notebook 5.7.4 文档总结了该版本的核心功能、安全更新和用户界面改进。

**核心功能与架构**
- Jupyter Notebook 是一个基于 Web 的交互式计算环境，支持代码、文本、数学公式和可视化输出的混合编排。
- 文档以 JSON 格式（.ipynb）保存，可通过 nbconvert 导出为 HTML、PDF、LaTeX 等格式，并支持通过 nbviewer 进行分享。
- 默认在本地运行（http://localhost:8888），确保数据隐私；远程使用时需注意安全配置。

**重要版本更新（5.x 系列）**
- **5.7.4**：修复了 `list_running_servers()` 函数解析 HTML 文件为 JSON 时崩溃的 bug。
- **5.7.3**：包含安全改进（通过本地文件启动浏览器，防止令牌被窃取）和安全修复（升级 Bootstrap 至 3.4，修复 XSS 漏洞 CVE-2018-14041）。
- **5.0.0**：重大发布，合并超过 300 个拉取请求。新增功能包括：文件列表可按名称或修改时间排序、支持跨笔记本复制粘贴单元格、Markdown 单元格支持拖放图片附件、增强的撤销删除单元格功能、文件浏览器新增编辑/查看按钮、支持多文件移动、拒绝以 root 身份运行（除非使用 `--allow-root` 标志）、内核繁忙时浏览器图标变化、支持 bundler API 等。

**用户界面与操作**
- **键盘快捷键**：Shift-Enter 运行当前单元格并跳转至下一个；Esc 进入命令模式；Enter 进入编辑模式。
- **绘图**：IPython 内核与 matplotlib 无缝集成，支持在单元格中直接显示图表。
- **信任机制**：为防止未信任代码执行，笔记本通过签名验证。完全执行过的笔记本被视为可信。可通过命令行 `jupyter trust mynotebook.ipynb` 手动信任。

**安全与配置**
- **令牌认证**：自 4.3.0 起默认启用令牌认证，浏览器自动打开时无需手动输入。可通过 `jupyter notebook list` 获取登录 URL。
- **密码配置**：支持通过 `jupyter notebook password` 命令设置密码。
- **内核管理**：支持通过 `--MappingKernelManager.cull_idle_timeout` 参数自动关闭空闲内核。

**扩展与开发**
- 支持通过 `OutputArea.register_mime_type` 创建基于 MIME 类型的渲染器扩展。
- 提供将扩展作为 Python 包分发的指南，并鼓励用户尝试 JupyterLab 以准备未来过渡。
- 开发安装需克隆 GitHub 仓库，执行 `pip install -e .` 和 `npm run build` 以编译 JavaScript 和 CSS。