Chapter 2. Writing a configuration file for XXE

Table of Contents

1. DTD example
2. W3C XML Schema example
3. RELAX NG example

A configuration file is an XML file[2] that customizes XXE for a specific XML application. XXE is bundled with configurations for a few XML applications: DocBook, XHTML, W3C XML Schema, etc. More configurations (e.g. DITA) are available but they need the user to download and install the corresponding add-on[3].

This section describes how to write a configuration for a custom DTD, for a custom W3C XML Schema and for a custom RELAX NG schema. What is described is the recommended way of doing things. This being said, it is also possible to use XXE without writing any configuration file for a custom XML application: see side bar below.

The configurations used as examples are minimal configurations. The following configuration items are not described in this section:

Please read Configuration elements if you need to use any of these customization items.

The configurations used as examples are found in XXE_install_dir/doc/configure/samples/example1/, example2/, example3/.

Another configuration, using W3C XML schemas like example2 but much more comprehensive, is found in XXE_install_dir/doc/configure/samples/imagedemo/. This configuration has been created to explain how to cope with XML documents containing embedded binary (i.e. TIFF, PNG, etc) or XML (i.e. SVG) images. However, it is also useful as an example of an XXE configuration.



[2] Conforming to W3C XML Schema configuration.xsd available after downloading and installing add-on called "A configuration for specifying XMLmind XML Editor configurations".

[3] Simply use Options|Install Add-ons for that.