JupyterLab URL#

与经典笔记本一样，JupyterLab 为用户提供了一种复制 URL 的方法，这些 URL 可以打开特定的笔记本或文件。此外，JupyterLab URL 是用户界面中一个高级部分，允许管理工作区。这两个功能——文件路径和工作区——可以在打开特定工作区中特定文件的 URL 中组合。

使用 `/tree` 进行文件导航#

JupyterLab 的文件导航 URL 采用经典笔记本的命名法；这些 URL 是 /tree URL

http(s)://<server:port>/<lab-location>/lab/tree/path/to/notebook.ipynb

默认情况下，文件浏览器将导航到包含请求文件的文件夹。此行为可以使用可选的 file-browser-path 查询参数更改

http(s)://<server:port>/<lab-location>/lab/tree/path/to/notebook.ipynb?file-browser-path=/

输入上述 URL 将显示工作区根文件夹，而不是文件浏览器中的 /path/to/ 文件夹。

要创建将滚动到笔记本中特定标题的 URL，请附加一个井号 (#)，后跟标题文本，并将空格替换为减号 (-)，例如

/lab/tree/path/to/notebook.ipynb?#my-heading

要获取特定标题的链接，请将鼠标悬停在渲染的 markdown 单元格上，直到您看到一个节号 (¶)，其中将包含所需的锚点链接

注意

目前不支持对具有相同文本的标题进行消歧。

JupyterLab 实验性地支持使用 #cell-id=<cell-id> 片段标识语法滚动到指定单元格。

/lab/tree/path/to/notebook.ipynb?#cell-id=my-cell-id

注意

cell-id 片段定位器不是 Jupyter 正式标准的一部分，可能会发生变化。要留下反馈，请在讨论中发表评论：nbformat#317。

JupyterLab 会话始终驻留在工作区中。工作区包含 JupyterLab 的状态：当前打开的文件、应用程序区域和选项卡的布局等。刷新页面时，将恢复工作区。

默认工作区没有名称，位于主 /lab URL

http(s)://<server:port>/<lab-location>/lab

所有其他工作区都有一个名称，该名称是 URL 的一部分

http(s)://<server:port>/<lab-location>/lab/workspaces/foo

工作区将状态保存在服务器上，并且可以在多个用户（或浏览器）之间共享，只要他们可以访问同一服务器。

工作区一次只能在一个浏览器标签页中打开。如果 JupyterLab 检测到工作区被同时打开多次，它将提示您输入新的工作区名称。

您可以使用 clone URL 参数将工作区的内容复制到另一个工作区。

要将工作区 foo 的内容复制到工作区 bar

http(s)://<server:port>/<lab-location>/lab/workspaces/bar?clone=foo

要将默认工作区的内容复制到工作区 foo

http(s)://<server:port>/<lab-location>/lab/workspaces/foo?clone

要将工作区 foo 的内容复制到默认工作区

http(s)://<server:port>/<lab-location>/lab?clone=foo

使用 reset URL 参数清除工作区的内容。

要重置工作区 foo 的内容

http(s)://<server:port>/<lab-location>/lab/workspaces/foo?reset

要重置默认工作区的内容

http(s)://<server:port>/<lab-location>/lab/workspaces/lab?reset

这些 URL 功能可以单独使用，如上所示，也可以组合使用。

要重置工作区 foo 并在之后加载特定笔记本

http(s)://<server:port>/<lab-location>/lab/workspaces/foo/tree/path/to/notebook.ipynb?reset

要将工作区 bar 的内容克隆到工作区 foo 并在之后加载笔记本

http(s)://<server:port>/<lab-location>/lab/workspaces/foo/tree/path/to/notebook.ipynb?clone=bar

要重置默认工作区的内容并加载笔记本

http(s)://<server:port>/<lab-location>/lab/tree/path/to/notebook.ipynb?reset