jupyterlab fonts

jupyterlab-fonts

由JSS提供动力的Jupyterlab的数据驱动风格和版式。

这是免费软件

我们正在这里尝试一些事情，并邀请您对其进行测试，但不能保证它是好的甚至有效的。我们的意思是在许可证底部的喊叫文本中涵盖。

如果有什么东西被打破，成为贡献者并提出问题，但我们不能保证任何响应时间。同样，将在时间上审查PRS。

先决条件

• python> = 3.8
• Jupyter客户端
  • jupyterlab> = 3，<5
    • 有关特定的jupyterlab兼容性，请参见ChangElog。
  • jupyter笔记本> = 7，<8

安装

pip install jupyterlab-fonts
# or
conda install -c conda-forge jupyterlab-fonts

卸载

很抱歉看到你走了！

pip uninstall jupyterlab-fonts
# or
conda uninstall jupyterlab-fonts

用法

jupyterlab

Jupyter Lab菜单的快速配置

要更改默认字体，请从主菜单中选择“设置▶字体▶代码▶字体（或大小或行高）以及您想要的值。

内容的某些功能，即您的渲染降压和HTML，也可以使用，希望随着时间的推移添加更多功能。

使用字体编辑器完整配置

您可以通过选择设置▶字体▶全局字体...。这些值将存储在您的jupyterlab设置中。

笔记本特定的配置

查看.ipynb时，仅在笔记本工具栏中单击（现在，在单元格类型旁边），仅更改该文件的字体。字体，样式更改及其许可信息将存储在笔记本元数据中。

这可以迅速增加笔记本文件的大小，并且可以使协作更难使用。我们正在研究一些改变方法。

高级配置

在Jupyterlab中，高级JSON设置的字体部分可以完全控制与字体无关的事物。不能保证高度定制的样式可以与字体编辑器或jupyterlab-fonts数据的下游应用一起效果很好。

这是在演示模式下更改笔记本文件外观的示例。

{
  "styles" : {
    ":root" : {
      "--jp-code-font-family" : " 'Fira Code Regular', 'Source Code Pro', monospace " ,
      "--jp-code-font-size" : " 19px "
    },
    ".jp-mod-presentationMode .jp-Notebook" : {
      "& .CodeMirror, & .cm-editor" : {
        "fontSize" : " 32px "
      },
      "& .jp-InputPrompt, & .jp-OutputPrompt" : {
        "display" : " none "
      }
    }
  }
}

笔记本

同样，jupyterlab属性检查器在文档和单元格级别上都可以在特定的.ipynb文件中启用这些自定义：这些是动态生成的，并范围范围为文档/单元id 。

支持多个应用程序版本

上面的示例显示了不同版本的Jupyterlab（或笔记本）如何使用不同的DOM类来用于相同的逻辑内容，例如：

元素	jupyterlab <4	Jupyterlab 4
代码编辑器	.CodeMirror	.cm-editor

JSS插件

jss-preset-default插件的所有与JSON兼容的功能均使用默认设置启用，下面有一些具体说明。对于可移植性，不支持基于动态JS的动态功能。

筑巢

& （ampersand）允许通过W3C CSS嵌套模块标准化并在许多浏览器中实现的嵌套选择器。

全球的

所有设置衍生的样式都将包裹在@global选择器中。

在Jupyter工作流程中

用于overrides.json

overrides.json允许即使在启动实验室服务器之后，即使在实验室服务器开始之后，Jupyterlab Core和第三方扩展程序也可以简单地声明的配置。

{
  "@deathbeds/jupyterlab-fonts:fonts" : {
    "styles" : {
      ":root" : {
        "--jp-code-font-family" : " 'Fira Code Regular', 'Source Code Pro', monospace " ,
        "--jp-code-font-size" : " 19px "
      }
    }
  }
}

活页夹

在活页夹中，可以使用postBuild脚本部署它：

 #! /usr/bin/env bash
set -eux
mkdir -p " ${NB_PYTHON_PREFIX} /share/jupyter/lab/settings "
cp overrides.json " ${NB_PYTHON_PREFIX} /share/jupyter/lab/settings " 

jupyterlite

同样，这是jupyterlite的众所周知的文件，使其直接进行轻度自定义，而无需构建和分发完整的主题插件。