DocBook Service Help
The DeltaXML DocBook service allows you to compare and process two DocBook documents. Each of these can be supplied using browser-upload or by URL.
Validation
The validate checkbox controls the validation of the docbook files. We recommend that you use valid files; we cannot guarantee the correctness of the result, or even if a result file will be produced if the input is invalid. Note that a file without a DOCTYPE declaration is, by definition, invalid and should be procesed with validation turned off.
There are some aspects of input file correctness that we check independently of the validation setting. One such issue is the uniqueness of any id attributes in docbook. Any file with duplicate id values will be rejected irrespective of the validate setting.
Existing revisionflags
The service does not support processing of input files which already contain revisionflags; such files will be rejected.
Using URLs
The URL tab can be selected to specify an absolute URL, the service will then read data from the URL. It will also resolve and download any referenced entities, including any DTDs, and any files specified through the XInclude mechanism. The URLs specified and also any indirectly referenced files, for example images included in DocBook documents, must be publicly visible on the internet.
Browser Upload
For each of the input files tabs are used to select the upload method. To upload a file from your file system, select the Upload tab. Then a button will appear, the name of the button depends on the browser being used, but it is typically 'browse...' or 'choose file'. A file selection widget will then allow you to select an XML file for upload to our server.
Please note that the Browser Upload mechanism only supports DTDs (and other entities and XInclude) when they are specified as absolute URLs which are publicly visible on the internet. We do not currently have a means of supporting relative URIs to DTDs or other files on your local system. Future enhancements to the service may provide support for uploading files referred to by relative URIs in addition to the two main data sets.
Results
When the form is submitted, data is uploaded to the server, compared and processed and the results are then returned to your browser. If you are processing large amounts of data this may take some time; please be patient.
Depending upon the selected result type, the result should be formatted according to how your browser handles the associated 'MIME type'. You may be able to control some aspects of the result display using the associated configuration settings in your browser.
Should you wish to further process any delta files produced by the service, consider using the 'Save As...' menu in the browser. This may be appropriate, if for example you save your XSL-FO output and then process it locally using an alternative XSL-FO renderer.