使用现有的 JupyterLite 部署#

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

JupyterLite 与 JupyterLab 有什么不同?#

如果您使用的是 JupyterLite 网站,那么您不需要了解太多。它就像一个普通的、服务器支持的 JupyterLab 网站,只是

  • 内核列表,通常从启动器中以不同的笔记本风格显示,将有所不同。请参阅下面的内核部分

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

    • 虽然您可能能够复制

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

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

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

使用 JupyterLite#

使用 JupyterLite 很简单:只需在 Web 浏览器中访问部署的 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 支持将文件从本地机器上传到浏览器的本地存储。这可以通过将文件从本地机器拖放到文件浏览器来实现,或者通过使用文件浏览器中的 Upload 按钮来实现。

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

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

注意

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

访问现有文件#

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

注意

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

注意

如果您是网站部署者,请查看 指南,了解如何将文件提供给用户。

安装 JupyterLite 应用程序#

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

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

a screenshot showing how to install the JupyterLite app

注意

如果 Install 按钮不可见,请确保检查其他浏览器。

在 Linux 上使用 Gnome 的示例#

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

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

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

a screenshot showing the JupyterLite application on the home screen