DITA and XMetaL Discussion
Derek Read November 30, 2012 at 12:39 am
Documentation: topic "specifying parameters" contains incorrect infoNovember 30, 2012 at 12:39 amParticipants 1Replies 0Last Activity 10 years, 2 months ago
XMetaL Author Enterprise 7.0 (and specifically not earlier versions)
The topic “specifying parameters” incorrectly lists some deliverables as using ANT and some use Java. The table shown in that help topic is the same one from our 6.0 release and was simply not updated. In addition, some new deliverables
With the 7.0 release of XMetaL Author Enterprise we changed our “deliverables” so that they all run the DITA Open Toolkit using ANT and not Java. This was done because ANT provides a more robust way for running the DITA OT than using Java command line parameters and using one method for all deliverables simplifies things as there is no longer any need to check if Java or ANT is being used when making modifications or specifying parameters.
If you need to specify a parameter in “Other output parameters” in XMetaL's UI (Advanced tab in Configure Output…) you can no longer use any of the Java forms documented in the DITA Open Toolkit (because Java is not used). When checking the DITA OT documentation for parameters that can be used with a specific transtype look up the parameters that are compatible with ANT. So, for example, the DITA OT we include with 7.0 is version 1.5.4 so only the parameters listed here apply (Java is on a separate page): http://dita-ot.sourceforge.net/1.5.4/readme/dita-ot_ant_properties.html
When specifying a parameter for the DITA OT the format in XMetaL Author Enterprise will now always be:
Where ANT_PARAM_ is a prefix that tells XMetaL you wish to pass a parameter to ANT.
is the name of the parameter as documented in the DITA OT documentation.
is the value you wish to pass as documented in the DITA OT documentation.
Note: ANT does differ from Java in that if you pass an invalid parameter name or value it does not care and will fail silently.
- You must be logged in to reply to this topic.