D4ST DITA Open Toolkit Docker Container
The d4st/dita-ot container provides a generic DITA Open Toolkit image.
The dita-ot container contains a DITA Open Toolkit image based on the full DITA for Publishers plugin set. You can use it directly if you don't need any custom plugins. You can use any of the Open Toolkit containers or create your own custom one if you want a different set of plugins. All the DITA OT, DITA Community, and DITA for Publishers containers expose the same volumes you can you use them interchangably with the GitLab and Link Manager containers. See the documentation for the DITA Community Open Toolkit Docker container project (TBD).
The Open Toolkit container is required by the D4ST Link Manager BaseX Docker Container container, which uses its catalogs. It is also required by the D4ST GitLab Docker Container container, which uses it for running Open Toolkit build jobs.
Container Details
- URL
- https://hub.docker.com/r/d4st/dita-ot
- container name
- d4st/dita-ot
The latest version reflects the latest DITA Open Toolkit release. Containers for other versions use the OT version number as the tag, e.g. "d4st/dita-ot:1.8.5".
Usage
The container needs to be run and then not removed so that other containers can access its volumes. If you mount a local directory to the container's /opt/dita-ot/userdata volume, you can use the container to run the Open Toolkit against files on your local file system.
The container also provides the entire Toolkit as the volume /opt/dita-ot/DITA-OT. Other containers can use this volume in order to have direct access to the open toolkit.
run --name=dita-ot d4st/dita-ot
- --name=dita-ot
- The name for the container. You can specify anything. Having set the name you can use it anywhere a container ID is expected, e.g. docker exec -it dita-ot /bin/bash.
run --name=dita-ot -v /Users/ekimber/workspace:/opt/dita-ot/userdata /d4st/dita-ot
- -v ...
- Connects a local directory (/Users/ekimber/workspace) to the /opt/dita-ot/userdata volume in the container. Under OS X and Windows the local directory must be within a user's home directory. Under Linux it can be any directory. CAUTION:
If you don't specify a local directory then the databases will be created within the container and will go away when the container is removed.
- d4st/dita-ot
- This is the name of the container to run. If the container is not already on your system Docker will pull it down from the Docker hub, using the default tag "latest", which is normally what you want. If you want a specific tag you can specify it as :tagname after the container name. Note that the latest version will reflect the 2.x version of the Open Toolkit. Other versions use the Open Toolkit version number as the tag, e.g., "d4st/dita-ot:1.8.5".
If you need to update your local copy you can use docker pull d4st/dita-ot to get the latest version.
Configuration Details
This image is a generic Open Toolkit exactly as distributed by the Open Toolkit project.