Running Your First DITA Comparison

DITA Compare enables you to compare DITA files in 3 different ways including Topic compare, Map compare, and a full Map TopicSet compare, where the results can be integrated into your change management systems. DITA Compare provides the necessary tools for extensible DITA comparison to suit any of your needs.

For a conceptual introduction to DITA Compare see DITA Comparison .

Running Your First DITA Comparison

Pipeline Details

Bash

java -jar deltanova-year.x.y.z.jar compare topic input1.dita input2.dita output.dita config.xml[optional]

Topic Comparison (Compare Individual Topics)

Bash

java -jar deltanova-year.x.y.z.jar compare topic input1.dita input2.dita output.dita config.xml[optional]

Map Topicset Comparison (Compare Maps and all topics referenced by both maps)

Bash

java -jar deltanova-year.x.y.z.jar compare mts input1.xml input2.xml outDir config.xml[optional] 
java -jar deltanova-year.x.y.z.jar compare mts input1.xml input2.xml inplace config.xml[optional]

Map File Comparison (Compare Maps Without Checking All Reference Topics):

Bash

java -jar deltanova-year.x.y.z.jar compare mapfile input1.ditamap input2.ditamap output.ditamap config.xml[optional]

For details on the command-line interface see Using the Java Command Line Tool .

Writing a Config File

The configuration file is validated against the XML Schema included in the product distribution in the relevant samples directory e.g. samples/compare/dita/. Associate it with the XSD to enable XML editor autocompletion.

<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="com.deltaxml.dita.config"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:noNamespaceSchemaLocation="dita-configuration.xsd">
  <parameters>
    <!-- configuration elements here -->
  </parameters>
</configuration>