DTD: Coding requirements for element-domain modules

The vocabulary modules that define element domains have an additional coding requirement. The entity declaration file must include a parameter entity for each element that the domain extends.

Parameter entity name

The name of the parameter entity is the abbreviation for the domain, followed by a hyphen ("-") and the name of the element that is extended.

Example

This section is non-normative.

For example, the name of the parameter entity for the highlighting domain that extends the <ph> element is hi-d-ph.

Parameter entity value

The value of the parameter entity is a list of the specialized elements that can occur in the same locations as the extended element. Each element is separated by the vertical line ( | ) symbol.

Example

This section is non-normative.

For example, the value of the %hi-d-ph; parameter entity is "b | u | i | line-through | overline | tt | sup | sub".

Example

This section is non-normative.

The following code sample shows the parameter entity for the highlight domain, as declared in highlightDomain.ent:

<!-- ============================================================= -->
<!--                    ELEMENT EXTENSION ENTITY DECLARATIONS      -->
<!-- ============================================================= -->

<!ENTITY % hi-d-ph "b | i | line-through | overline | sup | sub | tt | u">

<!-- ================ End DITA Highlight Domain ================== -->