fo:external-graphic 模板文件中带有参数

Question

我正在尝试一些直截了当的东西，我想说不要太复杂。但我不知道该怎么做：我想在 XSL-FO 文档中包含图像。

详细说明：

我有两个文件，一个包含我的文本的逻辑内容，另一个在逻辑上包含格式说明。我正在使用 Apache 应用程序 fop 将其编译成 PDF：

fop -q -xml contents.xml -xsl formatting.xsl -pdf output.pdf

这适用于纯文本。文件contents.xml 包含如下内容：

<part>
  Lorem ipsum bla
</part>

文件formatting.xsl 包含如下内容：

<xsl:stylesheet ...>
  <xsl:template match="part">
    <fo:block ...>
      <xsl:apply-templates/>
    </fo:block>
  </xsl:template>
</xsl:stylesheet>

现在我想添加一些图像。因为它将有许多图像都具有相似的格式，所以我想为contents.xml 中的每个图像提供一个简单的抽象事物，将参数传递给模板。例如。 <img path="path/to/my/image.png"/> 可以，但<img>path/to/my/image.png</img> 甚至<img><path value="path/to/my/image.png"/></img> 之类的也可以。

formatting.xsl中的模板应理解并使用传入的参数，并将其放在<fo:external-graphic src="[parameter-value]"\>中。

另外，我需要能够提供几种格式文件之一，以便为相同内容但具有不同格式的不同 PDF（例如，平装本、精装本和相同内容的手稿版本）。

但是到目前为止我所有的试验都失败了。我唯一能做到的就是没有传递参数的解决方案，因此图像的路径被硬编码在格式化文件中。

我用<xsl:call-template>、<xsl:with-param> 和<xsl:attribute name="src"> 等尝试了很多变体，但到目前为止没有任何效果。 fop 抱怨使用错误或结果未在 PDF 中显示图像。

我觉得这一定是许多人想做的非常简单和典型的事情，但我仍然没有找到任何实现类似我的案例的示例。

谁能给我一个例子来说明如何做到这一点？

编辑：

我在contents.xml 中最喜欢的用法是<img path="img/001_title.png"/>，但在formatting.xsl 中，我不知道如何制定我的模板来完成这项工作。没有参数path 我可以使用这个：

<xsl:template match="img">
  <fo:block>
    <fo:external-graphic src="img/001_title.png"/>
  </fo:block>
</xsl:template>

但正如我已经写过的，这会对路径进行硬编码，并且不能重复使用以插入具有另一条路径的另一张图片。

我也尝试过，例如这个在formatting.xsl:

<xsl:template match="img">
  <xsl:param name="path"/>
  <fo:block>
    <fo:external-graphic src="$path"/>
  </fo:block>
</xsl:template>

但随后在contents.xml 中传递我应该使用的参数值

<xsl:call-template name="img">
  <xsl:with-param name="path" select="img/001_title.png"/>
</xsl:call-template>

这给我带来了来自fop 的错误，指出xsl 的东西在我使用它的contents.xml 的地方是非法的。

此外，上述模板中参数的 use 可能不是应有的那样，因为我认为这需要像 using <xsl:value-of select="$path"/> 或类似的东西，但我没有'如果该值应该在属性的双引号内使用，则不知道该怎么做。

为此，似乎语法

<fo:external-graphic>
  <xsl:attribute name="src">
    <xsl:value-of select="$path"/>
  </xsl:attribute>
</fo:external-graphic>

应该被使用。但我也无法使用它，因为我也不清楚如何从contents.xml 文件中使用它。

Answer 1

您的 content.xml 会不会包含以下内容：

<contents>
<part>
  Lorem ipsum bla
</part>
<img path="img/001_title.png"/>
<part>
  Lorem ipsum bla
</part>
<img path="img/002_title.png"/>
</contents>

然后在您的 XSL 中使用：

<xsl:template match="img">
<fo:external-graphic>
  <xsl:attribute name="src">
    <xsl:value-of select="@path"/>
  </xsl:attribute>
</fo:external-graphic>
</xsl:template>

您的 XML 可以包含带有路径的图像，它们可以指向任何地方，当 XSL 遇到一个时，它会在 XSL FO 中输出它。该模板直接使用 XML 中 img 标记的 @path 属性。

那么任何类型的路径都可以工作：

<img path="relative/to/something.png"/>
<img path="http://mywebsite.com/logo.png"/>
<img path="http://mywebsite.com/mycode.php?getimage='123242'"/>