Jupyter Notebook 5.7.5 Documentation

语言	格式	评分
英语	.pdf	3
摘要
文档是Jupyter Notebook 5.7.5版本的官方文档，主要内容包括：Jupyter Notebook的安装、启动和使用方法，用户界面组件（如菜单栏、工具栏、代码单元格），笔记本文档的结构（代码单元格、Markdown单元格、原始单元格），以及关键功能如键盘快捷键、绘图集成、内核安装、信任机制和浏览器兼容性。文档还提供了详细的版本更新日志（Changelog），涵盖从4.0到5.7.5的改进，包括文件排序、密码配置、安全修复（如Tornado 6兼容性）、多文件移动支持、键盘快捷键声明式设置、行号切换、信任通知等。此外，文档介绍了笔记本的导出格式（HTML、LaTeX、PDF等）、nbviewer共享服务、隐私保护说明，以及开发环境搭建和故障排除指南。
AI总结
Jupyter Notebook 5.7.5 文档总结核心概述本文档是 Jupyter Notebook 5.7.5 版的官方使用说明，发布日期为 2019 年 3 月 7 日。文档详细介绍了 Notebook 的启动、用户界面、核心功能、安全机制、扩展开发以及版本更新日志。 1. 核心概念与启动 - Notebook 文档 (.ipynb)：一种 JSON 格式文件，包含代码、运行结果、数学公式和富文本，可进行版本控制、分享，并支持通过 nbconvert 导出为 HTML、PDF 等格式。 - 启动方式：在命令行输入 `jupyter notebook` 即可启动服务器，默认在 `http://127.0.0.1:8888` 打开仪表盘。也可直接打开特定文件：`jupyter notebook my_notebook.ipynb`。 - 隐私与安全：Notebook 默认在本地运行（`localhost`），数据不会外传。对不信任的笔记本文档，系统会验证签名，未签名则禁用 JavaScript 和 HTML 输出，可通过 `jupyter trust mynotebook.ipynb` 命令手动信任。 2. 用户界面与操作 - 仪表盘：显示当前目录下的所有 Notebook 文件，支持按修改日期或名称排序。 - 界面组成：菜单栏、工具栏、笔记本文件名（可重命名）、以及一个或多个单元格。 - 单元格类型： - 代码单元格：输入代码并执行，支持语法高亮、制表补全和交互式输出（如 matplotlib 图表、HTML 表格）。 - Markdown 单元格：用于编写文本、数学公式（LaTeX/MathJax），支持拖拽图片嵌入。 - Raw 单元格：直接输出原样文本，不经过转换。 - 快捷键：`Shift-Enter` 运行当前单元格并跳转至下一格；`Esc` 进入命令模式；`Enter` 进入编辑模式。 3. 关键功能与特性 - 代码执行与绘图：代码执行结果支持富媒体输出，如 matplotlib 图、pandas 表格。 - 内核：默认使用 IPython 内核，支持安装其他语言内核（如 R、Julia），可通过 Jupyter 内核列表查看。 - 复制粘贴：支持跨 Notebook 复制粘贴单元格。 - 键盘快捷键声明化：快捷键可通过菜单自定义。 - Kernel 状态提示：浏览器标签页图标（favicon）会随内核忙/闲状态变化。 - 文件管理增强：文件浏览器支持多文件移动、编辑/查看按钮。 - 根用户限制：默认禁止以 root 身份运行，需强制使用 `--allow-root` 参数。 4. 版本更新亮点 (Changelog) - 5.7.5：修复与 Tornado 6 的兼容性问题；修复 Python 2 下的文件描述符错误；修复异步内核管理器重启问题。 - 5.7.4：修复 5.7.3 中 `list_running_servers()` 解析 HTML 文件时崩溃的 Bug。 - 5.7.3：包含安全改进与修复。 - 5.0.0 (重大版本)：合并超过 300 个 Pull Request。主要新特性包括： - 仪表盘文件支持按名称或日期排序。 - 支持复制粘贴单元格、设置密码（`jupyter notebook password` 命令）。 - Markdown 支持图片附件，保存时自动清理未引用的附件。 - 恢复删除单元格时支持批量恢复。 - 更明显的“信任/不信任”通知。 - 内核繁忙时浏览器标签页图标变化。 - 4.4.0：允许覆盖输出回调；支持 comm 消息处理返回 Promise。 - 4.3.2：修复搜索背景样式；允许列出运行中的 Notebook（无需 `--allow-root`）；支持非 Notebook 类型的 session；添加 `api/shutdown` 处理；从命令行停止服务器；引入内核空闲超时剔除功能（`cull_idle_timeout`）。 5. 扩展与开发 - 安装：依赖 Python, Node.js, pip, npm。通过 `pip install -e .` 进行开发模式安装。 - 构建：修改 JavaScript 或 CSS 后，需运行 `npm run build` 重新编译。 - 验证：在 `Help > About` 中查看版本信息，开发版会包含“dev”字样。 - 故障排除：如果未进入开发模式，需卸载所有旧版本，重新安装并指定非默认端口（如 8989）。 6. 其他重要提示 - 升级 Notebook 时，建议同时升级 pip（至 9+ 版本）和底层的内核及库，以确保功能和稳定性。 - 文档强调，Notebook 仅影响用户界面，内核更新需单独进行。