Running Your First DocBook Comparison

DocBook Compare provides the necessary toolkit to compare two valid DocBook files and produce a valid DocBook output with mark up to represent the changes.

For a conceptual introduction to DocBook Compare see DocBook Comparison .

Finding Further Information on DocBook

java -jar deltanova-year.x.y.z.jar describe docbook

Running a DocBook Comparison via the Command Line

Bash

java -jar deltanova-year.x.y.z.jar compare docbook input1.xml input2.xml result.xml config.xml[optional]

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/docbook/. Associate it with the XSD to enable XML editor autocompletion.

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

Key Constraint: Same DocBook type only

Only documents of the same type can be compared. DocBook 4 and DocBook 5 documents (using the DocBook namespace) cannot be compared against each other.

Bundled Schemas

The distribution includes OASIS DocBook DTDs, XML Schema, and RelaxNG Schema for DocBook 4.3, 4.4, 4.5, and 5.0, along with the Apache XML Commons Resolver for local DTD resolution.