Names

This is a draft specification. It is likely that changes will still be made before the final specification.

Use the name element to mark up the name of a person or organization in a credit element.

Notes

The name element can contain a mixture of text and any general inline elements.
The name element can occur in the credit element.
The style attribute takes a space-separated list of style hints. Processing tools should adjust their behavior according to those style hints they understand.
The name element can have attributes from external namespaces. See External Namespaces for more information on external-namespace attributes.

Examples

Use credit and name to mark up the name of the author:

<credit type="author">
  <name>Shaun McCance</name>
</credit>

Processing Expectations

See the processing expectations for the credit element.

Comparison to Other Formats

The name element fulfills the same role as numerous DocBook elements, such as personname and publishername. Note that Mallard does not attempt to model the names of people, as the rules for how to display names from their constituent parts vary considerably. If parts of a name are needed for a domain-specific purpose, they can be included using elements from external namespaces on the parent element.

The name element fulfills the same role as numerous DITA elements, including person, personname, organization, and organizationname. Note that Mallard does not attempt to model the names of people or organizations, as the rules for how to display names from their constituent parts vary considerably. If parts of a name are needed for a domain-specific purpose, they can be included using elements from external namespaces on the parent element.

Schema

The formal definition of the Mallard language is maintained in RELAX NG Compact Syntax in code blocks within this specification. This is the formal definition for the name element. The namespace declarations for this definition are on the page Pages.

mal_info_name = element name {
  mal_info_name_attr,
  mal_info_name_inline
}
mal_info_name_attr = (
  attribute style { xsd:NMTOKENS } ?,
  mal_attr_external *
)
mal_info_name_inline = mal_inline