Startseite Erkunden Hilfe
Anmelden
bn
/
se
2
0
Fork 0
Dateien Issues 0 Pull-Requests 0 Wiki
Struktur: c8927bb461
Branches Tags
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.5
/
doc
/
topics
/
installing-via-homebrew.html

installing-via-homebrew.html 7.6 KB
Verlauf Originalformat

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2020"><meta name="DC.rights.owner" content="(C) Copyright 2020"><meta name="DC.type" content="task"><meta name="description" content="An alternative installation method can be used to install DITA-OT on macOS via Homebrew, the platform’s most popular open-source package manager."><meta name="DC.subject" content="macOS, command, dita, Homebrew, installing"><meta name="keywords" content="macOS, command, dita, Homebrew, installing"><meta name="DC.relation" scheme="URI" content="../topics/installing-client.html"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="installing-via-homebrew"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Installing on macOS via Homebrew</title></head><body id="installing-via-homebrew"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.5</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a><ul><li><a href="../topics/prerequisite-software.html">Prerequisite software</a></li><li><a href="../topics/determining-version-of-ditaot.html">Checking the version</a></li><li><a href="../topics/first-build-using-dita-command.html">Building output</a></li><li class="active"><a href="../topics/installing-via-homebrew.html">Installing via Homebrew</a></li></ul></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../topics/input-formats.html">Authoring formats</a></li><li><a href="../topics/output-formats.html">Output formats</a></li><li><a href="../parameters/index.html">Parameters</a></li><li><a href="../topics/html-customization.html">Customizing HTML</a></li><li><a href="../topics/pdf-customization.html">Customizing PDF</a></li><li><a href="../topics/adding-plugins.html">Adding plug-ins</a></li><li><a href="../topics/custom-plugins.html">Creating plug-ins</a></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Installing on macOS via Homebrew</h1>
    8. 

  8.   
    9. 

  9.   
    10. 

  10.   
    11. 

  11.   <div class="body taskbody"><p class="shortdesc">An alternative installation method can be used to install DITA-OT on macOS via
    12. 

  12.     <a class="xref" href="https://brew.sh" target="_blank" rel="external noopener">Homebrew</a>, the platform’s most popular open-source package manager.</p>
    13. 

  13.     <section class="section prereq"><div class="tasklabel"><h2 class="sectiontitle tasklabel">Before you begin</h2></div>
    14. 

  14.       <p class="p">The steps below assume you have already installed
    15. 

  15.         <a class="xref" href="https://brew.sh" target="_blank" rel="external noopener">Homebrew</a> according to the instructions at
    16. 

  16.         <a class="xref" href="https://brew.sh" target="_blank" rel="external noopener">brew.sh</a>.</p>
    17. 

  17.       <div class="note tip note_tip"><span class="note__title">Tip:</span> Verify that your <var class="keyword varname">PATH</var> environment begins with
    18. 

  18.           <span class="ph filepath">/usr/local/bin</span> to ensure that Homebrew-installed software takes precedence over any
    19. 

  19.         programs of the same name elsewhere on the system.</div>
    20. 

  20.     </section>
    21. 

  21.     <section><div class="tasklabel"><h2 class="sectiontitle tasklabel">Procedure</h2></div><ol class="ol steps"><li class="li step stepexpand">
    22. 

  22.         <span class="ph cmd">Update Homebrew to make sure the latest package formulas are available on your system:</span>
    23. 

  23.         <div class="itemgroup stepxmp"><pre class="pre codeblock"><code>$ <span class="keyword cmdname">brew update</span>
    24. 

  24. Already up-to-date.</code></pre></div>
    25. 

  25.         <div class="itemgroup stepresult">
    26. 

  26.           <p class="p">Homebrew responds with a list of any new or updated formulæ.</p></div>
    27. 

  27.       </li><li class="li step stepexpand"><strong>Optional: </strong>
    28. 

  28.         <span class="ph cmd">Check the version of DITA-OT that is available from Homebrew:</span>
    29. 

  29.         <div class="itemgroup stepxmp"><pre class="pre codeblock"><code>$ <span class="keyword cmdname">brew info dita-ot</span>
    30. 

  30. <samp class="ph systemoutput sysout">dita-ot: stable <span class="keyword">3.5</span>
    31. 

  31. DITA Open Toolkit is an implementation of the OASIS DITA specification
    32. 

  32. https://www.dita-ot.org/
    33. 

  33. /usr/local/Cellar/dita-ot/<span class="keyword">3.5</span> (<var class="keyword varname">number of files</var>, <var class="keyword varname">package size</var>) *
    34. 

  34.   Built from source on <var class="keyword varname">YYYY-MM-DD</var> at <var class="keyword varname">hh:mm:ss</var>
    35. 

  35. From: https://github.com/Homebrew/homebrew-core/blob/master/Formula/dita-ot.rb
    36. 

  36. ==&gt; Requirements
    37. 

  37. Required: java &gt;= 1.8 ✔</samp>
    38. 

  38. </code></pre></div>
    39. 

  39.         <div class="itemgroup stepresult">
    40. 

  40.           <p class="p">The version of the DITA-OT formula is shown, along with basic information on the package.</p></div>
    41. 

  41.       </li><li class="li step stepexpand">
    42. 

  42.         <span class="ph cmd">Install the <code class="ph codeph">dita-ot</code> package:</span>
    43. 

  43.         <div class="itemgroup stepxmp"><pre class="pre codeblock"><code>$ <span class="keyword cmdname">brew install dita-ot</span>
    44. 

  44. <samp class="ph systemoutput sysout">Downloading…</samp></code></pre></div>
    45. 

  45.         <div class="itemgroup stepresult">
    46. 

  46.           <p class="p">Homebrew will automatically download the latest version of the toolkit, install it in a subfolder of the
    47. 

  47.             local package Cellar and symlink the <span class="keyword cmdname">dita</span> command to
    48. 

  48.               <span class="ph filepath">/usr/local/bin/dita</span>.</p></div>
    49. 

  49.       </li><li class="li step stepexpand"><strong>Optional: </strong>
    50. 

  50.         <span class="ph cmd">Verify the installation:</span>
    51. 

  51.         <div class="itemgroup stepxmp"><pre class="pre codeblock"><code>$ <span class="keyword cmdname">which dita</span>
    52. 

  52. <samp class="ph systemoutput sysout">/usr/local/bin/dita</samp></code></pre></div>
    53. 

  53.         <div class="itemgroup stepresult">
    54. 

  54.           <p class="p">The response confirms that the system will use the Homebrew-installed version of DITA-OT.</p></div>
    55. 

  55.       </li><li class="li step stepexpand"><strong>Optional: </strong>
    56. 

  56.         <span class="ph cmd">Check the DITA-OT version number:</span>
    57. 

  57.         <div class="itemgroup stepxmp"><pre class="pre codeblock"><code>$ <span class="keyword cmdname">dita</span> <span class="keyword parmname">--version</span>
    58. 

  58. <samp class="ph systemoutput sysout">DITA-OT version <span class="keyword">3.5</span></samp></code></pre></div>
    59. 

  59.         <div class="itemgroup stepresult">The DITA-OT version number appears on the console.</div>
    60. 

  60.       </li></ol></section>
    61. 

  61.     <section class="section result"><div class="tasklabel"><h2 class="sectiontitle tasklabel">Results</h2></div>
    62. 

  62.       <p class="p">You can now run the <span class="keyword cmdname">dita</span> command to transform DITA content.</p></section>
    63. 

  63.   </div>
    64. 

  64. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/installing-client.html" title="The DITA-OT distribution package can be installed on Linux, macOS, and Windows. It contains everything that you need to run the toolkit except for Java.">Installing DITA Open Toolkit</a></div></div></nav></article></main></body></html>
    65.