DocBook文件转换环境设定（下）
时间：2007-02-17 来源：PHP爱好者
安装Formatter
使用XSL转换文件时，如果要转换成打印文件格式（如PDF、PostScript 等）时，通常必须分成两个步骤，先用XSLT processor将文件转换成 formatting objects，再用formatter将formatting objects转换成 打印文件。FOP是Apache计画所发展的一个formatter，可以把Formatting Object格式的文件转换成可打印文件，如PDF、PostScript等格式。
使用FOP同样需要有Java执行环境。下面以FOP 0.20.3版为例，示范 FOP的安装步骤：
1.从http://xml.apache.org 下载FOP 0.20.3版：
$ wget http://xml.apache.org/dist/fop/Fop-0.20.3-bin.tar.gz
2.将FOP套件解压缩：
$ tar zxvf Fop-0.20.3-bin.tar.gz
3.将所有以jar为附文件名的档案拷贝到Java的library目录下：
$ cp Fop-0.20.3/build/*.jar /usr/java/jdk1.3.1/lib
$ cp Fop-0.20.3/lib/*.jar /usr/javaj/jdk1.3.1/lib
4.将conf及hyph目录拷贝到适当的目录下（这两个目录在中文化时 才用的到）：
$ mkdir -p /usr/local/share/fop
$ cp -a Fop-0.20.3/conf /usr/local/share/fop
$ cp -a Fop-0.20.3/hyph /usr/local/share/fop
FOP安装好之后，就可以将FO格式的文件转换成PDF了。不过和xalan 一样，执行FOP需要指定许多个CLASS PATH，所以还是得先写一个
shell script把程序包装起来。下面为shell script的范例，读者 可以依据自己的环境做修改：
#!/bin/sh
# fop.sh -- wrapper of apache fop
# JAVA 解译器的安装路径
JAVA=/usr/java/jdk1.3.1/bin/java
# JAVA library 的安装路径
JAVA_LIB=/usr/java/jdk1.3.1/lib
# 所有的类别路径
JAR=”fop.jar
logkit-1.0b4.jar
sax.jar xerces.jar
avalon-framework-4.0.jar
batik.jar xalan.jar
jimi-1.0.jar
xalanj1compat.jar”
for i in $JAR
do
CLASSPATH=”$CLASSPATH:$JAVA_LIB/$i”
done
export CLASSPATH
echo CLASSPATH=$CLASSPATH
# 执行
$JAVA $FOP_OPTS org.apache.fop.apps.Fop “$@”
将以上的shell script存成fop.sh，为了执行方便，可以拷贝到 /usr/local/bin。
中文化环境设定
如已完成前述安装作业，即已经把DocBook的文件转换环境建立起 来了。而如果要处理中文文件，还有一些设定要修改，此部份包括
DocBook XSL Stylesheet及FOP的中文字形，以下将针对这两个部份 分别说明。
DocBook XSL Stylesheet的中文化
DocBook XSL Stylesheet在转换成FO时所指定的字形只有英文字 形，如果不修改就直接套用在中文文件上，则所有的中文字最后都
将被取代成“#”字号输出。修改stylesheet时，为了保持DocBook 的完整起见，必须另外建立一个XSL档来继承原来的docbook.xsl，
并且修改部份的定义。假设取名为bg5docbook.xsl，其内容如下：
xmlns:fo=“http://www.w3.org/1999/XSL/Format”
xmlns:doc=“http://nwalsh.com/xsl/documentation/1.0”
exclude-result-prefixes=“doc”
version=‘1.0'>
bkai
12
bkai
3.8cm
2.54cm
在bg5docbook.xsl中，使用xsl:import指令以继承docbook.xsl的 设定，并且修改了三个部份的设定，字形及字体大小、纸张大小、
以及边框大小。在中文化中，最重要的是设定字形，其余的可视需 要而设定。在上例中，将文件的body及title字形设定为楷书（bkai）， 纸张大小设定为A4，边框则设定为左边（内边）3.8公分，右边（外 边）2.54公分。最后一个变量设定，是为了修正页码显示的问题， 当DocBook中的字体大小超过10pt时，页码就会消失，原因是页码的 显示区域太小，formatter将页码显示的动作忽略了。该变量的预设 值为12pt，最大只能放10pt的页码。要个问题只需将显示区域设大一点就可以了，如上例设定为20pt。
DocBook在文件区域化的选项里，繁体中文文件的区域化属性为zh_tw， 但是FOP所认得的区域化属性为zh，如果FOP无法正确辨认出区域化 属性，则输出的中文文件的断行会出现问题，这是因为FOP将连续的 中文字当作是不可分割的单位之故。本文的作法是将DocBook XSL
Stylesheet内的common目录下的zh_tw.xml做修改，直将把第二行language=“zh_tw”改成language=“zh”即可。
FOP的中文化
在前一节中，DocBook已指定输出的字形为楷书，但是FOP本身并 没有附中文字形，使用者必须自己加入中文字形。加入字形要做两
件事情，第一是产生matrics檔，第二是在userconfig.xml档案中加 入字形信息。
FOP套件中提供一个TTFReader的程序，TTFReader可以从ttf字形 档产生matrics檔。为了执行上的便利，首先要将TTFReader包装在
shell script程序中，下列为包装范例：
#!/bin/sh
#
# ttfreader.sh
#
JAVALIB=”/usr/java/jdk1.3.1/lib”
CLASSPATH=”$JAVALIB/fop.jar:$JAVALIB/xerces.jar”
export JAVALIB CLASSPATH
java org.apache.fop.fonts.apps.TTFReader “$@”
将档案存成ttfreader.sh，并拷贝到/usr/local/bin，就可以用 来建立matrics檔了。假设系统中已经有文鼎楷书字形存放于
/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf目录下，下列的 指令可以产生matrics文件：
$ ttfreader.sh -fn arphic_kai /usr/share/fonts/zh_TW/TrueType
/bkai00mp.ttf/usr/local/share/fop/conf/bkai.xml
执行完后，在/usr/local/share/fop/conf/目录下会多出一个
bkai.xml的档案，bkai.xml就是文鼎楷书的matrics档。
接着要编辑/usr/local/share/fop/conf/userconfig.xml档案，将
下列的设定加入到userconfig.xml档案中：
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
编辑好userconfig.xml文件之后，FOP就可以使用文鼎楷书字形了。
试试中文的DocBook文件：
“http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd”>
这是一个中文的DocBook文件，供测试之用，看看中文字有 没有出现？断行有没有断得很混乱。如果没有 大 问题，那就恭喜你了！
将上列的文字存成test.xml，然后使用下列的指令将文件转成fo檔：
$ xalan.sh -in test.xml -xsl /usr/share/sgml/docbook/docbook-xsl-1.48
/fo/bg5docbook.xsl-out test.fo
产生fo档之后，再使用fop转成pdf檔：
$ fop.sh -c /usr/local/share/fop/conf/userconfig.xml-fo
test.fo -pdf test.pdf
产生test.pdf之后，再以acrobat reader开启，检查看看中文字 有没有出现，再看看断行有没有断得乱七八糟。
结语
本篇文章介绍了如何安装及设定DocBook 文件转换环境，并提供 简单的范例供读者参考。因为每个人的操作系统环境不尽相同，在 设定时可能有部份必须修改，如JAVA程序安装的路径等。
至于如何编辑DocBook文件，读者必须另外研读参考资料，例如， 中心吕学祥先生所撰写之“使用Emacs编辑XML”文章
（http://www.sinica.edu.tw/~lu）以及，O'Reilly出版社出版的 “DocBook:The Definitive Guide”，这本书除了到书店购买以外，
读者也可以直接从http://docbook.org网站免费下载。（全文完）
php爱 好者站 http://www.ｐｈｐｆａｎｓ.net 文章|教程|下载|源码|论坛.
使用XSL转换文件时，如果要转换成打印文件格式（如PDF、PostScript 等）时，通常必须分成两个步骤，先用XSLT processor将文件转换成 formatting objects，再用formatter将formatting objects转换成 打印文件。FOP是Apache计画所发展的一个formatter，可以把Formatting Object格式的文件转换成可打印文件，如PDF、PostScript等格式。
使用FOP同样需要有Java执行环境。下面以FOP 0.20.3版为例，示范 FOP的安装步骤：
1.从http://xml.apache.org 下载FOP 0.20.3版：
$ wget http://xml.apache.org/dist/fop/Fop-0.20.3-bin.tar.gz
2.将FOP套件解压缩：
$ tar zxvf Fop-0.20.3-bin.tar.gz
3.将所有以jar为附文件名的档案拷贝到Java的library目录下：
$ cp Fop-0.20.3/build/*.jar /usr/java/jdk1.3.1/lib
$ cp Fop-0.20.3/lib/*.jar /usr/javaj/jdk1.3.1/lib
4.将conf及hyph目录拷贝到适当的目录下（这两个目录在中文化时 才用的到）：
$ mkdir -p /usr/local/share/fop
$ cp -a Fop-0.20.3/conf /usr/local/share/fop
$ cp -a Fop-0.20.3/hyph /usr/local/share/fop
FOP安装好之后，就可以将FO格式的文件转换成PDF了。不过和xalan 一样，执行FOP需要指定许多个CLASS PATH，所以还是得先写一个
shell script把程序包装起来。下面为shell script的范例，读者 可以依据自己的环境做修改：
#!/bin/sh
# fop.sh -- wrapper of apache fop
# JAVA 解译器的安装路径
JAVA=/usr/java/jdk1.3.1/bin/java
# JAVA library 的安装路径
JAVA_LIB=/usr/java/jdk1.3.1/lib
# 所有的类别路径
JAR=”fop.jar
logkit-1.0b4.jar
sax.jar xerces.jar
avalon-framework-4.0.jar
batik.jar xalan.jar
jimi-1.0.jar
xalanj1compat.jar”
for i in $JAR
do
CLASSPATH=”$CLASSPATH:$JAVA_LIB/$i”
done
export CLASSPATH
echo CLASSPATH=$CLASSPATH
# 执行
$JAVA $FOP_OPTS org.apache.fop.apps.Fop “$@”
将以上的shell script存成fop.sh，为了执行方便，可以拷贝到 /usr/local/bin。
中文化环境设定
如已完成前述安装作业，即已经把DocBook的文件转换环境建立起 来了。而如果要处理中文文件，还有一些设定要修改，此部份包括
DocBook XSL Stylesheet及FOP的中文字形，以下将针对这两个部份 分别说明。
DocBook XSL Stylesheet的中文化
DocBook XSL Stylesheet在转换成FO时所指定的字形只有英文字 形，如果不修改就直接套用在中文文件上，则所有的中文字最后都
将被取代成“#”字号输出。修改stylesheet时，为了保持DocBook 的完整起见，必须另外建立一个XSL档来继承原来的docbook.xsl，
并且修改部份的定义。假设取名为bg5docbook.xsl，其内容如下：
xmlns:fo=“http://www.w3.org/1999/XSL/Format”
xmlns:doc=“http://nwalsh.com/xsl/documentation/1.0”
exclude-result-prefixes=“doc”
version=‘1.0'>
bkai
12
bkai
3.8cm
2.54cm
在bg5docbook.xsl中，使用xsl:import指令以继承docbook.xsl的 设定，并且修改了三个部份的设定，字形及字体大小、纸张大小、
以及边框大小。在中文化中，最重要的是设定字形，其余的可视需 要而设定。在上例中，将文件的body及title字形设定为楷书（bkai）， 纸张大小设定为A4，边框则设定为左边（内边）3.8公分，右边（外 边）2.54公分。最后一个变量设定，是为了修正页码显示的问题， 当DocBook中的字体大小超过10pt时，页码就会消失，原因是页码的 显示区域太小，formatter将页码显示的动作忽略了。该变量的预设 值为12pt，最大只能放10pt的页码。要个问题只需将显示区域设大一点就可以了，如上例设定为20pt。
DocBook在文件区域化的选项里，繁体中文文件的区域化属性为zh_tw， 但是FOP所认得的区域化属性为zh，如果FOP无法正确辨认出区域化 属性，则输出的中文文件的断行会出现问题，这是因为FOP将连续的 中文字当作是不可分割的单位之故。本文的作法是将DocBook XSL
Stylesheet内的common目录下的zh_tw.xml做修改，直将把第二行language=“zh_tw”改成language=“zh”即可。
FOP的中文化
在前一节中，DocBook已指定输出的字形为楷书，但是FOP本身并 没有附中文字形，使用者必须自己加入中文字形。加入字形要做两
件事情，第一是产生matrics檔，第二是在userconfig.xml档案中加 入字形信息。
FOP套件中提供一个TTFReader的程序，TTFReader可以从ttf字形 档产生matrics檔。为了执行上的便利，首先要将TTFReader包装在
shell script程序中，下列为包装范例：
#!/bin/sh
#
# ttfreader.sh
#
JAVALIB=”/usr/java/jdk1.3.1/lib”
CLASSPATH=”$JAVALIB/fop.jar:$JAVALIB/xerces.jar”
export JAVALIB CLASSPATH
java org.apache.fop.fonts.apps.TTFReader “$@”
将档案存成ttfreader.sh，并拷贝到/usr/local/bin，就可以用 来建立matrics檔了。假设系统中已经有文鼎楷书字形存放于
/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf目录下，下列的 指令可以产生matrics文件：
$ ttfreader.sh -fn arphic_kai /usr/share/fonts/zh_TW/TrueType
/bkai00mp.ttf/usr/local/share/fop/conf/bkai.xml
执行完后，在/usr/local/share/fop/conf/目录下会多出一个
bkai.xml的档案，bkai.xml就是文鼎楷书的matrics档。
接着要编辑/usr/local/share/fop/conf/userconfig.xml档案，将
下列的设定加入到userconfig.xml档案中：
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
embed-file=“/usr/share/fonts/zh_TW/TrueType/bkai00mp.ttf”>
编辑好userconfig.xml文件之后，FOP就可以使用文鼎楷书字形了。
试试中文的DocBook文件：
“http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd”>
这是一个中文的DocBook文件，供测试之用，看看中文字有 没有出现？断行有没有断得很混乱。如果没有 大 问题，那就恭喜你了！
将上列的文字存成test.xml，然后使用下列的指令将文件转成fo檔：
$ xalan.sh -in test.xml -xsl /usr/share/sgml/docbook/docbook-xsl-1.48
/fo/bg5docbook.xsl-out test.fo
产生fo档之后，再使用fop转成pdf檔：
$ fop.sh -c /usr/local/share/fop/conf/userconfig.xml-fo
test.fo -pdf test.pdf
产生test.pdf之后，再以acrobat reader开启，检查看看中文字 有没有出现，再看看断行有没有断得乱七八糟。
结语
本篇文章介绍了如何安装及设定DocBook 文件转换环境，并提供 简单的范例供读者参考。因为每个人的操作系统环境不尽相同，在 设定时可能有部份必须修改，如JAVA程序安装的路径等。
至于如何编辑DocBook文件，读者必须另外研读参考资料，例如， 中心吕学祥先生所撰写之“使用Emacs编辑XML”文章
（http://www.sinica.edu.tw/~lu）以及，O'Reilly出版社出版的 “DocBook:The Definitive Guide”，这本书除了到书店购买以外，
读者也可以直接从http://docbook.org网站免费下载。（全文完）
php爱 好者站 http://www.ｐｈｐｆａｎｓ.net 文章|教程|下载|源码|论坛.
相关阅读 更多 +
