跳转到主要内容

一个用于访问Google Fonts变量字体轴注册表的Python API。

项目描述

Google Fonts轴注册表

此存储库是官方的上游 Google Fonts 轴注册表

此数据集同步到中央 github.com/google/fonts git仓库,通过该仓库所有Google Fonts资产都将被上传。

实际的轴注册表位于实际的Google Fonts产品中,在 fonts.google.com/variablefonts#axis-definitions 上呈现 - 因此,当轴定义出现在该页面上时,它们才是最终的,此存储库将不时包含系统中不存在的新数据,并可能发生变化。

AxisRegistry Python模块

此存储库的结构类似于Python包/模块,提供从Python程序访问注册表数据集的便捷方式。

Python包包含一组元数据源文件,共同构成了Google Fonts轴注册表。

本模块是数据集更新的中心位置。在 main 分支上进行更新后,中央仓库的维护者将更新位于 google/fonts/axisregistry 的子树,然后通过沙箱服务器按照典型的推送流程将这些更改推送到实时的 Google Fonts API。有关更详细的信息,请参阅 GF Guide 中的 google/fonts 仓库解释 文章的 轴注册表 部分。

轴元数据字段

  • tag
    • 用于在 font-variation-settings 和 CSS API 请求中指定轴的标记。
  • display_name
    • 轴的可读名称,通常是 tag 的扩展形式。
  • min_value
    • 轴的下限。包含。
  • max_value
    • 轴的上限。包含。
  • default_value
    • 轴的默认位置。
  • precision
    • 描述了轴位置可以指定的特定性。例如,0 表示值必须指定为整数,而 -1 表示值可以精确到小数点后一位。
  • fallback
    • 轴上的实例位置,例如 wght 100,200,300,400,500,600,700,800,900。
    • 通过所有受支持的轴的回退位置的交叉乘积来支持缺乏变量字体支持的旧浏览器。对于具有 CSS3 属性(如 font-weight)的轴,应指定 CSS3 可以访问的位置。对于缺乏 CSS3 属性的轴,旧浏览器被限制在单个位置,并且该位置必须在回退中。
      如果轴不包含预定义的位置,则必须至少定义一个回退位置。它应称为 Default,其值应与轴的 default_value 位置相对应。
  • fallback_only
    • 描述了在 UI 中向用户展示时是否仅使用回退值。目前默认为 true,对于连续范围轴应设置为 false
  • description
    • 轴的描述。

为什么 Google Fonts 有自己的轴注册表?

我们支持 OpenType 轴注册表的轴集的超集,并为每个轴使用额外的元数据。在此注册表中未出现但出现在字体文件中的轴无法通过我们的 API 使用。预期没有变量字体会支持这里的所有轴。

任何提供变量字体的字体铸造厂或发行商库都有一个隐含的、潜在的、事实上的轴注册表,可以通过扫描库中的轴标记、标签和最小/默认/最大值来提取。虽然 2016 年微软最初提出在 OpenType 1.8 规范中包含更多轴(github.com/microsoft/OpenTypeDesignVariationAxisTags),但到 2020 年 8 月,这项工作已经停滞。我们希望更多铸造厂和发行商发布此类文档,明确其轴,以鼓励整个行业采用变量字体,并为 OpenType 规范轴注册表的未来更新提供素材。

项目详情


下载文件

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

源分发

axisregistry-0.4.11.tar.gz (4.1 MB 查看哈希值)

上传时间

构建分发

axisregistry-0.4.11-py3-none-any.whl (39.5 kB 查看哈希值)

上传时间 Python 3

由以下组织支持