RELAX NG: Coding requirements for attribute domain modules
An attribute domain vocabulary module declares a new attribute specialized from either
the @props
or @base
attribute. An attribute domain module
defines exactly one new attribute type.
All vocabulary and constraint modules must document their
@domains
attribute contribution. The value of the contribution is
constructed according to the rules found in domains attribute rules and syntax. The OASIS grammar files
use a <domainsContribution>
element to document the contribution;
this element is used to help enable generation of DTD and XSD grammar files. An XML comment
or <a:documentation>
element can also be used.
An attribute domain's name is the name of the attribute plus "Att". For example, for the attribute named "deliveryTarget" the attribute domain name is "deliveryTargetAtt". The attribute domain name is used to construct pattern names for the domain.
An attribute domain consists of one file, which has three sections:
- Domains attribute contribution
-
The
@domains
contribution must be documented in the module. The value is constructed according to the rules found in domains attribute rules and syntax. - Attribute extension pattern
- The attribute extension pattern extends either the
@props
or@base
attribute set pattern to include the attribute specialization.For specializations of@props
the pattern is namedprops-attribute-extensions
. The pattern specifies a@combine
value of "interleave", and the content of the pattern is a reference to the specialized attribute declaration pattern. For example:<define name="props-attribute-extensions" combine="interleave"> <ref name="deliveryTargetAtt-d-attribute"/> </define>
For specializations of@base
the pattern is namedbase-attribute-extensions
. The pattern specifies a@combine
value of "interleave", and the content of the pattern is a reference to the specialized attribute declaration pattern. For example:<define name="base-attribute-extensions" combine="interleave"> <ref name="myBaseSpecializationAtt-d-attribute"/> </define>
- Attribute declaration pattern
- The specialized attribute is declared in a pattern named
domainName-d-attribute
. The attribute must be defined as optional. For example, the@deliveryTarget
specialization of@props
is defined as follows:<define name="deliveryTargetAtt-d-attribute"> <optional> <attribute name="deliveryTarget"/> </optional> </define>