installing-client.dita 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  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.md file for applicable licenses.-->
  4. <task id="installing-client" xml:lang="en-US">
  5. <title>Installing the distribution package</title>
  6. <titlealts>
  7. <navtitle>Installing the toolkit</navtitle>
  8. </titlealts>
  9. <shortdesc id="what-is-client">The DITA-OT distribution package can be installed on Linux, Mac OS&#xA0;X, and Windows.
  10. It contains everything that you need to run the toolkit except for Java.</shortdesc>
  11. <taskbody>
  12. <prereq>
  13. <ul>
  14. <li>Ensure that you have Java JRE or JDK, version <keyword keyref="tool.java.version"/> or later installed.
  15. <p>You can download the Oracle JRE or JDK from <xref keyref="download.oracle-jdk"/>.</p></li>
  16. <li importance="optional" platform="windows">If you want to generate HTML Help, ensure that you have HTML Help
  17. Workshop installed.
  18. <p>You can download the Help Workshop from <xref keyref="download.html-help-workshop"/>.</p></li>
  19. </ul>
  20. </prereq>
  21. <steps>
  22. <step>
  23. <cmd>Download the <filepath>dita-ot-<keyword keyref="maintenance-version"/>.zip</filepath> package from the
  24. project website at <xref keyref="download.dita-ot.current-release">www.dita-ot.org</xref>.</cmd>
  25. </step>
  26. <step>
  27. <cmd>Extract the contents of the package to the directory where you want to install the DITA-OT.</cmd>
  28. </step>
  29. <step importance="optional">
  30. <cmd>Add the absolute path for the <filepath>bin</filepath> directory to the <varname>PATH</varname> system
  31. variable.</cmd>
  32. <stepresult>
  33. <p>This defines the necessary environment variable to run the <cmdname>dita</cmdname> command from the command
  34. line.</p>
  35. <note type="tip">This step is recommended, as it allows the the <cmdname>dita</cmdname> command to be run from
  36. any location on the file system and makes it easier to transform DITA content from any folder.</note>
  37. </stepresult>
  38. </step>
  39. </steps>
  40. </taskbody>
  41. </task>