Chapter 2. Writing a configuration file for XXE
Prev | Part I. Guide | Next

## Chapter 2. Writing a configuration file for XXE

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: DITA, DocBook, XHTML, etc. More configurations (e.g. Slides) 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.

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

- Named element templates. See elementTemplate.

- Custom commands implemented in the Java™ language. See command.

- Macro commands. See command.

- Menu bar menu. See menu.

- Tool bar buttons. See toolBar.

- Popup menus. See binding.

- Mouse and/or keyboard bindings. See binding.

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

Some sample configurations are found in ``XXE_install_dir`/doc/configure/samples/`:

`example1/`

  The DTD example below.

`example2/`

  The W3C XML Schema example below.

`example3/`

  The RELAX NG example below.

`imagedemo/`

  Another configuration, using W3C XML schemas like example2 but much more comprehensive. 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.

`topic_plus_tag/`

  A configuration for a DITA topic specialization. This specialization adds a `tag` element to the topic DTD. A tag element has a required `kind` attribute. The values allowed for the `kind` attribute are: `attribute`, `attvalue`, `element`, `emptytag`, `endtag`, `genentity`, `localname`, `namespace`, `numcharref`,`paramentity`, `pi`, `prefix`, `comment`, `starttag`.

  This configuration has been created by customizing the stock DITA topic configuration as explained in Chapter 5, Customizing an existing configuration.

[2] Conforming to W3C XML Schema `configuration.xsd` available after downloading and installing add-on called "XMLmind XML Editor Configuration Pack".

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

Prev | Up | Next
Chapter 1. Introduction | Home | 1. DTD example