installing-client.dita 2.6 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="installing-client" xml:lang="en-US">
  5. <title>Installing DITA Open Toolkit</title>
  6. <titlealts>
  7. <navtitle>Installing DITA-OT</navtitle>
  8. </titlealts>
  9. <shortdesc id="what-is-client">The DITA-OT distribution package can be installed on Linux, macOS, and Windows. It
  10. contains everything that you need to run the toolkit except for Java.</shortdesc>
  11. <prolog>
  12. <metadata>
  13. <keywords>
  14. <indexterm>macOS
  15. <indexterm>installing DITA-OT</indexterm></indexterm>
  16. <indexterm>Linux
  17. <indexterm>installing DITA-OT</indexterm></indexterm>
  18. <indexterm>Windows
  19. <indexterm>installing DITA-OT</indexterm></indexterm>
  20. <indexterm><cmdname>dita</cmdname> command
  21. <indexterm>installing</indexterm></indexterm>
  22. <indexterm>installing
  23. <indexterm>DITA-OT</indexterm></indexterm>
  24. <indexterm>Java
  25. <indexterm>Java Development Kit (JDK)</indexterm>
  26. <indexterm>Java Runtime Environment (JRE)</indexterm></indexterm>
  27. </keywords>
  28. </metadata>
  29. </prolog>
  30. <taskbody>
  31. <prereq>
  32. <ul>
  33. <li>
  34. <p>Ensure that you have a Java Runtime Environment (JRE) or Java Development Kit (JDK).</p>
  35. <p conkeyref="reusable-components/java-clients"/></li>
  36. <li importance="optional" platform="windows">If you want to generate HTML Help, ensure that you have HTML Help
  37. Workshop installed.
  38. <p>You can download the Help Workshop from
  39. <xref keyref="download.html-help-workshop"/>.</p></li>
  40. </ul>
  41. </prereq>
  42. <steps>
  43. <step>
  44. <cmd><ph conkeyref="conref-task/download-ot"/></cmd>
  45. </step>
  46. <step>
  47. <cmd>Extract the contents of the package to the directory where you want to install DITA-OT.</cmd>
  48. </step>
  49. <step importance="optional">
  50. <cmd>Add the absolute path for the <filepath>bin</filepath> directory to the <varname>PATH</varname> system
  51. variable.</cmd>
  52. <stepresult>
  53. <p>This defines the necessary environment variable to run the <cmdname>dita</cmdname> command from the command
  54. line.</p>
  55. <note type="tip">This step is recommended, as it allows the <cmdname>dita</cmdname> command to be run from any
  56. location on the file system and makes it easier to transform DITA content from any folder.</note>
  57. </stepresult>
  58. </step>
  59. </steps>
  60. </taskbody>
  61. </task>