快速搭建支持中文的FOP 0.20.5，主要目的是支持中文Docbook转PDF或HTML格式

Docbook 4.2是中立的XML的技术文档标准定义，完全独立于平台和呈现格式特性使得Docbook成为书写大型技术文档，如论文、使用手册，API手册等的理想选择。XML文本化的Docbook也使得Docbook相比于二进制格式的Word或者Framemaker更容易通过版本管理软件如SubVersion做到通过Internet协作写作。

将中文Docbook转换为PDF文件格式，Dorian已经有了写出了详细实现步骤，我遵循他的步骤，花了2天终于可以搭建成功了（据称他花了一周），我写这篇随笔的目的是希望能够帮助您，使这一时间进一步缩短。

请按照下面步骤搭建支持中文的FOP文档生成器：

1. 安装Java Runtime；
2. 下载FOP 0.20.5，本文写作时，FOP 0.93版还不支持TTF字体（比如宋体）嵌入至PDF，具体信息可见fop-0.93/doc/0.93/fonts.pdf，所以目前只能使用0.20.5版本。
3. 请解压缩FOP 0.20.5到C:\FOP-0.20.5；
4. 下载FOP 0.93，将fop-0.93\lib\中的文件替换为C:\FOP-0.20.5\lib\相应的库文件：
   • avalon-framework-4.2.0.jar 替换 avalon-framework-cvs-20020806.jar
   • batik-all-1.6.jar 替换 batik.jar
   • xalan-2.7.0.jar 替换 xalan-2.4.1.jar
   • xercesImpl-2.7.1.jar 替换 xercesImpl-2.2.1.jar
   • xml-apis-1.3.02.jar 替换 xml-apis.jar
   • serializer-2.7.0.jar 新增复制重命名为 serializer.jar
5. 下载Jimi，将下载文件jimi1_0.zip中的JimiProClasses.zip文件解压缩到C:\FOP-0.20.5\lib\，并重命名为jimi-1.0.jar；（添加FOP对PNG格式文件的支持）
6. 下载Docbook 4.2的DTD文件，解压到C:\FOP-0.20.5\docbook-xml-4.2；
7. 下载docbook-xsl 1.72.0，解压到C:\FOP-0.20.5\docbook-xsl；
8. 下载FOP 0.20.5 中文Docbook补丁包（我提供的），覆盖C:\FOP-0.20.5的相应文件；
9. 如果使用的是Windows 2000，请修改C:\FOP-0.20.5\lib\zhconfig.xml，将/windows/fonts/simsun.ttc改为/winnt/fonts/simsun.ttc；
10. 添加C:\FOP-0.20.5到环境变量PATH中。（我的电脑->属性->高级->环境变量，新增）

至此完成FOP的搭建，由于Java的文件系统访问问题，Docbook的编译最好在同一个盘符下，也就是说，如果完全按照上述步骤，最好在C:\FOP-0.20.5\work下工作，我还附上了limodou的Docbook_Step作为Docbook的示例，请运行build.bat编译DocBook_Step，作为FOP配置成功的测试。

丁丁 2007-02-25 04:06 发表评论