building-with-ant.dita 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  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
  12. <indexterm>Ant</indexterm></indexterm>
  13. <indexterm>Linux
  14. <indexterm>Ant</indexterm></indexterm>
  15. <indexterm>Windows
  16. <indexterm>Ant</indexterm></indexterm>
  17. <indexterm>Ant
  18. <indexterm>publishing with</indexterm></indexterm>
  19. </keywords>
  20. </metadata>
  21. </prolog>
  22. <taskbody>
  23. <steps>
  24. <step>
  25. <cmd conkeyref="conref-task/open-terminal"/>
  26. </step>
  27. <step>
  28. <cmd>Issue the following command:</cmd>
  29. <choicetable frame="topbot" relcolwidth="1* 3*">
  30. <chrow platform="linux mac">
  31. <choption>Linux or macOS&#xA0;</choption>
  32. <chdesc>
  33. <cmdname>bin/ant</cmdname>
  34. <option>-f</option>
  35. <codeph><varname>build-script</varname>
  36. <varname>target</varname></codeph>
  37. </chdesc>
  38. </chrow>
  39. <chrow platform="windows">
  40. <choption>Windows</choption>
  41. <chdesc>
  42. <cmdname>bin\ant</cmdname>
  43. <option>-f</option>
  44. <codeph><varname>build-script</varname>
  45. <varname>target</varname></codeph>
  46. </chdesc>
  47. </chrow>
  48. </choicetable>
  49. <info> where:
  50. <ul>
  51. <li><varname>build-script</varname> is name of the Ant build script.</li>
  52. <li><varname>target</varname> is an optional switch that specifies the name of the Ant target that you want
  53. to run.
  54. <p>If you do not specify a target, the value of the <xmlatt>default</xmlatt> attribute for the Ant project
  55. is used.</p>
  56. </li>
  57. </ul></info>
  58. </step>
  59. </steps>
  60. </taskbody>
  61. </task>