快速搭建支持中文的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下工作,我还附上了limodouDocbook_Step作为Docbook的示例,请运行build.bat编译DocBook_Step,作为FOP配置成功的测试。

完整的Docbook相关资料可以见mark的Docbook书签

posted @ 2007-02-25 04:06  丁丁  阅读(3359)  评论(7编辑  收藏  举报