DeltaXML Corporate Logo
 

Press button (top right)
to see the comparisons.

 Back Compare DocBook

Welcome to the DeltaXML Online Demo

This page uses the XML Compare API to generate different types of results. It provides examples of the results that you could achieve using our toolkit. These are not the only output types you could create but they give you a flavour of common uses of XML Compare.

If you would like to find out more about what a full release contains, contact us and ask for a downloadable trial version.

Let's get started. Take a look at the top bar above the XML code. Depending on what demo you have selected will determine how many views you see. There are up to four views to switch from:

Side-by-Side, Inline Report, PDF and Raw Delta.

Let’s look at more detail at each of the views. Press 'continue' to begin.

Side by Side Report

This view is great if you want to see changes in their original context giving you an understanding of which word, phrase or sentence has been changed. Use the arrow buttons on the toolbar or up/down cursor-keys to move forward and back between changes. Elements may be folded or expanded to make it easier to see the context of a change.

The left and right views in the report correspond to the contents of the A and B documents respectively. The space in each of the document views is adjusted to ensure that elements and attributes are properly aligned vertically in both views. Contents that exists in one document but not the other is highlighted. The ancestor elements of a change have lighter highlighting.

When a change is selected, its position is highlighted in both the A (left-side) and the B (right-side) document views. The number of the selected change is shown in the toolbar, the element-path to the change is shown just below the toolbar.

Inline Report

With DeltaXML at its heart, the folding report is a great way to show change clearly and quickly. 

The inline report is created by applying XSLT transformations to the delta file to convert it into an HTML format. This XSLT ‘pipeline’ is the standard way of configuring XML Compare for your own use. For more details on specifying a pipeline, go here.

As the name suggests the report can fold and expand. This is useful for when you only want to see a certain section of your file making it easy to find the necessary changes.

Inline Report Cont.

If you want to see all the changes the delta has found but don't want to sieve through the whole document, use the left and right arrows to jump to the next and previous changes. If it's a specific change you want to see, use the sidebar to the left which lists all the changes that have been found. From here you can jump to any change. This would be especially helpful with large files.

Inline Report Cont.

Click the switch style button to change text formatting and background colours.

PDF Report

Where XML document types are published to PDF, you can make use of the changes XML Compare finds and publish them in the same way. For example, output from DITA Compare can be used with the standard DITA Open Toolkit to create a PDF containing change highlighting.

Raw Delta

The delta format is the native output of XML Compare. For each element it shows whether it was present in the inputs (called A and B) using the deltaV2 attribute. This has values A, B, A=B, and A!=B. If an element is present in both inputs versions, the delta attribute tells you whether they were the same (A=B) or different (A!=B).

For text changes, the text is wrapped inside a deltaxml:textGroup element so that the deltaV2 attributes can be added to it e.g.

Attribute changes are shown by converting changed attributes into elements inside a deltaxml:attributes wrapper e.g.

It’s as simple as that. You can read about the delta format in more detail here.

What Next?

Experiment with the online demo using your own XML.

The Side-by-side and Inline reports shown here were created by applying XSLT transformations to the delta file. PDFs were generated from XML Compare output using the relevant toolkits for the document type.

This XSLT pipeline is the standard way of configuring XML Compare for a specific document type and to produce a customised output format. For more details on specifying a pipeline, go here.

If you would like to discover how others are using our products you can go here. Or if you would like to learn more on how to obtain XML Compare to integrate into your own projects please contact

phill.barratt@deltaxml.com

Back   Continue

More Questions?

Contact Us

Watch Video

Side by Side Inline Report PDF Raw Delta
This is the Help Bar. Hover over different areas of the page to receive relevant information.
<?xml version="1.0" encoding="UTF-8"?>
<article xmlns:deltaxml="http://www.deltaxml.com/ns/well-formed-delta-v1"
         xmlns="http://docbook.org/ns/docbook"
         xmlns:dxx="http://www.deltaxml.com/ns/xml-namespaced-attribute"
         xmlns:dxa="http://www.deltaxml.com/ns/non-namespaced-attribute"
         deltaxml:deltaV2="A!=B"
         version="5.0"
         deltaxml:version="2.0"
         deltaxml:content-type="full-context">
   <title deltaxml:deltaV2="A=B">DeltaXML DocBook5 Compare</title>
   <para deltaxml:deltaV2="A!=B">
      <deltaxml:textGroup deltaxml:deltaV2="A!=B">
         <deltaxml:text deltaxml:deltaV2="A">This sample document shows some of the benefits of DeltaXML DocBook5 Compare, which shows revisions in all your DocBook Documents. DeltaXML DocBook 5 Compare takes the pain out of tracking an documenting changes in all DocBook5 documents.</deltaxml:text>
         <deltaxml:text deltaxml:deltaV2="B">This sample document shows some of the benefits of DeltaXML DocBook5 Compare, which shows revisions in all your DocBook Documents. DeltaXML DocBook 5 Compare takes the pain out of tracking and documenting changes in all DocBook5 documents.</deltaxml:text>
      </deltaxml:textGroup>
   </para>
   <para deltaxml:deltaV2="A=B">You can simply execute DeltaXML DocBook5 Compare and provide it with two version of, say, a DocBook article and it will generate a new article which shows all the changes. Added, deleted and changed text will be marked with DocBook revisionflag attributes. This simple example shows how this works.</para>
   <para deltaxml:deltaV2="A!=B">
      <deltaxml:textGroup deltaxml:deltaV2="A!=B">
         <deltaxml:text deltaxml:deltaV2="A">This document represents Version 1. You will see that when 'Version 1' is changed to 'Version 2', the change is marked.</deltaxml:text>
         <deltaxml:text deltaxml:deltaV2="B">This document represents Version 2. You will see that when 'Version 1' is changed to 'Version 2', the change is marked.</deltaxml:text>
      </deltaxml:textGroup>
   </para>
   <para deltaxml:deltaV2="A">This paragraph appears only in Version 1 and not in Version 2.</para>
   <section deltaxml:deltaV2="A!=B">
      <title deltaxml:deltaV2="A=B">A Section</title>
      <para deltaxml:deltaV2="A=B">When an article has sections, each section will be aligned with a section in the other document and not with a paragraph.</para>
      <para deltaxml:deltaV2="B">This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
   </section>
   <section deltaxml:deltaV2="A!=B">
      <title deltaxml:deltaV2="A=B">Benefits</title>
      <para deltaxml:deltaV2="A">This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
      <para deltaxml:deltaV2="A!=B">Here are some of the benefits of using DeltaXML DocBook5 Compare: <itemizedlist deltaxml:deltaV2="A!=B">
            <listitem deltaxml:deltaV2="A=B">
               <para>An author does not need to set up revision flags to show where changes have been made</para>
            </listitem>
            <listitem deltaxml:deltaV2="A=B">
               <para>You can decide when publishing whether to show changes between the current document and the last major or minor release, or any version in between</para>
            </listitem>
            <listitem deltaxml:deltaV2="A=B">
               <para>You can make use of DeltaXML's docbook-xsl customization layer that highlights changes using styling when producing HTML or XSL-FO output. The customization layer can be integrated with any existing customizations you may use.</para>
            </listitem>
            <listitem deltaxml:deltaV2="A!=B">
               <para deltaxml:deltaV2="A!=B">
                  <deltaxml:textGroup deltaxml:deltaV2="A!=B">
                     <deltaxml:text deltaxml:deltaV2="A">The output generated by DeltaXML DocBook5 Compare is a DocBook5 document which you can edit in any way you choose, perhaps to fine-tune the changes that you want to show</deltaxml:text>
                     <deltaxml:text deltaxml:deltaV2="B">The output generated by DeltaXML DocBook5 Compare is a DocBook5 document which you can edit in any way you choose, for example to fine-tune the changes that you want to show</deltaxml:text>
                  </deltaxml:textGroup>
               </para>
            </listitem>
         </itemizedlist>
      </para>
   </section>
   <section deltaxml:deltaV2="A!=B">
      <title deltaxml:deltaV2="A=B">Tables</title>
      <para deltaxml:deltaV2="A=B">Here is an example of a table which has been changed:</para>
      <table deltaxml:deltaV2="A!=B">
         <title deltaxml:deltaV2="A=B">Table Example</title>
         <tgroup deltaxml:deltaV2="A!=B" cols="3">
            <thead deltaxml:deltaV2="A=B">
               <row>
                  <entry>DocBook Article Element</entry>
                  <entry>Are changes shown?</entry>
                  <entry>Comment</entry>
               </row>
            </thead>
            <tbody deltaxml:deltaV2="A!=B">
               <row deltaxml:deltaV2="A=B">
                  <entry>Paragraph <code>&lt;para&gt;</code>
                  </entry>
                  <entry>Yes</entry>
                  <entry>Every added or deleted word is wrapped in a phrase &lt;ph&gt; element with a <code>revisionflag</code> attribute to indicate if it is added or deleted.</entry>
               </row>
               <row deltaxml:deltaV2="A=B">
                  <entry>Section <code>&lt;section&gt;</code>
                  </entry>
                  <entry>Yes</entry>
                  <entry>Changes shown within each paragraph or other content of the section.</entry>
               </row>
               <row deltaxml:deltaV2="A=B">
                  <entry>Lists <code>&lt;itemizedlist&gt;</code>, <code>&lt;orderedlist&gt;</code> or <code>&lt;simplelist&gt;</code>
                  </entry>
                  <entry>Yes</entry>
                  <entry>Changes shown within each list item &lt;li&gt;</entry>
               </row>
               <row deltaxml:deltaV2="A!=B">
                  <entry deltaxml:deltaV2="A=B">Table <code>&lt;table&gt;</code> or <code>&lt;informaltable&gt;</code>
                  </entry>
                  <entry deltaxml:deltaV2="A=B">Yes</entry>
                  <entry deltaxml:deltaV2="A!=B">
                     <deltaxml:textGroup deltaxml:deltaV2="A!=B">
                        <deltaxml:text deltaxml:deltaV2="A">Changes shown within the text content of each cell of the table. DeltaXML DocBook5 Compare processes the structure of tables so these are handled intelligently.</deltaxml:text>
                        <deltaxml:text deltaxml:deltaV2="B">Changes shown within the text content of each cell of the table. DeltaXML DocBook5 Compare understands the structure of tables so these are handled intelligently.</deltaxml:text>
                     </deltaxml:textGroup>
                  </entry>
               </row>
            </tbody>
         </tgroup>
      </table>
   </section>
   <section deltaxml:deltaV2="A=B">
      <title>Summary</title>
      <para>DeltaXML DocBook5 Compare frees editors to work on documents without having to track where they are making changes. Simply by comparing either minor or major revisions using DeltaXML DocBook5 Compare, revision flags are added and reviewers and customers can see exactly where changes have been made. And because DeltaXML DocBook5 Compare generates standard DocBook documents, you can edit them and publish changes using your existing publishing infrastructure.</para>
   </section>
</article>
FoldExpand# of 8
 
<?xml version="1.0" encoding="UTF-8" ?>
<?oxygen ...?>
<article xmlns="http://docbook.org/ns/docbook"version="5.0">
<title>DeltaXML DocBook Compare</title>
<para>This sample document shows some of the benefits of DeltaXML DocBook Compare, which shows revisions in all your DocBook Documents. DeltaXML DocBook Compare takes the pain out of tracking an documenting changes in all DocBook documents.</para>
<para>...</para>
<para>This document represents Version 1. You will see that when 'Version 1' is changed to 'Version 2', the change is marked.</para>
<para>This paragraph appears only in Version 1 and not in Version 2.</para>
<section>
<title>A Section</title>
<para>...</para>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
</section>
<section>
<title>Benefits</title>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
<para>Here are some of the benefits of using DeltaXML DocBook Compare: <itemizedlist>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>
<para>The output generated by DeltaXML DocBook Compare is a DocBook document which you can edit in any way you choose, perhaps to fine-tune the changes that you want to show</para>
</listitem>
</itemizedlist>
</para>
</section>
<section>
<title>Tables</title>
<para>...</para>
<table>
<title>Table Example</title>
<tgroup cols="3">
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="2" colwidth="1*"/>
<colspec colnum="3" colwidth="1*"/>
<thead>...</thead>
<tbody>
<row>...</row>
<row>...</row>
<row>...</row>
<row>
<entry>...</entry>
<entry>Yes</entry>
<entry>Changes shown within the text content of each cell of the table. DeltaXML DocBook5 Compare processes the structure of tables so these are handled intelligently.</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section>...</section>
</article>
<?xml version="1.0" encoding="UTF-8" ?>
<?oxygen ...?>
<article xmlns="http://docbook.org/ns/docbook"version="5.0">
<title>DeltaXML DocBook Compare</title>
<para>This sample document shows some of the benefits of DeltaXML DocBook Compare, which shows revisions in all your DocBook Documents. DeltaXML DocBook Compare takes the pain out of tracking and documenting changes in all DocBook documents.</para>
<para>...</para>
<para>This document represents Version 2. You will see that when 'Version 1' is changed to 'Version 2', the change is marked.</para>
<para>This paragraph appears only in Version 1 and not in Version 2.</para>
<section>
<title>A Section</title>
<para>...</para>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
</section>
<section>
<title>Benefits</title>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
<para>Here are some of the benefits of using DeltaXML DocBook Compare: <itemizedlist>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>
<para>The output generated by DeltaXML DocBook5 Compare is a DocBook document which you can edit in any way you choose, for example to fine-tune the changes that you want to show</para>
</listitem>
</itemizedlist>
</para>
</section>
<section>
<title>Tables</title>
<para>...</para>
<table>
<title>Table Example</title>
<tgroup cols="3">
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="2" colwidth="1*"/>
<colspec colnum="3" colwidth="1*"/>
<thead>...</thead>
<tbody>
<row>...</row>
<row>...</row>
<row>...</row>
<row>
<entry>...</entry>
<entry>Yes</entry>
<entry>Changes shown within the text content of each cell of the table. DeltaXML DocBook5 Compare understands the structure of tables so these are handled intelligently.</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section>...</section>
</article>
FoldExpandSwitch Style# of 0
 
<?xml version="1.0" encoding="UTF-8" ?>
<?oxygen ...?>
<article xmlns="http://docbook.org/ns/docbook" version="5.0">
<title>DeltaXML DocBook Compare</title>
<para>This sample document shows some of the benefits of DeltaXML DocBook Compare, which shows revisions in all your DocBook Documents. DeltaXML DocBook Compare takes the pain out of tracking anand documenting changes in all DocBook documents.</para>
<para>...</para>
<para>This document represents Version 12. You will see that when 'Version 1' is changed to 'Version 2', the change is marked.</para>
<para>This paragraph appears only in Version 1 and not in Version 2.</para>
<section>
<title>A Section</title>
<para>...</para>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
</section>
<section>
<title>Benefits</title>
<para>This paragraph is the same as the paragraph before/after it in the result article but is not aligned because it is in different sections in each input article.</para>
<para>Here are some of the benefits of using DeltaXML DocBook Compare: <itemizedlist>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>...</listitem>
<listitem>
<para>The output generated by DeltaXML DocBookDocBook5 Compare is a DocBook document which you can edit in any way you choose, perhapsfor example to fine-tune the changes that you want to show</para>
</listitem>
</itemizedlist>
</para>
</section>
<section>
<title>Tables</title>
<para>...</para>
<table>
<title>Table Example</title>
<tgroup cols="3">
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="2" colwidth="1*"/>
<colspec colnum="3" colwidth="1*"/>
<thead>...</thead>
<tbody>
<row>...</row>
<row>...</row>
<row>...</row>
<row>
<entry>...</entry>
<entry>Yes</entry>
<entry>Changes shown within the text content of each cell of the table. DeltaXML DocBook5 Compare processesunderstands the structure of tables so these are handled intelligently.</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section>...</section>
</article>

Developer Information

This is the content for the developer information panel.