Configuration File

Introduction

DocBook Compare’s REST API has been designed with a configuration file due to the complexity of the API. We have grouped parameters together to make it easier to understand.

The schema for the configuration file is defined using an XML Schema (XSD), the XSD file is included in the product distribution rest-resources directory and is documented here: Configuration File Schema Guide.

There is also an example file available here: configuration-sample.xml

Editing the Configuration File

To help ensure that you create a valid configuration file, it is recommended that you use an XML editor that supports XSD validation and associate the file with the configuration file XSD. The XSD association is made using the xsi:schemaLocation attribute with a URI value that links to the configuration XSD file docbook-configuration.xsd, included in the distribution's resources directory. For example:

XML

<?xml version="1.0" encoding="UTF-8"?>
<configuration 
  xmlns="com.deltaxml.docbook.rest.config" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="com.deltaxml.docbook.rest.config docbook-configuration.xsd">
  ...
</configuration>

Note that in the above example, the configuration file elements use the default prefix that is bound to the com.deltaxml.docbook.rest.config namespace. The namespace is therefore also included as the first part of the xsi:schemaLocation value.

With this XSD association in your configuration file, your XML editor should provide auto-completion and context-specific help documentation as you type.