File Comparison Tool

Oxygen XML Web Author includes a file comparison tool that can be used to show differences between the current document and either its latest version from the repository or another document. To access the tool, select one of the following actions in the More drop-down menu:

• Compare with > Latest version from repository - Opens the file comparison tool with the current file displayed in the left-side pane and the latest version of the file from the repository displayed in the right-side pane.
  Note: If you are using a Git file repository integration (GitHub, Bitbucket, GitLab, or Git), this action automatically does a three-way comparison between the current document, its latest version from the repository, and the original base revision.
• Compare with > Another file - Opens a file chooser dialog box where you can specify a file to compare against the current file. Once you select a file and click Choose, the file comparison tool is opened with the current file displayed in the left-side pane and the other file displayed in the right-side pane.
• Compare with another file (this action replaces the Compare with submenu if auto-save is enabled) - Opens a file chooser dialog box where you can specify a file to compare against the current file. Once you select a file and click Choose, the file comparison tool is opened with the current file displayed in the left-side pane and the other file displayed in the right-side pane.

The resulting comparison will show you differences between the two files. It is a visual comparison tool, so the documents are displayed in each pane similar to how they look in the Web Author visual editor. Detected differences are grouped into highlighted blocks in each pane and content highlighted with a darker shade within the blocks identifies specific changes within the blocks. Each block of differences is connected with dynamic lines in between the two panes.

The markers on the right-side vertical stripe help you to quickly identify the locations of the differences and you can navigate to specific differences by clicking the markers.

The toolbar at the top also includes some navigation buttons, as well as a Tags Display Mode drop-down button that allows you to select the amount of tags to display.

Tip: The default tags display mode is Full Tags With Attributes so that XML structural differences, such as element name changes or attribute changes, are more visible. You can switch to a less cluttered view by choosing the No Tags mode.

The comparison tool also presents differences that were made using the Change Tracking feature. Content that has a comment attached is highlighted in a colored shade the same as in the editor. To see the actual content of the comment, you can hover over it.

Three-Way Comparisons (Available for Git File Repository Integrations)

If you are using a Git file repository integration (GitHub, Bitbucket, GitLab, or Git), when comparing the current document to its latest version from the repository, it automatically does a three-way comparison between the current document, its latest version from the repository, and the original base revision.

In this type of comparison, the differences are highlighted in additional possible colors:

• Pink - Identifies differences in both sides where conflicts are possible.
• Gray - Identifies an addition of a node in the left side (the current document).
• Blue - Identifies an addition of a node in the right side (the latest version from the repository).
• Darker Shade - Identifies specific changes within the blocks.