building-with-ant.dita 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <task id="runant" xml:lang="en">
  5. <title>Building output using Ant</title>
  6. <shortdesc>You can build output by using an Ant build script to provide the DITA-OT parameters.</shortdesc>
  7. <prolog>
  8. <metadata>
  9. <keywords>
  10. <indexterm><xmlatt>default</xmlatt></indexterm>
  11. <indexterm>macOS<indexterm>Ant</indexterm></indexterm>
  12. <indexterm>Linux<indexterm>Ant</indexterm></indexterm>
  13. <indexterm>Windows<indexterm>Ant</indexterm></indexterm>
  14. <indexterm>Ant<indexterm>publishing with</indexterm></indexterm>
  15. </keywords>
  16. </metadata>
  17. </prolog>
  18. <taskbody>
  19. <steps>
  20. <step>
  21. <cmd conref="../resources/conref-task.dita#ID/open-terminal"/>
  22. </step>
  23. <step>
  24. <cmd>Issue the following command:</cmd>
  25. <choicetable frame="topbot" relcolwidth="1* 3*">
  26. <chrow platform="linux mac">
  27. <choption>Linux or macOS&#xA0;</choption>
  28. <chdesc>
  29. <cmdname>bin/ant</cmdname>
  30. <option>-f</option>
  31. <codeph><varname>build-script</varname>
  32. <varname>target</varname></codeph>
  33. </chdesc>
  34. </chrow>
  35. <chrow platform="windows">
  36. <choption>Windows</choption>
  37. <chdesc>
  38. <cmdname>bin\ant</cmdname>
  39. <option>-f</option>
  40. <codeph><varname>build-script</varname>
  41. <varname>target</varname></codeph>
  42. </chdesc>
  43. </chrow>
  44. </choicetable>
  45. <info> where:
  46. <ul>
  47. <li><varname>build-script</varname> is name of the Ant build script.</li>
  48. <li><varname>target</varname> is an optional switch that specifies the name of the Ant target that you want
  49. to run. <p>If you do not specify a target, the value of the <xmlatt>default</xmlatt> attribute for the Ant
  50. project is used.</p>
  51. </li>
  52. </ul></info>
  53. </step>
  54. </steps>
  55. </taskbody>
  56. </task>