This sample compares two DITA topic files
in2.dita. Please read the content of the DITA markup result (
results/dita-markup.dita) as it is designed to illustrate several of our DITA comparison product's features.
The sample uses either .NET or Java versions of DITA Compare, according to the version downloaded. Samples for both platforms are covered here.
The result of this comparison depends on the selected output format, as discussed in the Output Formats Section of the Reference and summarized in the table below.
|dita-markup||Mark changes using DITA's rev and status attributes.|
|arbortext-tcs||Mark changes using the Arbortext editor's tracked changes format.|
|framemaker-tcs||Mark changes using the FrameMaker editor's tracked changes format.|
|oxygen-tcs||Mark changes using the oXygen tracked changes format.|
|xmetal-tcs||Mark changes using the XMetaL tracked changes format.|
The sample scripts also set two parameters to preserve the lexical formatting of the source document.
Using Apache Ant
The sample comparison can be run via an Apache Ant build script using the following commands.
|Run all four comparisons. Default ant target.|
|Run the DITA Markup comparison.|
|Run the Arbortext tracked changes comparison.|
|Run the FrameMaker tracked changes comparison.|
|Run the oXygen tracked changes comparison.|
|Run the XMetaL tracked changes comparison.|
|Remove the generate output.|
The output of these commands are put into the
From the Command Line
The sample can be run directly by issuing the following command
dita-markup format enumeration can be replaced by one of the tracked changes format enumerations.
- When running the command from a Windows operating system command shell the forward slashes (/) need to be replaced by backslashes (\).
Using a Batch File
rundemo.bat batch file either by entering
rundemo from the command line or by double-clicking on this file from Windows Explorer. This script runs the same comparison 5 times, once for each output format. The output destination is a freshly created results directory.
From the Command Line
The sample comparison can also be run from the command line, using the following: