设置新的默认 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
    

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