Running The Open Toolkit

You can use a DITA Open Toolkit Docker container from the command line just like the normal Open Toolkit.

To run the Open Toolkit container you need to connect the directory containing the DITA source to be processed to the container and then specify the command-line parameters to the Open Toolkit's dita command (OT 2.x) or ant command (OT 2.x or 1.x). When you run the container you are simply running the normal Open Toolkit inside the container's Linux environment. All you need to know is how to specify the location of the input files.

By default, the Docker machine automatically shares the /Users directory from the host machine with the Docker machine. This means your home directory is always available for mounting read/write to any Docker container.

You connect host directories to container volumes using the -v parameter to the docker run command:

$ docker run -v /Users/ekimber/workspace:/opt/dita-ot/data ditaot/dita-ot \
  dita -i /opt/dita-ot/data/pub-01/pub-01.ditamap \
  -f html5 \
  -o /opt/data-ot/data/pub-01/out/html5

Under Windows you use /c/Users/... (assuming your Users directory is on the c: drive):

C:\Users\ekimber>docker run /c/Users/ekimber/workspace:/opt/dita-ot/data ditaot/dita-ot \
  dita -v -i /opt/dita-ot/data/pub-01/pub-01.ditamap  \
  -o /opt/dita-ot/data/pub-01/out/html5 -f html5

After running the commands the output will be in the /Users/ekimber/workspace/pub-01/out/html5 directory.

By default the dita command does not produce any messages. If you want to see the messages add the -v parameter to the dita command. If you want to capture the log use the -l parameter and specify the log file:

C:\Users\ekimber>docker run -v /c/Users/ekimber/workspace:/opt/dita-ot/data ditaot/dita-ot \
  dita -i /opt/dita-ot/data/pub-01/pub-01.ditamap  \
  -o /opt/dita-ot/data/pub-01/out/html5 -f html5 \
  -l /opt/dita-ot/data/pub-01/logs/html5.log