pdf.js 标准字体资源探秘:external/standard_fonts 目录的 Foxit 与 Liberation 字体体系详解
pdf.js 标准字体资源探秘:external/standard_fonts 目录的 Foxit 与 Liberation 字体体系详解
本文以 pdf.js 仓库
external/standard_fonts/README.md为线索,系统梳理 pdf.js 内置标准字体资源(Foxit 系列 PFB 字体与 Liberation Sans 系列 TTF 字体)的来源、许可证约定及其与src/core层字体引擎的深层耦合关系,帮助读者理解 PDF 的"标准 14 字体"在浏览器端是如何被精确复刻与替换的。
一、为什么 pdf.js 需要自带字体文件
PDF 规范定义了 14 种"标准字体"(Standard 14 Fonts):Times(4 个变体)、Helvetica(4 个变体)、Courier(4 个变体)、Symbol 与 ZapfDingbats。理论上,任何 PDF 阅读器都应无条件支持这些字体,PDF 文档内可以完全不嵌入这些字体的字形数据,仅靠字体名称引用它们。
这就给纯 JavaScript 的 PDF 渲染器 pdf.js 提出了一个难题:浏览器本地并不保证安装 Times、Helvetica、Courier 等字体,且各操作系统提供的同名字体字形与度量(metrics)并不一致。为了让不同平台上渲染出的 PDF 页面效果一致,pdf.js 必须在代码仓库内自带这些标准字体的二进制文件,并在渲染时用它们精确替代文档中引用的标准字体名。
这些字体文件正是存放在 external/standard_fonts 目录下,而 external/standard_fonts/README.md 则是这一目录的"身份说明书",明确了每个字体的来源与许可条款。
二、Foxit 字体:PDFium 的 PFB 文件
2.1 来源与版权
README 明确记载:目录中的 .pfb 文件是从 PDFium(Chromium 的 PDF 引擎)中提取的:
The pfb files in this directory were extracted from Pdfium.
其原始版权声明为:
Copyright 2014 PDFium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
即:这些字形的原始实现版权属于 Foxit Software Inc.(2014),由 PDFium 项目按 BSD 风格许可证(见 LICENSE_FOXIT)再分发,pdf.js 从 PDFium 提取后纳入本仓库。
2.2 目录中的 10 个 PFB 文件
external/standard_fonts 目录下共有 10 个 Type 1(PFB 格式)字体文件:
| 文件 | 对应 PDF 标准字体 |
|---|---|
FoxitFixed.pfb |
Courier |
FoxitFixedBold.pfb |
Courier-Bold |
FoxitFixedItalic.pfb |
Courier-Oblique |
FoxitFixedBoldItalic.pfb |
Courier-BoldOblique |
FoxitSerif.pfb |
Times-Roman |
FoxitSerifBold.pfb |
Times-Bold |
FoxitSerifItalic.pfb |
Times-Italic |
FoxitSerifBoldItalic.pfb |
Times-BoldItalic |
FoxitSymbol.pfb |
Symbol |
FoxitDingbats.pfb |
ZapfDingbats |
PFB(Printer Font Binary)是 Adobe 的 Type 1 字体二进制封装格式。这 10 个文件恰好覆盖了标准 14 字体中的 10 个:Courier 家族 4 个、Times 家族 4 个,以及 Symbol、ZapfDingbats 各 1 个。
2.3 许可证要点
LICENSE_FOXIT 是完整的 BSD 3-Clause 风格许可证文本,核心条款包括:
- 允许源码与二进制形式的再分发,但必须保留上述版权声明、条件列表和免责声明;
- 二进制形式再分发时,必须在文档或其他材料中复现版权声明;
- 未经事先书面许可,不得使用 Google Inc. 或贡献者的名字为衍生产品背书。
这意味着任何基于 pdf.js 的再分发,都应在分发物中保留 Foxit/PDFium 的版权声明(即本目录中的 LICENSE_FOXIT 文件)。
三、Liberation Sans:GPLv2 + Liberation 字体例外
3.1 版本与许可证
Helvetica 家族(4 个变体)在 pdf.js 中并不是用 Foxit 的 PFB 实现,而是使用 Liberation Sans 的 TTF 文件。README 特别强调:
The
LiberationSans-*.ttffiles are the unmodified upstream release of Liberation Sans 1.07.4
即目录中的 4 个 TTF 是 Liberation Sans 1.07.4 上游原版发布文件,未做任何修改,其许可证为 GNU General Public License v2 + Liberation 字体例外条款(见 LICENSE_LIBERATION,该文件即随上游发布包附带的 License.txt 与 COPYING 的副本)。
LICENSE_LIBERATION 的开头即写明:Red Hat 依据 GPL v2 及下述例外条款授予许可,其中两条关键例外是:
- 文档嵌入例外:如果用该字体创建文档并嵌入字体(或未修改的字体片段),该字体本身不会导致文档被 GPL 覆盖;
- 物理产品例外:在物理产品中分发字体目标码时,必须赋予用户访问和修改源码、并在同一物理产品上重装修改后版本的权利。
3.2 重要版本陷阱:Liberation 2.0 起改为 OFL
README 明确指出一个升级时的关键坑点:
Note that Liberation 2.0 and later are licensed under the SIL Open Font License 1.1 instead, so
LICENSE_LIBERATIONmust be updated as well whenever these font files are replaced.
即 Liberation 2.0 及更高版本改用 SIL Open Font License 1.1(OFL-1.1),与当前 1.07.4 的 GPLv2+例外许可完全不同。因此,如果未来升级这些字体文件,必须同步更换 LICENSE_LIBERATION,否则会因许可证文本与字体实际许可证不匹配而造成合规问题。
3.3 目录中的 4 个 TTF 文件
| 文件 | 对应 PDF 标准字体 |
|---|---|
LiberationSans-Regular.ttf |
Helvetica |
LiberationSans-Bold.ttf |
Helvetica-Bold |
LiberationSans-Italic.ttf |
Helvetica-Oblique |
LiberationSans-BoldItalic.ttf |
Helvetica-BoldOblique |
四、源码层的"字形宽度烘焙"机制
README 末尾给出了本目录与源码工程之间最关键的耦合说明:
The glyph order of these files is baked into
src/core/liberationsans_widths.jsand into the per-glyph scale factors insrc/core/*_factors.js, so those files need to be regenerated when the fonts are updated.
这意味着:Liberation Sans 的字符顺序(glyph order)被"烘焙"进 pdf.js 的 JavaScript 源码,共涉及两类文件:
4.1 宽度表:src/core/liberationsans_widths.js
src/core/liberationsans_widths.js 以整数数组形式记录了 Liberation Sans 各字形的水平宽度,例如文件开头的注释明确写着:
// Widths of glyphs in LiberationSans-Bold.ttf.
const LiberationSansBoldWidths = [
365, 0, 333, 278, 333, 474, 556, 556, 889, 722, 238, 333, 333, 389, 584, 278, ...
这些宽度值(单位为千分之一 em)按 TTF 的 glyph 顺序排列。pdf.js 渲染文本时,不依赖浏览器对字体的度量报告,而是直接查这张表来计算字符占位宽度,从而保证布局稳定可复现。
4.2 缩放系数:src/core/*_factors.js
除了宽度表,还有一组"每字形缩放系数"文件,用于把 Liberation Sans 的度量微调成与目标字体一致。例如 src/core/helvetica_factors.js 的文件头注释说明:
// Factors to rescale LiberationSans-Bold.ttf to have the same
// metrics as NimbusSans-Bold.otf.
即:将 LiberationSans-Bold.ttf 逐字形缩放,使其度量与 NimbusSans-Bold.otf 一致。这类 per-glyph 缩放系数文件还包括 calibri_factors.js、segoeui_factors.js、myriadpro_factors.js 等,共同服务于不同非标准字体向标准字体的度量对齐。
从源码结构看,这些 *_factors.js 与 liberationsans_widths.js 是在字体文件更新后由构建脚本重新生成的——因此 README 的警告是双重的:更换字体文件 ≠ 只替换 TTF,必须同步重新生成宽度表与缩放系数,否则会出现字形错位或宽度错乱。
五、从 README 到渲染管线:字体文件如何被使用
5.1 字体名称 → 文件名的映射
src/core/standard_fonts.js 中的 getFontNameToFileMap 将 PDF 标准字体名映射到上述字体文件,例如:
const getFontNameToFileMap = getLookupTableFactory(function (t) {
t.Courier = "FoxitFixed.pfb";
t.Courier-Bold = "FoxitFixedBold.pfb";
...
t.Helvetica = "LiberationSans-Regular.ttf";
t["Helvetica-Bold"] = "LiberationSans-Bold.ttf";
...
t["Times-Roman"] = "FoxitSerif.pfb";
...
t.Symbol = "FoxitSymbol.pfb";
t.ZapfDingbats = "FoxitDingbats.pfb";
t["LiberationSans-Regular"] = "LiberationSans-Regular.ttf";
...
});
与此同时,getStdFontMap 还维护了一张"标准 14 字体 + 常见别名"的映射表(如 Arial → Helvetica、TimesNewRoman → Times-Roman、CourierNew → Courier 等),用于把 PDF 中实际使用的字体名归一化到标准字体名。
5.2 替换候选:font_substitutions.js
src/core/font_substitutions.js 中保存了替换字体的元数据列表,例如对 Helvetica:
[
"Helvetica",
{
alias: "Helvetica",
path: "LiberationSans-Regular.ttf",
style: NORMAL,
ultimate: "sans-serif",
},
],
该列表还包含 Arimo、Nimbus Sans、TeX Gyre Heros、DejaVu Sans 等候选替换字体及其 ultimate 回退族,供无法嵌入字形时选择最接近的替代方案。pdf.js 会结合 getFontNameToFileMap 与替换列表,决定最终加载哪个内置字体文件。
5.3 构建与分发:gulpfile.mjs 的集成
从 gulpfile.mjs 的构建任务可以看到标准字体的打包方式:
- 构建时将
external/standard_fonts/*.pfb、external/standard_fonts/*.ttf以及LICENSE_*一并收集,生成web/standard_fonts目录(如 gulpfile.mjs 所示); - 各分发目标(通用构建、Mozilla central、Chromium 扩展)都会把
web/standard_fonts目录复制到各自的构建产物中。
也就是说,许可证文件(LICENSE_FOXIT / LICENSE_LIBERATION)与字体二进制是打包分发的一等公民,README 中记录的许可条款会随最终产品一并发布给终端用户。
六、维护与升级注意事项
综合 README 与源码,对 external/standard_fonts 目录的任何升级都应遵循以下清单:
- Foxit PFB 文件:如需替换,需保留 PDFium 的 BSD 版权声明(LICENSE_FOXIT),并确保新文件与
getFontNameToFileMap中的文件名映射一致; - Liberation TTF 文件:务必使用 Liberation Sans 1.07.4 或评估新版本的许可证变化——Liberation 2.0+ 已是 OFL-1.1,必须同步替换 LICENSE_LIBERATION;
- 重新生成派生数据:更换字体后,必须重新生成 src/core/liberationsans_widths.js 的宽度数组与 src/core/*_factors.js 的逐字形缩放系数,否则渲染度量将失准;
- 回归测试:标准字体的变化会直接影响所有未嵌入字体的 PDF 文档渲染,应跑完
test目录下的字体相关单元测试与浏览器渲染测试后再合入。
结语
external/standard_fonts 目录虽小,却是 pdf.js 保证"标准 14 字体"跨平台一致渲染的基石:Foxit 系 PFB 覆盖 Times/Courier/Symbol/ZapfDingbats,Liberation Sans 1.07.4 覆盖 Helvetica,二者分别受 BSD 风格与 GPLv2+例外条款约束。任何对这批字体文件的更新,都必须同时考虑许可证文本、getFontNameToFileMap 映射、liberationsans_widths.js 宽度表与 *_factors.js 缩放系数的一致性——这正是 README 留给后续维护者最重要的工程警示。