1.1.6. Config.xml

The configuration file config.xml defines structure of editor body – division of parameters and attributes sets in groups, subsections and sections.

Structure of config.xml

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1
  <section name="Document segments">2
    <subsection name="Admonition">3
      <group name="Text admonition" graphics="page-format">4
        <parameter>admon.textlabel</parameter>5
        <attribute-set>admonition.title.properties</attribute-set>6
        <attribute-set>admonition.properties</attribute-set>
        <attribute-set>nongraphical.admonition.properties</attribute-set>
      </group>
      <group name="Graphics">
        <parameter>admon.graphics</parameter>
        <parameter>admon.graphics.path</parameter>
        <parameter>admon.graphics.extension</parameter>
        <attribute-set>graphical.admonition.properties</attribute-set>
      </group>    
    </subsection>
  </section>
</config>
1

Tag config is a root element and can occur in the file only once. It can contain unlimited number of section tags.

2

Tag section defines the highest section of parameter and attribute-set division. The section name is defined by argument name. The section can contain unlimited number of subsection tags.

3

Tag subsection defines the middle subsection of parameter and attribute-set division. The subsection name is defined by argument name. The subsection can contain unlimited number of group tags.

4

Tag group defines the lowest group of parameter and attribute-set division. The group name is defined by argument name. Argument graphics is optional and points to a graphics figure defined in graphics.xml. Tag group can contain unlimited number of parameter and attribute-set tags in any sequence.

5

Tag parameter defines a name of parameter that belongs to this group, subsection and section. Parameter must have its XML definition file in the directory docbook-params/.

6

Tag attribute-set defines a name of attribute-set that belongs to this group, subsection and section. Attribute features must be defined in the configuration file config.xml.