Zwei XML-Versionen. Ein Vergleichs-PDF. Alle Änderungen sichtbar.
Der QBK XML Differ, gesprochen "cubic", ist eine gemeinsam von data2type und parsQube entwickelte Lösung für den präzisen Vergleich komplexer XML-Dokumente.
Anders als klassische Word- oder PDF-Vergleiche beginnt QBK XML Differ nicht erst beim erzeugten Ausgabedokument. Die beiden Versionen werden direkt auf XML-Ebene analysiert. Dadurch können neben Textänderungen auch Dokumentstrukturen, Elemente, Attribute, IDs und Beziehungen innerhalb des Dokuments in die Analyse einbezogen werden.
Aus dem Vergleich entsteht ein strukturiertes XML-Ergebnis, aus dem anschließend unter anderem ein gemeinsames Vergleichs-PDF erzeugt werden kann.
Änderungen dort erkennen, wo sie entstehen
Werden zwei unabhängig erzeugte PDF- oder Word-Dokumente miteinander verglichen, enthalten diese bereits zusätzliche Informationen aus dem Publishing-Prozess. Seitenumbrüche, Layoutstrukturen, automatisch erzeugte Inhalte oder Nummerierungen können Unterschiede verursachen, die keine eigentlichen Inhaltsänderungen sind.
Der QBK XML Differ setzt deshalb direkt an den strukturierten XML-Quellen an. Entscheidend ist nicht nur, ob zwei Seiten gleich aussehen, sondern welche Inhalte und Strukturen beider XML-Versionen einander entsprechen und was sich tatsächlich geändert hat.
Welche Änderungen können sichtbar gemacht werden?
Je nach Dokumentmodell und Konfiguration können unterschiedliche Änderungstypen erkannt und für die Ausgabe aufbereitet werden:
- neue Inhalte und Elemente
- entfernte Inhalte
- geänderte Texte
- Inline-Änderungen innerhalb eines Absatzes
- Attribut-Änderungen
- strukturelle Änderungen
- verschobene Inhalte und Abschnitte
Ein gemeinsames Vergleichs-PDF
Der XML-Vergleich ist die technische Grundlage. Für Review und Freigabe ist PDF häufig das praktischere Medium. Aus dem strukturierten Ergebnis kann deshalb ein gemeinsames Vergleichs-PDF erzeugt werden.
Der Reviewer muss nicht zwei Dateien parallel durchsuchen. Einfügungen, Löschungen und Änderungen werden in einer gemeinsamen Darstellung sichtbar und können mit den gewohnten Werkzeugen gelesen, kommentiert, verteilt und archiviert werden.
Nicht nur für DocBook geeignet!
QBK XML Differ wurde im Rahmen eines DocBook-Projekts entwickelt, ist aber als generische XML-Differencing-Lösung angelegt. Die Vergleichslogik kann an unterschiedliche XML-Vokabulare, Dokumenttypen und projektspezifische Regeln angepasst werden.
- Technische Dokumentation
- technische Richtlinien
- Normen und Spezifikationen
- regulatorische Dokumente
- Verlags- und Publikationsdaten
- Produktinformationen
- kundenspezifische XML-Formate
- Single-Source-Publishing
- XML-basierte Review- und Freigabeprozesse
Entstanden aus einem realen Projekt
Die Lösung entstand aus einer konkreten Anforderung im Umfeld des Bundesamts für Sicherheit in der Informationstechnik. data2type und parsQube entwickelten gemeinsam einen Ansatz, bei dem die strukturierten Quelldokumente verglichen und die Ergebnisse anschließend für den Review aufbereitet werden.