跳转到主要内容

"main importable for jupyterlab-fonts.

项目描述

fonts-icon jupyterlab-fonts

JupyterLabJSS提供支持的JupyterLab数据驱动式样式和排版。

ci-badge demo-badge

这是 免费 软件

我们在这里尝试了一些事情,并邀请您尝试它,但我们不能保证它是好的或者甚至能正常工作。我们所说的意思在LICENSE底部的大写文本中有所说明。

如果出现问题,请成为贡献者并提交一个问题,但我们不能保证任何类型的响应时间。同样,PR将在有时间的情况下进行审查。

先决条件

  • Python >=3.8
  • 一个Jupyter客户端
    • JupyterLab >=3,<5
      • 有关特定JupyterLab兼容性的信息,请参阅变更日志
    • Jupyter Notebook >=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菜单快速配置

要更改默认字体,从主菜单中选择设置字体代码字体(或大小行高)以及您想要的值。

内容的一些功能,例如您渲染的Markdown和HTML,也是可用的,并且随着时间的推移可能会添加更多功能。

使用字体编辑器进行完整配置。[![字体编辑器](https://pypi-camo.freetls.fastly.net/c352778745472c8a0a9d407dca0b527e574e8b2f/68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f6465617468626564732f6a7570797465726c61622d666f6e74732f6d61696e2f7061636b616765732f6a7570797465726c61622d666f6e74732f7374796c652f69636f6e732f666f6e74732e737667 ")](https://pypi-camo.freetls.fastly.net/c352778745472c8a0a9d407dca0b527e574e8b2f/68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f6465617468626564732f6a7570797465726c61622d666f6e74732f6d61696e2f7061636b616765732f6a7570797465726c61622d666f6e74732f7374796c652f69636f6e732f666f6e74732e737667)

通过选择设置字体全局字体...,您可以查看所有可用的字体配置。这些值将存储在您的JupyterLab设置中。

笔记本特定配置

当查看.ipynb文件时,通过点击笔记本工具栏中的[![字体图标](https://pypi-camo.freetls.fastly.net/c352778745472c8a0a9d407dca0b527e574e8b2f/68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f6465617468626564732f6a7570797465726c61622d666f6e74732f6d61696e2f7061636b616765732f6a7570797465726c61622d666f6e74732f7374796c652f69636f6e732f666f6e74732e737667 ")](https://pypi-camo.freetls.fastly.net/c352778745472c8a0a9d407dca0b527e574e8b2f/68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f6465617468626564732f6a7570797465726c61622d666f6e74732f6d61696e2f7061636b616765732f6a7570797465726c61622d666f6e74732f7374796c652f69636f6e732f666f6e74732e737667)来仅更改该文件的字体。字体、样式更改及其许可信息将存储在笔记本元数据中。

这可能会迅速增加笔记本文件的大小,并使其在协作中更难以使用。我们正在考虑一些替代方案。

高级配置

在JupyterLab中,部分可以控制与字体完全无关的事情。无法保证高度定制的样式与字体编辑器或与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插件

所有与JSON兼容的功能的jss-preset-default插件都使用默认设置启用,下面有一些具体的说明。为了便携性,不支持基于动态JS的功能。

嵌套

使用&(和号)允许嵌套选择器,这是由W3C CSS嵌套模块标准化并由许多浏览器实现的。

全局

所有由设置派生的样式都将包含在@global选择器中。

Jupyter工作流程中

overrides.json中使用

overrides.json允许在启动实验室服务器后简单声明性地配置JupyterLab核心和第三方扩展。

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

binder中,可能使用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 来说是一个众所周知文件,这使得在不需要构建和分发完整主题插件的情况下,轻松进行轻量级定制变得非常直接。JupyterLite

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

jupyterlab_fonts-3.0.0.tar.gz (1.3 MB 查看哈希)

上传时间

构建分布

jupyterlab_fonts-3.0.0-py3-none-any.whl (1.1 MB 查看哈希)

上传时间 Python 3

由以下支持