DeltaNova User Journey

• DeltaNova Release Notes

Stage 1: Discover

You are evaluating DeltaNova for the first time and need to understand what it is, what it can do, and whether it fits your needs.

Product Overview

• DeltaNova Product Overview

• Compare Overview

  • Document Comparison

  • Data Comparison

  • Grammar-specific Comparison

    • DITA Comparison

    • DocBook Comparison

    • HTML Comparison

• Merge Overview

• Check Overview

• Unstructured Comparison Overview

• Integration APIs and Systems Overview

Stage 2: Install and Set Up

You have decided to use DeltaNova and need to install it, activate a license, and verify it is working.

Install the Product

• Getting Started with DeltaNova

Licensing

• Licensing Overview

  • Licensing Models

  • Managing Licenses on MyDeltaPortal

    • How to Determine a License Server Host ID

    • How to View and Activate your licenses

    • Editing the License File

    • Setting Up and Configuring FlexNet License Server on Windows and Linux

    • How to Set Up Client Systems to Use a Concurrent (Network) License Server

    • How to Move a License Between Servers

    • How to Renew a License

  • License Server Configuration Reference

First Run Verification

• Using the Java Command Line Tool

  • Running Your First XML Comparison

  • Running Your First DocBook Comparison

  • Running Your First DITA Comparison

  • Running Your First PDF Comparison

  • Running Your First Word Comparison

  • Running Your First PowerPoint Comparison

  • Running Your First Merge

  • Running Your First Conversion Check

Environment Configuration

• Setting Up Configuration Properties

Stage 3: Learn

You want to understand how DeltaNova works before writing any code or configuring pipelines.

Core Concepts

• Comparison Pipeline Architecture

• DCP, DTCP, and DXP Samples

• Output Formats Overview

• Delta Output Format Overview

• Delta Output Merge Format

• Overlapping Hierarchies in Delta Output

Comparison Behaviour Concepts

• Whitespace Handling Concepts

• Lexical Preservation Concepts

• Multithreading with the Java API

HTML Comparison Concepts

• HTML Compare Concepts

DITA Comparison Concepts

• How are DITA Comparisons Performed?

• Types of DITA Comparison

• Map Processing in DITA Compare

• Displaying Changes in a DITA Comparison

DocBook Comparison Concepts

• DocBook Comparison Concepts

Unstructured Comparison Concepts

• DeltaNova Word Comparison

• DeltaNova PowerPoint Comparison

  • How to Use DeltaNova PowerPoint Comparison

• PDF Comparison

Merge Concepts

• Concurrent Merge Concepts

• Sequential Merge Concepts

• Three-to-two Merge Concepts

• Merge Result Formats and Types

• Simplified Merge Format

Check Concepts

• Check Features

• Check Change Report Overview

Stage 4: Perform Basic Configurations

You are ready to run comparisons, merges, and conversion checks, and need step-by-step guidance on the different modes.

General Comparison Configuration

• Comparator Type Reference

• Ignoring Changes in a Comparison

• Setting Numeric Tolerances

Element Order and Structure

• Subtree Processing Mode Overview

• Configuring Mixed Ordered and Orderless Data

• Using Keys with Ordered Data

• Detecting and Handling Moves

• Comparing Orderless Elements

• Formatting Element Changes

Text Comparison Tasks

• Running a Word-by-word Text Comparison

• Running a Case-insensitive Comparison

XML Constructs and Markup

• Preserving doctype Information

• Preserving Processing Instructions and Comments

• Preserving Entity References

• Splitting Attributes

Specialised Content Comparisons

• Comparing Large Files

• Comparing MathML

• Comparing XML Schema

Working with Comparison Outputs

• Creating a Merged Document

• Folding DiffReport with DCP

• Using Deltas for XML Versioning

Stage 5: Perform Advanced Configurations

You need to customise comparison, merge, or check behaviour to match their specific content, data structures, or quality requirements.

• Running a Character-by-character Comparison

Whitespace and Lexical Configuration

• Enabling Enhanced Whitespace Handling

Table and Structured Content Configuration

• Configuring HTML Table Processing

• Configuring CALS Table Processing

Specialized Content Comparison

• Image Comparison

• SVG Comparison

• Comparing DocBook Documents

  • How to Compare DocBook

• Comparing HTML Documents

• Comparing DITA Topics and Maps

  • Case Sensitivity of Hrefs/URIs

  • MathML Comparison in DITA Topics

  • Attribute Change Handling in DITA Compare

  • Lexical Preservation in DITA Comparison: Preserving Entities, DTDs, CDATA, PIs and Comments

  • Element Moves in DITA Comparison

  • Image Comparison in DITA Compare

  • Output Formats in DITA Comparison

  • Styling Changes with CSS in Oxygen Editor

  • Publishing with DITA Open Toolkit

Merge Configuration

• Merge Formatting Element Representations

  • Merge Formatting Elements Sample

  • Merge Formatting Elements with Rule Processing Sample

• Rule-based Processing Concepts

• Merging Tables

• Three-to-two Merge Use Cases

Check Configuration

• Check Input Types

• Ignore Elements with Check

Stage 6: Integrate

You are embedding DeltaNova into an application, build system, or server environment.

Java API integration

• Generic XML Comparison

• Grammar-specific Comparisons

• Unstructured Comparisons

• Merge

• Check

• Using XOM

• Using W3C DOM Documents

• Using a Catalog Resolver

• Enabling Xerces Support

• Using XInclude with DeltaNova

• Enabling Input Multithreading

REST API Integration

• Installing and Setting Up DeltaNova REST On-Premise

• Testing Using Postman

• Testing Using Command Line Driver

• Pipelines and Discovery

• Specifying Comparisons

  • XML Comparisons

  • DocBook Comparisons

  • DITA Comparisons

    • Topic Comparison

    • Map Topicset Comparison

  • HTML Comparisons

  • Merge Requests

  • Check Operations

  • Microsoft Word Comparisons

  • Microsoft PowerPoint Comparisons

  • PDF Comparisons

• Configuration Files

• Asynchronous Comparison

• I/O Types

• Shutdown

• Errors

Merge Version Control Integration

• Merge Integration with Mercurial

• Merge Integration with Git

Stage 7: Extend

You want to write custom filters, build advanced pipelines, integrate with version control systems, or tailor the engine to highly specific requirements.

Advanced Pipeline Authoring

• Specifying a Comparison Pipeline

• Guide to Sample XSL Filters

• DXP Pipeline Overview

• DCP Pipeline Overview

• DTCP Pipeline Overview

Configuration Schema Guides

• DCP Schema Guide

• DTCP Schema Guide

• DITA Compare Configuration File Schema Guide

• DocBook Compare Configuration File Schema Guide

• HTML Compare Configuration File Schema Guide

Stage 8: Maintain and Upgrade

You need to keep your DeltaNova implementation healthy, diagnose problems, and handle version upgrades.

Diagnostics and Logging

• Logging in DeltaNova

Migration and Upgrades

• Migrating to DeltaNova

Stage 9: Reference

Stable reference material you can consult at any stage of your journey.

• Lexical Preservation Format Reference

• Document Table Comparison Overview: CALS and HTML

  • Examples of Table Comparison Results

• Namespace Index

• Using Namespaces Within XPath Expressions

• DITA Compare Configuration Reference

• DeltaNova Control Attributes Reference

• Anonymising Data Files Before Sending to Support

Technical Specifications

• Compare Technical Specification

• DITA Compare Technical Specification

• DocBook Compare Technical Specification

• HTML Compare Technical Specification

• Merge Technical Specification

• Check Technical Specification

Environment Configuration

• Document Comparator Features and Properties Reference

  • Catalog Resolver Overview

• Configuration Properties

• Input XML Restrictions Reference