通过命令行 arguments 到 Apache Ant 来自 DITAOT 自定义插件的构建文件

Question

I am trying to build a very basic custom html5 plugin for dita-ot. Below is my current setup. Here is my plugin.xml file.

plugin.xml

<plugin id="html5-test" version="3.6.1">        
    <transtype name="html5-test" desc="testing html5 transformation with current setup." >
        <param name="args.artlbl" desc="Specifies whether to generate a label for each image;" type="enum">
            <val>yes</val>
            <val default="true">no</val>
          </param>
    </transtype>
    

    <feature extension="ant.import" file="build.xml" />
</plugin>

Here is build.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:if="ant:if" xmlns:unless="ant:unless" name="dita2html5-test" default="get-parameters">
<target name="get-parameters">
    <echoproperties/>
    <!-- here I want to access CLI arguments for further use. --!>
    <echo message="print value:${args.artlbl}"/>
</target>

the console only shows text and no value. I was expecting to see "no" there as it is default value. Ultimate goal is to get CLI arguments inside transtype tag and then pass them to build.xml. After that add this to properties and then use inside ant xslt task.

Answer 1

Configuring parameter default value in plugin.xml doesn't actually set the property default value. DITA-OT only uses the information when generating documentation for plug-ins.

You have to handle the default value in the build.xml . DITA-OT built-in plug-ins use the following convention:

<project>
  <!--
  This is the enty point DITA-OT will call when running html5-test.
  In depends first call your own init target, then normal HTML5 target.
  -->
  <target name="dita2html5-test"
          depends="html5-test.init,
                   dita2html5"/>
  <target name="html5-test.init">
    <!--
    Since property values cannot be overwritten once set, this will only
    set the value if there is no value set from the command line.
    -->
    <property name="args.artlbl" value="no"/>
  </target>

</project>

Answer 2

So finally I figured it out.

dita -f html5 -i /test.dita -Done=abc

will pass "one" as a parameter to the build.xml file. In build.xml file you will access the argument by following. No changes needed in plugin.xml file.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:if="ant:if" xmlns:unless="ant:unless" name="dita2html5-test" default="get-parameters">
<target name="get-parameters">
    <echo>Embed another1:${one}</echo>
    <echo message="print value:${args.artlbl}"/>
</target>