DITA to CHM Transformation Fails

Oxygen XML Developer uses the DITA Open Toolkit and the HTML Help compiler (part of the Microsoft HTML Help Workshop) to transform DITA content into Compiled HTML Help (or CHM in short).

However, the execution of the transformation scenario may still fail. Reported errors include the following:

Problem: Cannot Open File

[exec] HHC5010: Error: Cannot open "fileName.chm". Compilation stopped.

Solution: Cannot Open File

This error occurs when the CHM output file is opened and the transformation scenario cannot rewrite its content. To solve this issue, close the CHM help file and run the transformation scenario again.

Problem: Compilation Failed

[exec] HHC5003: Error: Compilation failed while compiling fileName

Solution: Compilation Failed

Possible causes of this error are:
  • The processed file does not exist. Fix the file reference before executing the transformation scenario again.
  • The processed file has a name that contains space characters. To solve the issue, remove any spacing from the file name and run the transformation scenario again.