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文件就能正确地将图像加进来。

[

注：计算PDF图像的完整公式是：${img.src.path} + ${xml:base} + ${rev_path} + ${fileref}

上例中，

${img.src.path} = Dist/pdf/

${xml:base} = "./"，在计算路径时，”./“将被忽略

${rev_path} = 含有imagedata标签的XML文档相对于主干XML文档的路径。如：

a.xml是主干文档，其中有：

<xi:include href="chapters/b.xml" />

b.xml文档位于chapters文件夹中，且有：

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

则${rev_path} = chapters/

由于这个例子没有给出这种特殊情况，因此${rev_path}为空字符串，也将被忽略。

${fileref} = images/custom/test.jpg

因此，上例的结果是${img.src.path} + ${xml:base} + ${rev_path} + ${fileref} = "Dist/pdf/" + "" + "" + "images/custom/test.jpg" = "Dist/pdf/images/custom/test.jpg" 

]

再进一步观察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的正确生成。