DITA to CHM Transformation Fails

Oxygen XML Author plugin 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).

It is a good practice to validate the DITA map before executing the transformation scenario. To do so, run the Validate and Check for Completeness action. Depending on the selected options, this action reports errors, such as topics referenced in other topics (but not in the DITA map), broken links, and missing external resources.

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

• [exec] HHC5010: Error: Cannot open "fileName.chm". Compilation stopped. - 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.
• [exec] HHC5003: Error: Compilation failed while compiling fileName - 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.