Question

我正在研究一个从JAR文件调用函数的DITA-OT插件。当我生成XHTML时，插件会找到该函数。当我生成PDF时，它没有。我已经阅读了有关创建插件并为其提供JAR文件的DITA-OT文档，我跟踪了谷歌的一些线索，但无法弄清楚为什么会发生这种情况。

这是一个演示行为的简化示例。

这是plugin.xml：

<?xml version="1.0" encoding="UTF-8"?>
<plugin id="com.example.test.import">
  <feature extension="dita.conductor.lib.import" file="ztest.jar" />
  <feature extension="dita.xsl.xhtml"            file="testimport.xsl" />
  <feature extension="dita.xsl.xslfo"            file="testimport.xsl" />  
</plugin>

这是XSL样式表testimport.xsl：

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:z="java:ztest.Ztest"
  version="2.0" >

    <xsl:template match="concept">
        <xsl:call-template name="test" 
                           use-when="function-available('z:zmsg')">
            <xsl:with-param name="txt" 
                            select="z:zmsg()" />
        </xsl:call-template>

        <xsl:call-template name="fail" 
                           use-when="not(function-available('z:zmsg'))" />
        <xsl:apply-templates />
    </xsl:template>

    <xsl:template name="test">
        <xsl:param name="txt" />
        <xsl:message>xxx txt from function z:zmsg = <xsl:value-of select="$txt"/></xsl:message>
  </xsl:template>

  <xsl:template name="fail">
        <xsl:message>xxx Function z:zmsg is not available.</xsl:message>
  </xsl:template>

</xsl:stylesheet>

我正在使用DITA-OT 2.1.2。 DITA-OT未经修改（我的插件除外）。没有用于格式化的自定义XSL。对于DITA源代码，我正在使用DITA-OT示例目录中的文件。这是一个简单的概念主题：

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
 "../../dtd/technicalContent/dtd/concept.dtd">
<concept id="lawnmowerconcept" xml:lang="en-us">
  <title>Lawnmower</title>
  <shortdesc>The lawnmower is a machine used to cut grass in the yard.</shortdesc>
  <conbody><p>Lawnmowers can be electric, gas-powered, or manual.</p></conbody>
</concept>

我尝试使用dita命令和ant命令从命令行构建。

这是XHTML输出的dita命令：

c:\dita\dita-ot\bin>dita -i ../samples/concepts/lawnmower.xml -f xhtml -o ../samples/atest -v

这是PDF输出的dita命令：

c:\dita\dita-ot\bin>dita -i ../samples/concepts/lawnmower.xml -f pdf -o ../samples/atest -v

这是XHTML输出的ant命令：

C:\dita\dita-ot\bin>ant -f ..\build.xml -Dargs.input=samples\concepts\lawnmower.xml -Dtranstype=xhtml -Doutput.dir=samples\atest

这是PDF输出的ant命令：

C:\dita\dita-ot\bin>ant -f ..\build.xml -Dargs.input=samples\concepts\lawnmower.xml -Dtranstype=pdf -Doutput.dir=samples\atest

当transtype是xhtml时，日志中会出现“来自函数z：zmsg的txt”消息：

dita.inner.topics.html.common:
     [xslt] Transforming into c:\dita\dita-ot\samples\atest
     [xslt] Processing c:\tmp\temp20151105150253420\lawnmower.xml to c:\dita\dita-ot\samples\atest\lawnmower.html
     [xslt] Loading stylesheet c:\dita\dita-ot\plugins\org.dita.xhtml\xsl\dita2xhtml.xsl
     [xslt] xxx txt from function z:zmsg = String from Ztest.zmsg
     ...

当转换类型为pdf2时，日志中会显示“功能z：zmsg不可用”消息：

transform.topic2fo.main:
     [xslt] Processing c:\tmp\temp20151105143733996\stage1a.xml to c:\tmp\temp20151105143733996\stage2.fo
     [xslt] Loading stylesheet c:\dita\dita-ot\plugins\org.dita.pdf2\xsl\fo\topic2fo_shell_fop.xsl
     [xslt] xxx Function z:zmsg is not available.
     ...

最后，这是Ztest类的Java源代码和zmsg（）函数：

package ztest;
public class Ztest {
    public static void main(String[] args) {
        System.out.println(zmsg());
    }    
    public static String zmsg() {
        return "String from Ztest.zmsg";
    }
}

在此示例中，转换未成功完成，但它确实会在找到函数时显示消息但未找到。

当transtype = PDF时，DITA-OT插件找不到JAR文件功能

0 个答案: