Apache FOP 使用 SimSun 显示汉字

很多用户都遇到过汉字显示为“####”的问题使用 Apache FOP 生成的 PDF 文档。解决这个问题涉及三个步骤。

首先，需要在 FO 文件中指定所需的字体系列。默认情况下，FOP 使用 Helvetica 字体，该字体可能不支持中文字符。要指定不同的字体（例如 SimSun），请在 FO 文件中包含以下行：

...

但是，仅此可能不足以解决问题。 FOP 还需要配置将指定的字体系列映射到实际的字体文件。此配置在 FOP 的配置文件中指定，通常位于 conf/fop.xconf。将以下行添加到配置文件中：

/path/to/fonts

这通知 FOP 自动配置指定目录中的所有字体文件。或者，您可以为每个字体系列和样式组合显式指定字体映射：

最后指定调用FOP时的配置文件。从命令行，使用 -c 选项：

fop -c /path/to/fop.xconf input.fo input.pdf

或者，如果从 Java 使用 FOP代码：

fopFactory.setUserConfig(new File("/path/to/fop.xconf"));

通过执行以下步骤，FOP 将获得必要的信息，以便在生成的 PDF 文档中使用 SimSun 字体正确显示汉字。