DITA-OT 4.0.1转DOCX遇DOTA015F错误，如何修复？

问题原因 #

DITA-OT 4.x版本强化了内部属性的访问限制，preprocess.copy-html.skip属于内部私有属性，从4.0开始禁止直接设置。而3.7.4及更早版本未做此限制，因此旧版本无报错。官方要求使用公开属性build-step.copy-html来替代控制该步骤的执行。

修复方法 #

根据属性设置的来源，对应以下修复方式：

• 自定义配置文件（如build.xml、.properties）：
  将所有直接设置preprocess.copy-html.skip的代码替换为build-step.copy-html，设置值为skip即可跳过该步骤。
  示例修改：
  原配置：

  <property name="preprocess.copy-html.skip" value="true"/>
  

  修改后：

  <property name="build-step.copy-html" value="skip"/>
  

• com.elovirta.ooxml插件适配问题：
  检查插件版本是否兼容DITA-OT 4.x，若插件未更新，可尝试：

  1. 升级插件至最新兼容版本；
  2. 手动修改插件内部配置文件，将所有preprocess.copy-html.skip替换为build-step.copy-html=skip。

• 命令行参数传递：
  如果转换命令中通过-D参数设置了该属性，替换参数：
  原参数：-Dpreprocess.copy-html.skip=true
  修改后：-Dbuild-step.copy-html=skip

验证 #

修改完成后，重新执行转换命令：

dita --input=phase.ditamap --format=docx

即可正常完成DOCX转换。

内容的提问来源于stack exchange，提问作者donHenaro