Jupyter Notebook 5.4.0 Documentation

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

摘要

文档为Jupyter Notebook 5.4.0版本的官方文档，主要内容包括用户界面组件、配置概览、安全指南、扩展开发以及详细的版本更新日志。文档介绍了Notebook的三大组成部分：Web应用程序、内核和文档。Web应用程序支持交互式编程与小工具；内核负责运行代码并返回输出；文档包含代码、文本、方程等多内容。关键更新包括5.0.0版本的文件排序、单元格标签、复制粘贴功能以及Markdown图片嵌入；5.4.0版本修复了目录导航、彩色打印和自动补全限制等问题；4.3.0版本引入了默认令牌认证并切换至xterm.js。文档还提供了安装、测试与发布流程。

AI总结

Jupyter Notebook 5.4.0 文档总结

该文档是 Jupyter Notebook 5.4.0 版本的官方文档，发布于2018年1月28日，涵盖了从用户界面到开发贡献的完整内容。

**核心概念与组件**
Jupyter Notebook 是一个交互式计算环境，允许用户创建包含代码、交互式控件、图表、叙述文本、公式、图像和视频的文档。它由三个核心组件构成：笔记本网页应用（用于编写和运行代码的交互界面）、内核（负责执行用户代码并返回结果的独立进程）和笔记本文档（包含所有输入输出内容的独立文件）。

**UI组件与配置**
文档详细介绍了用户界面组件、通信机制（Comms）以及配置方式。配置支持通过配置文件、命令行选项和服务器运行参数进行管理，包括安全设置（如密码配置和CSRF防护）。

**安全特性**
- 5.4.0版本修复了CSRF漏洞（CVE-2016-9971），防止恶意表单创建文件或启动内核
- 支持只读笔记本的信任设置
- 改进了令牌认证机制，默认启用令牌认证

**主要功能更新（5.0.0版本）**
- 文件排序功能：仪表盘中的文件可按最后修改日期或名称排序
- 单元格标签：新增单元格工具栏用于添加标签
- 跨笔记本复制粘贴：使用Ctrl-C/Ctrl-V（Mac为Cmd-C/Cmd-V）在笔记本间复制粘贴单元格
- 密码配置：新增`jupyter notebook password`命令简化密码设置
- 图片附件：Markdown单元格支持拖拽图片嵌入，未引用的附件在保存时自动清除
- 撤销删除：支持撤销删除多个单元格
- 文件浏览器：新增编辑和查看按钮，支持一次移动多个文件
- 根用户限制：除非使用`--allow-root`标志，否则拒绝以root身份运行
- 键盘快捷键声明化：快捷键现在为声明式设计
- 行号切换：可影响所有单元格
- 内核忙碌指示：浏览器图标在内核忙碌时变化
- 服务器扩展加载：使用ConfigManager实现递归合并加载

**5.4.0版本具体改进**
- 修复导航目录后创建文件和文件夹的问题
- 支持彩色打印笔记本（移除了使所有内容变为黑白CSS）
- 将补全选项限制为1000个，避免性能问题
- 改进tree.html的可访问性
- 为内核徽标图像添加替代文本
- 在Travis CI上添加测试以标记意外引入的符号链接
- 使用小写字母生成JavaScript随机ID
- 删除设置TextCell.notebook的重复代码

**开发与贡献指南**
文档提供了为开发环境安装Jupyter Notebook的步骤，包括安装依赖、克隆仓库、使用pip安装以及重建JavaScript和CSS（运行`npm run build`）。开发时可用`npm run build:watch`自动重建。测试部分包括Python测试和JavaScript测试的安装和运行指南。

**版本发布流程**
创建新版本需要：检查工具安装、清理仓库、更新版本号、运行`python setup.py jsversion`更新JavaScript版本、提交并标记发布版本。

**示例与变更日志**
文档包含示例笔记本（可在nbviewer上查看）和详细的变更日志，涵盖从4.3.0到5.4.0版本的各项改进，包括bug修复、安全更新和功能增强。