Draft

1.2 (2019-02-09)

Email Addresses

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

Use the email element to mark up the email address for a person or organization in a credit element.

Notes

  • The email element can contain a mixture of text and any general inline elements.

  • The email 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 email element can have attributes from external namespaces. See External Namespaces for more information on external-namespace attributes.

Examples

Use credit together with name and email to mark up the name and email address of the author:

<credit type="author">
  <name>Shaun McCance</name>
  <email>shaunm@gnome.org</email>
</credit>

Processing Expectations

See the processing expectations for the credit element.

Comparison to Other Formats

The email element is similar to the email element in DocBook when that element is used in an informational context. The email element in Mallard does not double as an inline element.

The email element is similar to the emailaddress element in DITA. DITA provides the emailaddresses element to wrap one or more email addresses for an entity. In Mallard, multiple email elements can be used without a wrapper 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 email element. The namespace declarations for this definition are on the page Pages.

mal_info_email = element email {
  mal_info_email_attr,
  mal_info_email_inline
}
mal_info_email_attr = (
  attribute style { xsd:NMTOKENS } ?,
  mal_attr_external *
)
mal_info_email_inline = mal_inline
© 2009-2011 Shaun McCance
cc-by-sa 3.0 (us)

This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.

As a special exception, the copyright holders give you permission to copy, modify, and distribute the example code contained in this document under the terms of your choosing, without restriction.

Powered by
Mallard