设置新的默认 JupyterLab 设置#

如果您或您中心的其他用户倾向于将 JupyterLab 用作默认的笔记本应用程序,那么您可能希望覆盖中心用户的某些默认设置。您可以通过创建文件 /opt/tljh/user/share/jupyter/lab/settings/overrides.json 并包含必要的设置来完成此操作。

本操作指南将通过示例介绍为所有 TLJH 用户设置新默认值的必要步骤:将默认主题设置为 JupyterLab Dark

第 1 步:更改您的个人设置#

为所有用户设置新默认设置的最简单方法是,首先将您自己的设置偏好配置为您希望其他人拥有的设置。

  1. 确保您在 JupyterLab 笔记本界面 中,其网址看起来像 http(s)://<YOUR-HUB-IP>/user/<YOUR_USERNAME/lab

  2. 转到菜单栏中的 设置,然后选择 主题 -> JupyterLab Dark

第 2 步:确定您的个人设置配置#

要将 JupyterLab Dark 设置为所有用户的默认主题,我们需要创建一个包含设置覆盖的 json 格式文件。现在您已经更改了您的个人设置,您可以使用 JSON 设置编辑器 来获取相关的设置片段,以便稍后添加到 overrides.json 文件中。

  1. 转到 设置 -> 高级设置编辑器,然后在右侧选择 JSON 设置编辑器

  2. 向下滚动并选择 主题。您应该会看到 json 格式的配置

    {
      // Theme
      // @jupyterlab/apputils-extension:themes
      // Theme manager settings.
      // *************************************
    
      // Theme CSS Overrides
      // Override theme CSS variables by setting key-value pairs here
      "overrides": {
        "code-font-family": null,
        "code-font-size": null,
        "content-font-family": null,
        "content-font-size1": null,
        "ui-font-family": null,
        "ui-font-size1": null
      },
    
      // Selected Theme
      // Application-level visual styling theme
      "theme": "JupyterLab Dark",
    
      // Scrollbar Theming
      // Enable/disable styling of the application scrollbars
      "theme-scrollbars": false
    }
    
  3. 确定您要更改的设置。在此示例中,它是 @jupyterlab/apputils-extension:themetheme 设置,如上所示。

  4. 构建您的 json 片段。在这种情况下,我们的片段应该如下所示

    {
      "@jupyterlab/apputils-extension:themes": {
        "theme": "JupyterLab Dark"
      }
    }
    

    我们只想更改 选定主题,因此我们不需要包含 CSS 和滚动条的其他主题相关设置。

    注意

    要应用多个设置的覆盖,请用逗号分隔每个设置。例如,如果您 想更改笔记本自动保存内容的间隔,您可以使用

    {
      "@jupyterlab/apputils-extension:themes": {
        "theme": "JupyterLab Dark"
      },
    
      "@jupyterlab/docmanager-extension:plugin": {
        "autosaveInterval": 30
      }
    }
    

第 3 步:将覆盖应用于中心#

创建设置片段后,您可以将其添加到 overrides.json 文件中,以便将其应用于所有用户。

  1. 首先,如果设置目录尚不存在,请创建它

    sudo mkdir -p /opt/tljh/user/share/jupyter/lab/settings
    
  2. 使用 nano 创建并将内容添加到 overrides.json 文件中

    sudo nano /opt/tljh/user/share/jupyter/lab/settings/overrides.json
    
  3. 将您的片段复制并粘贴到文件中并保存。

  4. 重新加载您的配置

    sudo tljh-config reload
    

现在,您的 TLJH 中所有使用 JupyterLab 笔记本界面的用户都应该设置了新的默认设置。