3. configuration
Prev | Chapter 7. Configuration elements | Next

## 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:

- It includes the stock DocBook configuration from `xxe-config:docbook/docbook.xxe` to reuse its `detect`, `elementTemplate`, `toolBar`, etc, elements. ("`xxe-config:`" resolves to ``XXE_install_dir`/addon/config/`.)

- It replaces bundled style sheet named `DocBook` by another one contained in `MyDocBook.css`. It adds another style sheet called `Big Fonts`.

- It discards document templates named "`Chapter`" and "`Section`" (template with no `location` attribute).

- Its binds key stroke Shift+Ctrl+F5 command "`insert into literal`". (`mod` is the Command key on Mac and the Control key on other platforms).

Prev | Up | Next
2. command | Home | 4. css