fonttools - 操作字体

在这里插入图片描述

文章目录

- 一、关于 fonttools
- 二、安装
- - 贡献
  - 测试
  - 可选依赖
- 三、如何制作新版本
- 四、工具
- 五、库

一、关于 fonttools

fontTools是一个用于操作字体的库，用Python编写。这项目包括TTX工具，可以转换TrueType和OpenType XML文本格式之间的字体，也称为TTX。

它支持TrueType、OpenType、AFM，并在一定程度上支持Type 1和一些该项目拥有 MIT open-source licence。除其他外，这意味着您可以免费使用它。

github : https://github.com/fonttools/fonttools
用户手册：https://fonttools.readthedocs.io/en/latest/
开发者文档：https://fonttools.readthedocs.io/en/latest/developer.html

其它文档/教程

Python_FontTools使用
https://blog.csdn.net/weixin_43411585/article/details/103484643

二、安装

FontTools 需要Python3.8+。我们尝试和 NumPy 支持的最低Python版本一致（见NEP 29）。

该包列在Python包索引（PyPI）中，因此您可以安装它与pip：

pip install fonttools

贡献

如果您想为其开发做出贡献，您可以克隆从GitHub存储库，以“可编辑”模式安装包并修改源代码。我们建议创建一个虚拟的环境，使用虚拟环境或 Python 3venv模块。

# download the source code to 'fonttools' folder
git clone https://github.com/fonttools/fonttools.git
cd fonttools

# create new virtual environment called e.g. 'fonttools-venv', or anything you like
python -m virtualenv fonttools-venv

# source the `activate` shell script to enter the environment (Unix-like); to exit, just type `deactivate`
. fonttools-venv/bin/activate

# to activate the virtual environment in Windows `cmd.exe`, do
fonttools-venv\Scripts\activate.bat

# install in 'editable' mode
pip install -e .

测试

要运行测试套件，您需要安装pytest。当您运行pytest命令时，测试将针对安装fontTools包，或在 PYTHONPATH。

你也可以用tox来在隔离的虚拟中自动在不同的Python版本上运行测试环境：

pip install tox
tox

注：当您运行不带参数的tox时，将对tox.ini envlist中列出的所有环境执行测试。系统PATH上不可用的Python版本将被跳过。

您可以通过-e选项或TOXENV环境变量指定特定的测试环境列表：

tox -e py36
TOXENV="py36-cov,htmlcov" tox

可选依赖

目前fontTools包没有（必需的）外部依赖项除了Python标准库中包含的模块。
但是，它的一些模块需要一些额外的依赖项，这需要解锁可选功能。
PyPI发行版fonttools还支持所谓的 extras，即一组描述一组附加依赖项的关键字，可以是通过pip安装或指定需求时使用。例如：

pip install fonttools[ufo,lxml,woff,unicode]

此命令将安装fonttools，以及解锁名为 ufo 等额外功能所需的可选依赖项。

Lib/fontTools/misc/etree.py
该模块导出一个类似ElementTree的API，用于读取/写入 XML文件，以及允许使用内置的xml.etree模块或 lxml。
无论何时出现，后者都是首选，因为它通常更快、更安全。
Extra : lxml
Lib/fontTools/ufoLib
读写UFO源文件的包；它需要：
- fs：（又名 pyfilesystem2）文件系统抽象层。
- enum34：内置enum 模块（仅在Python<3.4上需要）。
  Extra : ufo
Lib/fontTools/ttLib/woff2.py
压缩/解压缩WOFF 2.0网页字体的模块；它需要：
- brotli： Python的绑定 Brotli压缩库。
  Extra : woff
Lib/fontTools/ttLib/sfnt.py
为了更好地压缩WOFF 1.0网页字体，可以使用以下模块而不是内置的zlib库：
- zopfli： Python的绑定 Zopfli压缩库。
  Extra : woff
Lib/fontTools/unicode.py
在转储cmap表时显示Unicode字符名称对于ttx，我们使用标准库中的unicodedata模块。其中包含的版本因不同的Python版本而异。要使用最新的可用数据，您可以安装：
- unicodedata2： unicodedatabackport for Python 3. x更新到最新的Unicode 版本15.0。
  Extra : unicode
Lib/fontTools/varLib/interpolatable.py
用于在不同主控之间查找错误轮廓/组件顺序的模块。它需要以下软件包之一来解决所谓的“二分图中的最小权重完美匹配问题”，或赋值问题：
- scipy：科学图书馆对于Python，它在内部使用NumPy 数组，因此非常快；
- Munkres：纯蟒蛇实现匈牙利或Kuhn-Munkres算法的模块。
  要将结果绘制为PDF或超文本标记语言格式，您还需要安装：
- Pycero：Python的绑定开罗图形库。请注意，轮子目前仅适用于 Windows，对于其他平台，请参阅pycero的安装说明。
  Extra : interpolatable
Lib/fontTools/varLib/plot.py
用于可视化DesignSpaceDocument和生成的VariationModel的模块。
- matplotlib：2D绘图库。
  Extra : plot
Lib/fontTools/misc/symfont.py
用于符号字体统计分析的高级模块；它需要：
- 症状：Python库符号数学。
  Extra : symfont
Lib/fontTools/t1Lib.py
获取Macintosh PostScript Type 1字体的文件创建者和类型在Python 3上，您需要安装以下模块，如旧的MacOS 模块不再包含在Mac Python中：
- xattr： Python包装器扩展文件系统属性（仅限macOS平台）。
  Extra : type1
Lib/fontTools/ttLib/removeOverlaps.py
通过合并重叠的轮廓和组件来简化TrueType字形。
- skia-pathops：蟒蛇 Skia库的PathOps模块的绑定，执行布尔值路径上的操作（联合、交叉点等）。
  Extra : pathops
Lib/fontTools/pens/cocoaPen.py和Lib/fontTools/pens/quartzPen.py
使用CocoaNSBezierPath或CGPath绘制字形的笔需要：
- PyObjC之间的桥梁 Python和Objective-C运行时（仅限macOS平台）。
Lib/fontTools/pens/qtPen.py
使用Qt的QPainterPath绘制字形的笔需要：
- PyQt5：Python绑定 Qt跨平台UI和应用程序工具包。
Lib/fontTools/pens/reportLabPen.py
将字形绘制为PNG图像的笔需要：
- Reportlab： Python工具包用于生成PDF和图形。
Lib/fontTools/pens/freetypePen.py
使用FreeType作为光栅图像绘制字形的笔需要：
- freetype-py： Python绑定对于FreeType库。
Lib/fontTools/ttLib/tables/otBase.py
使用Harfbuzz库使用hb_repack方法序列化GPOS/GSUB，需要：
- uharfbuzz：流线型Cython harfbuzz整形引擎的绑定
  Extra : repacker

三、如何制作新版本

更新NEWS.rst自上次发布以来的所有更改每个PR的更改日志条目，用一两个简短的句子总结它，以及PR的链接和PR解决的相关问题。不放一个新标题，下一个命令会为您完成。
使用语义版本控制来决定新版本是“主要”、“次要”还是“补丁”版本。它通常是后两个版本之一，这取决于是否添加了新的向下兼容的API，或者只是修复了一些错误。
在venv内部，首先执行pip install -r dev-requirements.txt，然后运行从main分支的顶端python setup.py release命令。默认情况下，这只会颠簸第三个或“补丁”数字，除非你通过--major 或--minor分别颠簸第一个或第二个数字。这会颠簸包版本字符串，提取自最新版本以来的更改来自NEWS.rst的版本，并使用该文本创建带注释的git标记（或者一个签名的git标签，如果你传递--sign选项和你的git和Github 帐户配置为签署提交使用GPG密钥）。它还提交了一个额外的版本提升，它打开了主分支随后的发育周期
通过运行命令，将标签和提交都推送到上游存储库 git push --follow-tags注意：它也可以推送其他本地标签，be 小心。
让CI构建轮子和源分发包并验证两者都上传到Python包索引（PyPI）。
[可选]转到fonttoolsGithub版本页面并创建一个新版本，复制粘贴git标签的内容消息。这样，发行说明被很好地格式化为降价，并且观看repo的用户将收到一封电子邮件通知。总有一天我们会也自动化。