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

## 3. configuration

    <configuration
      name = non empty token
    >
      Content: [ include|help|translation|saveOptions|command|parameterGroup|
                 binding|toolBar|menu|template|css|dtd|schema|relaxng|detect|
                 elementTemplate|newElementContent|property|documentHook|
                 documentResources|imageToolkit|spreadsheetFunctions|
                 preserveSpace|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.

Example:

    <configuration name="Example1"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns="http://www.xmlmind.com/xmleditor/schema/configuration"
      xmlns:cfg="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"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns="http://www.xmlmind.com/xmleditor/schema/configuration"
      xmlns:cfg="http://www.xmlmind.com/xmleditor/schema/configuration">

      <include location="file:/D:/xxe/addon/config/docbook/docbook.xxe" />

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

      <template name="Chapter (part of a master document)" />
      <template name="Section (part of a master document)" />

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

    </configuration>

The configuration in previous example can be described as follows:

- It includes bundled configuration from `file:/D:/xxe/addon/config/docbook/docbook.xxe` to reuse its detect, elementTemplate, toolBar, etc, elements.

- 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 (part of a master document)`" and "`Section (part of a master document)`" (template with no `location` attribute).

- Its binds key stroke Shift-Ctrl-L 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