Unable to find map.dtd while loading a ditamap

Impossible to load the ditamap root file while running the DITA-OT process in the DITA-OT Server.

Cause

There are strange issues like this when a DITA-OT has been installed on a Windows server and then copied to a Linux server:

  • The DITA-OT files contains Windows path separators (\) instead of Linux path separators (/)
  • Windows uses "line feed" plus "carriage return" characters while Unix only uses "line feed".

Remedy

Try running the bin/dita --install command on the DITA-OT in your deployment environment.

That should fix any path and line feed issues.

See: https://www.dita-ot.org/dev/topics/plugins-installing.html

Parent topic: Troubleshooting DITA-OT Server processing