Installing on macOS via Homebrew

An alternative installation method can be used to install DITA-OT on macOS via Homebrew, the platform’s most popular open-source package manager.

Before you begin

The steps below assume you have already installed Homebrew according to the instructions at brew.sh.

Tip: Verify that your PATH environment begins with /usr/local/bin to ensure that Homebrew-installed software takes precedence over any programs of the same name elsewhere on the system.

Procedure

  1. Update Homebrew to make sure the latest package formulas are available on your system:
    $ brew update
    Already up-to-date.

    Homebrew responds with a list of any new or updated formulæ.

  2. Optional: Check the version of DITA-OT that is available from Homebrew:
    $ brew info dita-ot
    dita-ot: stable 3.3.3
    DITA Open Toolkit is an implementation of the OASIS DITA specification
    https://www.dita-ot.org/
    /usr/local/Cellar/dita-ot/3.3.3 (number of files, package size) *
      Built from source on YYYY-MM-DD at hh:mm:ss
    From: https://github.com/Homebrew/homebrew-core/blob/master/Formula/dita-ot.rb
    ==> Requirements
    Required: java >= 1.8 ✔
    

    The version of the DITA-OT formula is shown, along with basic information on the package.

  3. Install the dita-ot package:
    $ brew install dita-ot
    Downloading…

    Homebrew will automatically download the latest version of the toolkit, install it in a subfolder of the local package Cellar and symlink the dita command to /usr/local/bin/dita.

  4. Optional: Verify the installation:
    $ which dita
    /usr/local/bin/dita

    The response confirms that the system will use the Homebrew-installed version of DITA-OT.

  5. Optional: Check the DITA-OT version number:
    $ dita --version
    DITA-OT version 3.3.3
    The DITA-OT version number appears on the console.

Results

You can now run the dita command to transform DITA content.