设有一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查找图像时基于以下条件进行:
- 如果是绝对路径,则按绝对路径来查找。
- 如果是相对路径,且未使用XIncludes,则按fileref指定的路径查找。
- 如果是相对路径,但使用XIncludes,且keep.relative.image.uris="1",则按fileref指定的路径查找。
- 如果是相对路径,但使用XIncludes,且keep.relative.image.uris="0",则按xml:base + fileref指定的路径查找。
因此,当使用了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
|--> 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的正确生成。