修复Dita-OT 4.1.2自定义PDF插件依赖及覆盖失效问题

你的核心问题在于派生插件的继承关系、Ant目标依赖顺序配置错误，导致基础插件的配置优先级高于派生插件，无法被覆盖。以下是具体修正方案：

1. 修正plugin.xml的transtype继承关系 #

当前你的派生插件直接继承官方pdf transtype，跳过了基础插件的配置链路。需要改为继承基础插件定义的自定义transtype（比如基础插件的transtype名称是myPlugin-pdf，请替换为实际名称）：

<plugin id="com.example.secondary">
    <require plugin="org.dita.pdf2"/>
    <require plugin="com.example.myPlugin"/>
    <!-- 改为继承基础插件的transtype，而非官方pdf -->
    <transtype name="secondary" extends="myPlugin-pdf" desc="custom PDF based on example.myPlugin"/>
    <feature extension="dita.transtype.print" value="secondary"/>
    <feature extension="ant.import" file="integrator.xml"/>
</plugin>

2. 调整integrator.xml的Ant目标依赖顺序 #

原配置中派生插件的初始化目标先执行，但基础插件的初始化会覆盖customization.dir。需要调整依赖顺序，让派生插件的初始化在基础插件之后执行，同时强制覆盖属性：

<project>
    <!-- 先执行基础插件的初始化，再执行派生插件初始化，最后执行PDF构建 -->
    <target name="dita2secondary"
        depends="dita2myPlugin.init, dita2secondary.init, dita2pdf2"/>
    
    <target name="dita2secondary.init">
        <!-- 强制覆盖customization.dir属性 -->
        <property name="customization.dir"
            location="${dita.plugin.com.example.secondary.dir}/cfg"
            override="true"/>
    </target>
</project>

注：dita2myPlugin.init是基础插件integrator.xml中定义的初始化目标名称，请替换为基础插件实际的初始化target名。

3. 验证配置文件结构 #

确保派生插件cfg目录下要覆盖的文件（如colors.xml、page-layouts.xml）和基础插件的路径、文件名完全一致，这样DITA-OT才会用派生插件的配置覆盖基础插件的对应项。

额外排查步骤 #

• 用DITA-OT的-v参数运行转换，查看日志中customization.dir的赋值过程，确认是否被派生插件正确覆盖
• 检查基础插件的Ant配置是否有锁定customization.dir的逻辑（比如用readonly属性）

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