Integration with Git

1. Introduction

This sample is provided to show DeltaXML-DITA-Merge integration with git for merge and update operations.

The sample currently supports the command-line client usage on a unix system.

Please read the comments from the shell-script provided in the sample directory for detailed configuration steps.

2. Usage notes and tips

The git merge process with DeltaXML DITA Merge takes you in a loop which opens each conflicted in the editor one after another and then merge waits until conflcits are resolved manualy.

By default, script opens each file using the default application for that file. If oXygen editor is installed on the system, then it can be used as default application for xml files.

After conflicts are resolved and file is saved, a xslt filter runs automatically to remove deltaxml attributes from root element.

DeltaXML DITA Merge can be used with parameter 'result-type'.

The parameter 'result-type' works well with one of the following settings available at commandline:

  • simplified-delta
  • simplified-rule-processed-delta
  • conflicting-changes
  • their-changes
  • all-changes

2.1. simplified-delta and simplified-rule-processed-delta

The simplfied result-types show three way merge and are easier to understand.

These results have deltaxml markups and attributes only for the changes. So it is easier to edit and resolve conflicts.

2.2. conflicting-changes, their-changes and all-changes

The result types conflicting-changes, their-changes and all-changes are three to two merge result. For more details, please visit three to two way merge use cases guide.

These results also have deltaxml markups only at the change but deltaxml:deltaV2 atrributes are appear throughout xml hierarchy. Users should remove these attributes manually.

The oXygen track changes can also be applied to these output formats which will allow the user to accept and reject changes interactively. The result-format command-line option can be used to select this output format.