Merge DITA Files With DITA Merge

A sophisticated approach for reliably recombining multiple DITA documents into a single file.

Analysing your DITA for dependable results

DITA Merge analyses the structure of your DITA documents so it can reliably identify all of the differences between them. Read More

Rule-based, automated merging

With its custom rules, DITA Merge allows you to consistently automate the most laborious document merging tasks. Read More

Optimised for embedding in DITA workflows

With valid DITA output and comprehensive APIs, DITA Merge integrates perfectly with your document systems. Read More

Want to try out DITA Merge today?

How does DITA Merge works?

DITA Merge recombines multiple DITA documents with their common ancestor, analysing their structure and running custom rules to either merge or explicitly mark up the differences.

Its algorithms work through each of the documents in turn, examining their structure to match up all the corresponding elements with the original.

Once it has identified all the differences, it runs custom rules against each, determining whether to merge them or mark them up in the output file as unresolved changes. Alternatively, the result can be configured so that all differences remain marked, providing an opportunity for review before any merges take place.

Managed by its API, the results are processed by a pipeline so you can transform the XML into any form is required by your systems or processes.

Rule-based merging of DITA documents

With DITA Merge you can apply custom rules to specify what is merged automatically and what is marked up for further attention.

Its sophisticated rules enable you to reference any aspect of the XML structure and attributes, to specify where conflicts may be automatically resolved and what should take priority.

Rules may reference authors and editors, specific positions within the document tree and even table elements.

Working Within Your Document Structure

Rather than comparing line-by-line, DITAMerge identifies and matches up all the elements across your DITA documents, so it has a meaningful and dependable basis for comparing and merging.

This pairing process uses a combination of element names, parent names, position in the XML tree and the structure of child elements.

Optimised Outputs For Your People And Processes

DITAMerge has been designed to make the document merge process consistent and straightforward. Any changes which cannot be merged automatically are marked up clearly in the DITA code for post processing review. Where this involves tables, a sophisticated process works out the best way of showing all the changes, while still generating a valid table.

DITAMerge outputs well-formed, valid DITA files so the resulting output is compatible with your existing DITA tools.

Full APIs for integration and embedding

DITA Merge is optimised for integration into enterprise workflow and content management systems.

All of its functionality is accessed through a Java API, which is fully documented and comes with complete, working examples.

Learn more about embedding DITA Merge into your product.

Learn More

Guaranteed complete results

If you are merging DITA documents that are significant for safety or compliance, you can be certain that DITA Merge will find and correctly process every difference.

Our comparison algorithms are guaranteed to find all the changes or differences within your content and – unless you have configured it to do otherwise – bring all of them together in the output file.

Want to try out DITA Merge today?

  • XML Merge

    For merging changes in all XML

    Learn More

Looking for something different?

If you are looking at other file formats than DITA, our other product editions may meet your needs better, including XML Merge which allows you to find and merge the differences between any type of XML files.

Need to learn more?

Take a look at our Information Hub to get you started, or our Documentation for more detailed guides:

Information Hub Product Documentation

Need help?

Contact us, we are happy to help!

Contact Us