使用现有 JupyterLite 部署#

如果您是第一次听说 JupyterLite,您可能想先尝试一下。

JupyterLite 与 JupyterLab 有何不同?#

如果您正在使用 JupyterLite 站点,则无需了解太多。它的工作方式与常规的、服务器支持的 JupyterLab 站点相同,除了:

  • 内核列表(通常在启动器中以不同的笔记本形式显示)将有所不同。请参阅下面的“内核”部分

  • 您的数据写入浏览器内存储

    • 尽管您可能能够复制

  • 除非您的数据离开浏览器……

    • 已安装并启用扩展程序,并向外部服务发送数据

    • 您的笔记本包含使用浏览器 fetch 机制的代码

使用 JupyterLite#

使用 JupyterLite 非常简单:只需在网络浏览器中访问部署的 URL!

目前有几个面向公众的 JupyterLite 实例,它们具有不同的扩展、包和内容集。

一个部署可以有一个或多个可用应用程序。

应用程序#

JupyterLab#

JupyterLab 是 Project Jupyter 的下一代用户界面,它在一个灵活而强大的用户界面中提供了经典 Jupyter Notebook 的所有熟悉构建块(笔记本、文本编辑器、文件浏览器、富输出等)。JupyterLab 最终将取代经典 Jupyter Notebook。

image

Jupyter Notebook#

Jupyter Notebook 是一个以文档为中心的 UI,用于创建、编辑和运行 Jupyter 笔记本。

image

REPL#

REPL 应用程序是一个基于 JupyterLab 代码控制台的最小 UI,用于在浏览器中轻松执行代码。

image

内核#

JupyterLite 内核在浏览器中借助 mock-socketWebAssembly 实现 Jupyter 内核消息传递,不依赖任何外部基础设施。

JupyterLite 贡献者开发并维护以下内核:

还有一些其他第三方浏览器内内核也与 JupyterLite 兼容。有关更多信息,请参阅此 GitHub 讨论

请查阅文档的操作指南,了解如何使用和配置内核。

使用文件#

默认情况下,您在 JupyterLite 中创建的文件存储在浏览器的本地存储(IndexedDB)中。除非它们部署在同一个域上并且您使用相同的浏览器,否则它们不会在不同的 JupyterLite 网站之间共享。

上传文件#

JupyterLite 支持将文件从您的本地机器上传到浏览器的本地存储。这可以通过将文件从本地机器拖放到文件浏览器,或使用文件浏览器中的 上传 按钮来实现。

例如,当您想上传数据集(如 CSV 文件)以在笔记本中使用时,这很有用。

但是请注意,浏览器的本地存储容量有限,您可能无法上传大型文件。但较小的文件(最大约 50MB)应该没有问题。

注意

要了解有关浏览器存储限制的更多信息,请查看 MDN 上的 浏览器存储 参考页面。

访问现有文件#

某些 JupyterLite 部署可能默认提供对某些文件的访问。这些文件作为静态资产存储在服务器上,并通过 JupyterLite 文件浏览器提供给用户。它们可以编辑,但更改不会保存回服务器。相反,会在浏览器的本地存储中创建一个本地副本,就像创建新文件一样。

注意

如果您想恢复到原始文件,可以删除本地副本。这可以通过右键单击文件浏览器中的文件并选择 删除 来实现。

注意

如果您是站点部署者,请查阅指南,了解如何向用户提供文件。

安装 JupyterLite 应用程序#

如果浏览器和操作系统支持,JupyterLite 也可以作为应用程序安装。

当您访问 JupyterLite 网站时,您可以通过单击搜索栏中的 安装 按钮将其安装为应用程序

a screenshot showing how to install the JupyterLite app

注意

如果 安装 按钮不可见,请务必尝试其他浏览器。

在 Gnome 上使用 Linux 的示例#

安装后,JupyterLite 应用程序可以通过 Gnome 上的概览启动

a screenshot showing how to launch the JupyterLite app

然后应用程序将在新窗口中打开,就像一个普通的桌面应用程序

a screenshot showing the JupyterLite application on desktop

Android 上的示例#

JupyterLite 应用程序也可以安装在移动设备上。

在 Android 上,它将如下所示

a screenshot showing how to install the JupyterLite app on Android

单击 安装 按钮后,应用程序将在主屏幕上可用

a screenshot showing the JupyterLite application on the home screen