QGIS 内嵌 PDF4QT 中的 Liberation 字体:标准 PDF 字体的开源替代方案与构建安装指南

原创2026-09-21 11:37:201,414 阅读
文章标签:GIS桌面应用数据可视化数据分析插件系统3D渲染

QGIS 内嵌 PDF4QT 中的 Liberation 字体:标准 PDF 字体的开源替代方案与构建安装指南

本指南以 QGIS 仓库内嵌的 PDF4QT 渲染引擎所携带的 Liberation Fonts 说明文档 为核心,讲解这套开源字体的设计目标、构建与安装流程、许可证约束,以及它在 PDF4QT 中充当 PDF 标准 14 字体替代方案的具体实现。读完本文,你将掌握 Liberation 字体从源码构建到系统安装的完整操作,并理解 QGIS 的 PDF 渲染路径中为何、以及如何使用这些字体。

一、Liberation Fonts 是什么

Liberation Fonts 是一套免费、开源的字体集合,其核心目标是提供与商业字体 Times New Roman、Arial、Courier New 在文档排版布局上高度兼容的替代字体。也就是说,使用 Liberation Serif / Sans / Mono 渲染的文档,在行宽、字符度量(metrics)、换行位置等方面尽可能接近使用商业字体排版的结果,从而让自由软件环境下的文档交换不因缺字而破坏版式。

在 QGIS 仓库中,这套字体以二进制 TTF 形式内嵌在 PDF4QT 渲染库的 liberation-fonts-ttf 目录下,共 12 个文件,覆盖三个字族、每种四个字重:

字族 对应商业字体 内嵌 TTF 文件
Liberation Serif Times New Roman LiberationSerif-{Regular,Bold,Italic,BoldItalic}.ttf
Liberation Sans Arial LiberationSans-{Regular,Bold,Italic,BoldItalic}.ttf
Liberation Mono Courier New LiberationMono-{Regular,Bold,Italic,BoldItalic}.ttf

配套文件还包括 LICENSE(SIL Open Font License 1.1)、AUTHORS(贡献者名单)与 ChangeLog(版本演进记录)。

二、在 PDF4QT / QGIS 中的实际角色:标准 14 字体替代

PDF 规范定义了一组"标准 14 字体"(Standard 14 Fonts),包括 Times Roman 系列、Helvetica 系列、Courier 系列以及 Symbol、ZapfDingbats。这些字体通常不必嵌入 PDF 文件,渲染端需要自行找到等价字体来绘制。由于 Times New Roman、Helvetica 等是商业或平台专有字体,开源渲染器普遍采用 Liberation 系列作为替代——这正是 QGIS 仓库中 PDF4QT 的做法。

从源码看,PDFSystemFontInfoStorage::loadFont 中维护了一张完整的映射表:当遇到 PDF 标准 14 字体类型时,switch (standardFontType) 将每种字体样式逐一映射到对应的 Liberation TTF 文件,例如:

  • TimesRoman → LiberationSerif-Regular.ttf
  • HelveticaBold → LiberationSans-Bold.ttf
  • CourierOblique → LiberationMono-Italic.ttf

随后通过 QFile 从 Qt 资源路径 :/fonts/liberation-fonts-ttf/%1 读取字体二进制数据,作为 SystemFontData 返回给渲染管线。对应的资源打包定义在 fonts.qrc 中,它将 12 个 TTF 全部注册到前缀 /fonts 下。这意味着 QGIS 在渲染含标准 PDF 字体的文档时,无需依赖用户系统中是否安装了 Times New Roman 或 Helvetica,开箱即可获得一致的排版结果。

需要说明的是:Liberation 只覆盖上表中三个"核心"字族;对于 Symbol 与 ZapfDingbats,从映射代码看并未指定替代文件,会走后续的字体回退逻辑(如按字体名称精确匹配系统字体)。这是从源码结构可以推断出的实现边界。

三、构建要求与从源码构建

原文档给出了 Liberation Fonts 的构建前提与完整步骤,可以直接作为从上游源码自行构建的参考。

构建工具链要求:

  • FontForge:开源字体编辑/生成工具,用于从 SFD 源文件生成最终字体;
  • Python fonttools:Python 字体处理库,用于字体的后处理与元数据操作。

构建步骤:

  1. 获取源码:
    $ git clone https://github.com/liberationfonts/liberation-fonts.git
    
    或者从 releases 页面下载 liberation-fonts-[VERSION].tar.gz 源码包,并解压:
    $ tar zxvf liberation-fonts-[VERSION].tar.gz
    
  2. 编译:
    $ cd liberation-fonts    # 或 cd liberation-fonts-[VERSION]
    $ make
    
    编译完成后,生成的二进制字体文件位于 liberation-fonts-ttf-[VERSION] 目录中——这与 QGIS 仓库中内嵌目录 liberation-fonts-ttf/ 的命名保持一致。

注意:QGIS 仓库内嵌的是构建好的 TTF 成品(见 liberation-fonts-ttf 目录),并非源码形态;若要在仓库中使用这些字体,直接读取内嵌文件即可,无需重新构建。

四、安装到系统

构建产物可以按发行版习惯安装:

Fedora 用户(原文档给出明确步骤):

  • 用户级安装:将 TTF 文件复制到 ~/.fonts,仅对当前用户生效;
  • 系统级安装:将 TTF 文件复制到 /usr/share/fonts/liberation,对所有用户生效;
  • 安装完成后运行 fc-cache,让字体缓存(fontconfig)刷新,使新字体立即可被应用程序发现。

其他发行版:请参照对应发行版的字体安装文档(例如 Debian/Ubuntu 通常使用 /usr/share/fonts/truetype/ 并同样需要刷新 fontconfig 缓存)。

五、使用方式

Liberation 字体的使用非常直观:在任意应用程序的字体选择器中,直接选择 Liberation Serif、Liberation Sans 或 Liberation Mono 即可。由于三族字体的度量设计对标 Times New Roman、Arial 与 Courier New,在它们之间切换不会破坏既有文档的排版布局。在 PDF4QT 场景下,这种"度量兼容"是渲染端能够放心用它们替代标准 PDF 字体的前提——替换后文字位置、行距与换行结果基本不变。

六、许可证:SIL Open Font License 1.1

本字体软件依照 SIL Open Font License(OFL)1.1 授权,完整条款见仓库内 LICENSE 文件。几个要点:

  • 字体可被自由使用、研究、修改与再分发,但不得单独出售字体本身;
  • 字体(含衍生作品)可以随软件捆绑、嵌入、再分发或销售,前提是每份副本都包含版权声明与本许可证;
  • 衍生作品不得使用保留字体名称(Reserved Font Name),例如"Liberation"这一名称不可用于衍生字体;
  • 使用这些字体排版生成的文档不受本许可证约束,可以任意使用与分发;
  • 该许可允许 Installable Embedding(从 ChangeLog 可知字体设置了 fsType 为 0),这正是 PDF 渲染器能够将字体嵌入输出 PDF 文件的合规基础。

七、维护者指南:版本发布流程

原文档为字体包的维护者给出了标准的发版流程,对希望在本地定制或重新打包 Liberation 字体的团队同样适用:

  1. 在 Makefile 中更新版本号:
    VER = [NEW_VERSION]
    
  2. 更新字体元数据:
    $ make versionupdate
    
    可用 ftinfo/otfinfo(或 FontForge 本身)验证元数据变更是否正确。
  3. 强烈建议同步更新 ChangeLog,记录本次发布的变化。
  4. 生成发布包:
    $ make dist
    
    新版本压缩包会输出到 dist/ 目录,命名为 liberation-fonts-[NEW_VERSION].tar.gz。
  5. 为 [NEW_VERSION] 创建对应的 git tag,并上传发布包。

八、版本脉络:从 ChangeLog 看字体演进

仓库内 ChangeLog 记录了该字体的演进历史,可帮助判断内嵌版本的能力与修复范围:当前 QGIS 内嵌的快照对应 liberation-fonts 2.1.5(2021-09-30 发布),此后各版本主要修复了上下标数字缺失/不一致、Sans 字族性别符号不一致、部分 Unicode 字符宽度异常(如 U+2262、U+2669、U+266C、U+20BF)、Mono 字族被 fontconfig 与 cairo 识别为等宽字体等问题;更早的 2.00.x 版本则引入了 Bitcoin 符号、马其顿语/塞尔维亚语西里尔字形修正等。贡献者名单见 AUTHORS,原始设计出自 Ascender 公司的 Steve Matteson,现由 Red Hat 维护。

九、小结

Liberation Fonts 以"度量兼容"为设计哲学,为开源世界提供了 Times New Roman / Arial / Courier New 的可替代字体。在 QGIS 的 PDF 渲染链路中,这套字体通过 fonts.qrc 打包成 Qt 资源,并在 pdffont.cpp 的映射表驱动下,精准承接 PDF 标准 14 字体的渲染任务,配合其 OFL 1.1 许可下的 Installable Embedding 能力,保证了输出 PDF 的字体嵌入合规与版面稳定。

登录后查看全文
QGIS