---

jupyterlab-deck

docs	install	extend	demo	ci

为JupyterLab提供轻量级演示

---

安装

pip install jupyterlab-deck

或

mamba install -c conda-forge jupyterlab-deck # or conda, if you must

查看 CONTRIBUTING.md 了解开发安装。

---

卸载

pip uninstall jupyterlab-deck

或

mamba remove jupyterlab-deck # or conda if you must

---

使用方法

---

开始使用

安装后，打开或创建一个 笔记本。

其他文档 工作，但并不那么有趣。

演示模式

通过以下方式启动 演示模式

• 在 笔记本工具栏 中，点击
• 打开 命令面板 并运行 启动演示

在 演示模式 中，直到配置任何 幻灯片类型，所有内容都应垂直滚动显示。

---

远程

在 演示模式 中，使用

• 屏幕上的 远程
  • 如果可用，上、下、左、右将可用
• 这些对应于标准的键盘快捷键，
  • →, ↓, ←, ↑
  • shift+enter 执行并前进
• 空格键尝试两个方向
  • space = ↓，或 →
  • shift+space = ↑，或者 ←

---

展示 JupyterLab UX 功能

许多核心 JupyterLab UI 元素仍然可用，但默认隐藏。将鼠标悬停在其常规位置以显示它们。这些包括

• 左右侧栏
• 笔记本工具栏

---

隐藏的 JupyterLab UX 功能

一些元素不可见，并且无法显示

• 主菜单
• 状态栏
• 单元格工具栏

下一步

• 使用 幻灯片类型来自定义屏幕上显示的内容量。
• 使用 图层类型来自定义前景/背景行为
• 使用 设计工具来自定义单元格的外观
• 使用 幻灯片布局工具来自定义单元格的位置和大小

---

退出演示模式

要退出 演示模式

• 从遥控器点击
• 打开 命令面板 并运行 停止演示

---

幻灯片

通过使用 属性检查器侧边栏 或 设计工具来更改每个单元格的 幻灯片类型 以构建幻灯片。

类型	用途
-	(默认) 在上一个单元格下堆叠
幻灯片	开始一个新的堆叠
片段	激活时显示
子幻灯片	在可选的 Y 轴上开始一个新的单元格堆叠
跳过	完全隐藏单元格
备注	TBD：将此单元格移动到屏幕外备注查看器

---

图层

从以下选择图层类型

• 属性检查器
• 或 [设计工具]。

图层可以暂时或永久显示内容，并且不会被。指定图层作用域将覆盖 幻灯片类型。图层有以下之一 作用域

作用域	与 幻灯片 的关系
演示	在 所有 当前和未来的 幻灯片 或 子幻灯片 中显示
堆叠	显示到下一个 幻灯片
幻灯片	显示到下一个 幻灯片 或 子幻灯片
片段	仅显示到下一个 片段

---

设计工具

在 演示模式 中，点击左下角的 省略号 图标

设计工具提供轻量级的按钮来

• 显示/隐藏 幻灯片布局 遮罩
• 设置 幻灯片类型
• 设置 图层类型
• 更改一些关键外观属性
  • 使用滑块进行自定义
    • z-index 控制元素的垂直堆叠
      • 值越高“越靠近”用户
    • opacity 控制字体和颜色的鲜艳程度
      • 值越高越鲜艳
    • zoom 控制单元格内容的显示大小
      • 值越高越大
  • 取消选中复选框以恢复到默认值

---

幻灯片布局

在打开 设计工具 后，点击 显示布局 按钮

在 幻灯片布局 模式下，每个幻灯片部分都会收到一个遮罩。

手动移动部分将使其从默认布局中删除，并允许您将其放置在屏幕上的任何位置，但它将保持相同的导航索引。

键盘快捷键和遥控器应继续正常工作。

---

移动部分

单击并拖动部分遮罩以移动下方的部分。

---

调整部分大小

点击部件叠加图角部的任何一个把手来调整部件大小。

---

撤销部件移动/调整大小

将部件移动到固定位置后，点击部件叠加图上的↺按钮将部件恢复到默认布局。

---

配置

---

启动时启用Deck模式

• 请参阅JupyterLab文档关于overrides.json的设置。

{
  "@deathbeds/jupyterlab-deck:plugin": {
    "active": true
  }
}

---

常见问题解答

---

它与notebook 6（即经典版）兼容吗？

不兼容。请使用RISE。

---

它与notebook 7兼容吗？

大部分兼容。在同一个演示过程中导航多个文档可能永远不会工作，因为这不符合Notebook UX每次仅使用一个文档的设计约束。跳转到另一个文档将打开一个新浏览器标签，尽管需要安装deck。

---

它能生成PowerPoint吗？

不能。这将是一个很好的第三方扩展，可以消费由本扩展创建的notebook元数据，jupyterlab-fonts，以及与nbconvert兼容的幻灯片。

---

它能生成单文档静态HTML演示文稿吗？

不能。请使用nbconvert，但不会工作层或样式自定义。

为了获得完整的静态观看体验，请尝试类似JupyterLite的东西。

---

它能生成PDF吗？

目前不能。