DocBook使用XIncludes指定图像路径的方法

设有一DocBook的文档如下：

<book … xml:base="./"> ...... <xi:include href="chapter_overview.xml" />

在使用XIncludes导入chapter_overview.xml时，XSL处理器将在该文件的路径前添加xml.base，因此就成为“./chapter_overview.xml”，这表示chapter_overview.xml在<book>元素所在文档的同一目录下。

这是XIncludes的基本用法。

但在使用XIncludes查找图像时，却非简单。生成HTML或PDF时，XSL查找图像时基于以下条件进行：

1. 如果是绝对路径，则按绝对路径来查找。
2. 如果是相对路径，且未使用XIncludes，则按fileref指定的路径查找。
3. 如果是相对路径，但使用XIncludes，且keep.relative.image.uris="1"，则按fileref指定的路径查找。
4. 如果是相对路径，但使用XIncludes，且keep.relative.image.uris="0"，则按xml:base + fileref指定的路径查找。

此外，生成HTML时keep.relative.image.uris默认值为1;而生成PDF时keep.relative.image.uris默认值为0。

因此，当使用了XIncludes后，设有一个名为test.xml的文件（被上述<book>所在文档通过XIncludes包含）通过fileref指定了一个相对的图像路径：

<imagedata fileref="images/custom/test.jpg" />

在生成HTML时，keep.relative.image.uris默认值为1，符合第3种情况，则直接按fileref指定的路径"images/custom/test.jpg"来查找，该路径相对于所生成的HTML文件。因此，只要文件路径符合下列条件：

test.html
images
|--> custom
|--> test.jpg

图像就能正常显示。

而在生成PDF时，由于keep.relative.image.uris默认值为0，符合第4种情况，则在计算路径时需添加xml:base的前缀。但xml:base值为“./”，是相对于xml文件所在的路径而非相对于所生成的PDF文件所在的路径，因此当我们需要在另外一个目录，如Dist，中生成PDF时，则导致找不到相应的图像。这就导致了使用同一标签

<imagedata fileref="images/custom/test.jpg" />

生成HTML时图像正常，而生成PDF却找不到图像。

解决的方法是在生成PDF的XSL文件中通过指定img.src.path的方式，可以让处理器相对于所生成的PDF文件的路径来查找图像。

<xsl:param name="img.src.path">Dist/pdf/</xsl:param>

加上上面的配置后，fileref的路径就会变成"Dist/pdf/images/custom/test.jpg",且是相对于所生成的PDF所在的路径。因此，只要生成的PDF文件路径符合下列条件：

Dist
|--> pdf
|--> test.pdf
|--> images
|--> custom
|--> test.jpg

生成的PDF文件就能正确地将图像加进来。

再进一步观察HTML及PDF图像所在的路径，均为

images
|--> custom
|--> test.jpg

因此，

<imagedata fileref="images/custom/test.jpg" />

总能简化为：

<imagedata fileref="test.jpg" />

当然，生成PDF的XSL文件需改为：

<xsl:param name="img.src.path">Dist/pdf/images/custom/</xsl:param>

而生成HTML的XSL文件需改为：

<xsl:param name="img.src.path">images/custom/</xsl:param>

这样，既可以简化了图像文件的引用路径，且可以确保同时适用于HTML及PDF的正确生成。