Create an HTML difference display from two XML input files.
Project description
Create a difference on two RFC XML files
This program takes two XML files containing SVG or RFC documents and creates an HTML file which shows the differences between the two documents.
The RFC Editor is in the process of changing the canonical input format of Internet-Draft and RFC documents. Further information on the process can be found on the RFC Editor at the RFC Editor site.
Usage
rfc-xmldiff accepts a pair of XML documents as input and outputs an HTML document.
Basic Usage: rfc-xmldiff [options] SOURCE1 SOURCE2
Options
The following parameters affect how rfc-xmldiff behaves, however none are required.
Short
Long
Description
-C
--clear-cache
purge the cache and exit
-h
--help
show the help message and exit
-N
--no-network
don’t use the network to resolve references
-q
--quiet
don’t print anything
-r
--raw
don’t use the xml2rfc vocabulary when matching
-v
--verbose
print extra information
-V
--version
display the version number and exit
-X
--no-xinclude
don’t resolve xi:include elements
-o FILENAME
--out=FILENAME
specify an output filename
-t FILENAME
--template=FILENAME
specify HTML template filename
-D
--no-defaults
don’t load attribute defaults from the dtd
.
--resource-url=URL
specify the URL for resources in the template
Templates
Two template files are installed with the package:
single.html - provides just the XML difference between the two files.
base.html - provides three columns containing the left source files, the XML difference and the right source files. Uses color to highlight changes. This is the default template.
wdiff.html - provides three columns containing the left source files, the XML difference and the right source files. Uses color and strike throughs to highlight changes.
For new template files, the following variables are define:
title - provides a default window title
body - contains the XML difference HTML
leftSourceNames - the list of all input files for the left sources
leftFile - contains the left source files
rigthSourceNames - the list of all input files for the right sources
rightFile - contains the right source files
resource_dir - contains the URL to find the resources. This defaults to the Template directory of the package.
allScript - contains the contents of resize.js so the resulting html file is self contained.
Dependencies
rfc-xmldiff depends on the following packages:
lxml (>= 4.1.1)
requests (>= 2.5.0)
rfctools_common (>= 0.5.10)
cffi (>= 1.0.0)
Changelog
Version 0.5.12 (Fri 25 Jan)
Add a class to deal with entities when they are not expanded.
Version 0.5.11 (Tue 1 Janc)
Add code to deal with trees which are going to merge but they subtrees are going to overlap
Add -D option to surpress filling in default attributes from DTD
Name spaces are now using a nsX namespace rather than using the {ns}field format.
Change the html template to make sure that it is all within the screen.
Version 0.5.10 (Mon XX Sept)
Make base.html be the default template
Add a wdiff.html template which mimics the wdiff marking
Deal with getting UTF8 characters in source files - python 2 doesn’t like it
Clean out some unused items in the manifest file
Add the –no-xinclude option. This option will additionally not process <?rfc include=””?> as well.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.