JupyterLab 网址#

与经典笔记本类似,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,请在URL末尾添加一个哈希符号(#),然后跟随标题文本,并将空格替换为减号字符(-),例如:

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

要获取特定标题的链接,请在渲染的Markdown单元格中悬停在该标题上,直到看到一个段落标记(),其中将包含所需的锚点链接:

注意

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

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

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

注意

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

管理工作区 (URL)#

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函数#

这些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