
FynePDF 发布 fynepdf-pdfa:不依赖 Ghostscript 实现 PDF/A 转换
来源标题:Show HN: Fynepdf-pdfa – PDF/A conversion without Ghostscript (MIT)
FynePDF 推出开源 MIT 许可的 C++17 库与命令行工具 fynepdf-pdfa,可在不依赖 Ghostscript 的情况下将 PDF 原地修复为合规 PDF/A。该工具基于 qpdf,在 2,053 个文件的测试中生成结果均通过 veraPDF 1.31 校验,仅丢失 PDF/A 本身禁止保留的注释与附件,未丢失书签、链接、表单字段或标签。支持 PDF/A-1b、2b、3b,可通过 npm 在 Linux、Windows 和 macOS 上直接运行。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
把 PDF 就地修复,而不是重建,从而转成合规的 PDF/A。基于 qpdf 的 C++17 库和命令行,MIT 许可,不依赖 Ghostscript。由 FynePDF 为其 Web 和桌面应用开发。
在同样的 2,053 个文件上(veraPDF 语料库、来自网络的 1,000 个 PDF,以及为测试每条 PDF/A 规则而生成的文件)测试 PDF/A-2b,每个结果都由 veraPDF 1.31 检查:
“丢失”指输入中有、而结果中没有的书签、链接、表单字段、标签、注释、附件或签名。fynepdf-pdfa 的 22 处丢失是 PDF/A 本身禁止的注释和附件;它没有丢失任何书签、链接、字段或标签。每个工具、级别和文件集、真实文件以及自行运行的方法:docs/benchmarks.md。
从命令行
npx fynepdf-pdfa input.pdf output.pdf # PDF/A-2b npx fynepdf-pdfa input.pdf output.pdf --part 1 # PDF/A-1b(或 --part 3)
通过 npm 可在 Linux(x64、arm64)、Windows(x64)和 macOS(Apple silicon、Intel)上运行,无需构建。也可以从 Releases 下载对应平台的压缩包:程序、字体和 PDFium 都已就绪,直接运行 ./fynepdf-pdfa input.pdf output.pdf 即可。
它会把处理结果以一行 JSON 打印出来,并写出 output.pdf: {"ok":true,"conforms":true,"pages":12,"signatures":0,"problems":[],"changes":{"cmyk-colours":31,"font-widths-written":2,"javascript":1}}
如果文件无法转成 PDF/A,conforms 为 false。此时写出的文件不带 PDF/A 标签,problems 说明原因(例如 font-not-embedded: KozMinPr6N-Regular)。退出码:0 表示完成,2 表示需要密码,3 表示无法读取,5 表示无法写入。字体在程序旁边或安装目录中查找;--fonts <folder> 可指向其他位置。
const { toPdfa } = require("fynepdf-pdfa"); // npm install fynepdf-pdfa const result = await toPdfa("in.pdf", "out.pdf", { part: 2 }); // result.conforms、result.problems、result.changes:即上面的 JSON
当文件无法读取、需要密码或无法写入时,Promise 会 reject(error.code)。已包含类型定义;更多内容见 npm/fynepdf-pdfa。
#include <fynepdf/pdfa/pdfa.h> fynepdf::pdfa::PdfaOptions options; options.part = 2; // PDF/A-1b、2b 或 3b options.fonts = "path/to/fonts"; // 本仓库的 fonts/(安装后为 FYNEPDF_PDFA_FONTS_DIR) fynepdf::pdfa::PdfaResult result = fynepdf::pdfa::ConvertToPdfa("in.pdf", "out.pdf", options); if (result.ok && result.conforms) { // out.pdf 是 PDF/A-2b } else { // result.error:"password"、"unreadable" 等;result.problems:为何不是 PDF/A examples/convert.cpp 是一个完整程序。
include(FetchContent) FetchContent_Declare(fynepdf_pdfa GIT_REPOSITORY https://github.com/fynepdf/fynepdf-pdfa.git GIT_TAG v0.1.2) FetchContent_MakeAvailable(fynepdf_pdfa) target_link_libraries(your_app PRIVATE fynepdf::pdfa)
或者安装它(cmake --install build),然后使用 find_package(fynepdf_pdfa CONFIG REQUIRED),这也会把 FYNEPDF_PDFA_FONTS_DIR 设为安装的字体目录。它需要系统或 vcpkg 提供的 qpdf 和 libjpeg(仓库中有 vcpkg.json)。
你需要 CMake 3.16+、C++17 编译器、qpdf 11 或更新版本以及 libjpeg-turbo。OpenJPEG(JPEG 2000 图像)、Little CMS(ICC 配置文件)和 PDFium(PDF/A-1b 透明度)是可选的。
Debian 或 Ubuntu
sudo apt install cmake ninja-build g++ pkg-config libqpdf-dev libjpeg-dev libopenjp2-7-dev liblcms2-dev
macOS
brew install cmake ninja qpdf jpeg-turbo openjpeg little-cms2
cmake --preset default # Release 构建并带测试,输出到 build/default cmake --build --preset default ctest --preset default # 以 1b、2b 和 3b 转换 64 个测试文件
在 Windows(或任何平台)上使用 vcpkg:设置 VCPKG_ROOT 并改用 --preset vcpkg。对于使用透明度的 PDF/A-1b 页面,添加 -DFYNEPDF_PDFA_PDFIUM_DIR=<folder>,并在其中解压一个 pdfium-binaries 发布包(PDFium 仅在页面需要时才加载)。添加 -DFYNEPDF_PDFA_VERAPDF=docker 可用 veraPDF 检查每个测试结果。
发布版附带的独立程序(其库从 vcpkg 链接进来,PDFium 和字体放在旁边)由 node scripts/release-build.mjs <target> 构建,目标可为 linux-x64、linux-arm64、win32-x64、darwin-arm64 或 darwin-x64;Linux 目标可在任何机器上通过 Docker 构建。其余内容见 RELEASING.md。
已在 Linux(Debian 12,GCC 12)和 Windows(LLVM-MinGW,Clang 22)上构建并测试。macOS 和 Visual Studio 构建已配置好,并从首个发布版起纳入 CI 覆盖。
它用 qpdf 打开 PDF,然后逐遍处理:修复、目录、颜色、表单、页面、图层、附件、每个对象、内容流、字体、文本、透明度(PDF/A-1),最后是输出意图和元数据。每一遍只修改 PDF/A 禁止的内容;PDF/A 标签最后才加上,且仅当没有遗留问题时。字体是大部分工作:每个字体都会被读取,对照页面中出现的编码进行检查,就地修复或替换为宽度相同的免费字体。
完整过程,以及它不做什么(“a”和“u”级别、OCR、PDF/A-4):docs/how-it-works.md。
FynePDF 之前像大多数工具一样用 Ghostscript 处理 PDF/A。它会把并非 PDF/A 的文件标记为 PDF/A,过程中丢失书签和文本,占用大量服务器资源,而且其 AGPL 许可使其无法用于我们的桌面应用。我们想要一种可以随处分发、值得信赖的 PDF/A,于是自己写了一个,并在同样的文件上与所有其他工具对比测量。这就是成果。
姊妹项目:fynepdf-grayscale,以同样的方式就地让 PDF 变灰。
MIT,© 2026 FynePDF。fonts/ 中的字体保留各自的许可(SIL OFL 1.1、Apache-2.0、Bitstream Vera、Adobe CMaps 的 BSD-3-Clause);见 THIRD-PARTY-NOTICES.md。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。