Apache FOP exibindo caracteres chineses com SimSun

Muitos usuários encontraram o problema de caracteres chineses serem exibidos como "####" em Documentos PDF gerados usando Apache FOP. A resolução deste problema envolve um processo de três etapas.

Primeiramente, é necessário especificar a família de fontes desejada no arquivo FO. Por padrão, o FOP usa a fonte Helvetica, que pode não suportar caracteres chineses. Para especificar uma fonte diferente, como SimSun, inclua a seguinte linha no arquivo FO:

...

No entanto, isso por si só pode não ser suficiente para resolver o problema. O FOP também requer uma configuração para mapear a família de fontes especificada para o arquivo de fonte real. Esta configuração é especificada no arquivo de configuração do FOP, normalmente localizado em conf/fop.xconf. Adicione as seguintes linhas ao arquivo de configuração:

/path/to/fonts

Isso informa ao FOP para configurar automaticamente todos os arquivos de fonte dentro do diretório especificado . Como alternativa, você pode especificar explicitamente o mapeamento de fonte para cada família de fontes e combinação de estilo:

Finalmente, especifique o arquivo de configuração ao invocar o FOP. Na linha de comando, use a opção -c:

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

Ou, se estiver usando FOP de Java code:

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

Seguindo estas etapas, O FOP terá as informações necessárias para exibir corretamente os caracteres chineses com a fonte SimSun nos documentos PDF gerados.