3. configuration

<configuration
  name = non empty token
  mimeType = non empty token
>
  Content: [ binding|command|css|detect|documentResources|
             dtd|elementTemplate|help|imageToolkit|include|
             inclusionScheme|menu|newElementContent|parameterGroup|preserveSpace|
             property|relaxng|saveOptions|schematron|schema|
             spellCheckOptions|spreadsheetFunctions|template|toolBar|translation|
             validateHook|validate|windowLayout ]*
</configuration>

This root element of a XXE configuration is just a container for all the other configuration elements. See Writing a configuration file for XXE.

Attributes:

name

This attribute uniquely identifies the configuration. This attribute is required in top-level configurations (e.g. docbook.xxe). On the other hand, it must not be specified in configuration modules (e.g. common.incl).

mimeType

The value of this attribute is used to specify the content type of XML documents saved on WebDAV servers. When this attribute is not specified, the content type passed to the WebDAV server is always application/xml. This attribute allows to be more specific: application/xhtml+xml, application/docbook+xml, etc.

Example:

<configuration name="Example1"
  xmlns="http://www.xmlmind.com/xmleditor/schema/configuration">

  <detect>
    <dtdPublicId>-//XMLmind//DTD Example1//EN</dtdPublicId>
  </detect>

  <css name="Style sheet" location="example1.css" />

  <template name="Template" location="example1.xml" />

</configuration>

The structure of the configuration element is loose: you can add any number of any of its child elements in any order.

This loose structure is very convenient when you need to create a new configuration which just adds or replaces a few elements to an existing configuration.

Example: The following configuration called DocBook overrides bundled configuration also called DocBook.

<configuration name="DocBook" mimeType="application/docbook+xml"
  xmlns="http://www.xmlmind.com/xmleditor/schema/configuration">

  <include location="xxe-config:docbook/docbook.xxe" />

  <css name="DocBook" location="MyDocBook.css" />
  <css name="Big Fonts" location="MyDocBook_BigFonts.css" />

  <template name="Chapter" />
  <template name="Section" />

  <binding>
    <keyPressed code="F5" modifiers="mod shift" />
    <command name="insert" parameter="into literal" />
  </binding>

</configuration>

The configuration in previous example can be described as follows: