JupyterLab URL#

像经典的笔记本一样，JupyterLab 提供了一种让用户复制打开特定笔记本或文件的 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