Edit online

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/merge 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. If the file is not read-only and you are not in a Concurrent Editing session, the documents are opened in the Merge tool and the file in the left-side pane can be edited and changes can be copied or merged.
    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 (this submenu gets replaced with the Compare with another file action 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. If the file is not read-only and you are not in a Concurrent Editing session, the documents are opened in the Merge tool and the file in the left-side pane can be edited and changes can be copied or merged.
Figure 1. 2-Way Comparison

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.

Notice: If you are using a version of Oxygen XML Web Author that is integrated into another application (for example, a CMS), the file comparison tool may not be available by default.

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.
Figure 2. 3-Way Comparison

Resources

For more information about the file comparison tool and how Web Author can be integrated within various stages of a documentation review workflow, see the following resources: