Titles

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

Use the block title element to mark up the title of a page, section, or formal block element.

Notes

The title element can contain a mixture of text and any general inline elements.
The title can occur in a page element, a section element, and any formal block 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 title element can have attributes from external namespaces. See External Namespaces for more information on external-namespace attributes.
The title element may also be used in an informational context. See Informational Titles for more information.

Examples

Provide a title for a page:

<page id="ducks">
  <title>Ducks</title>
</page>

Provide a title for an image with the figure element:

<figure>
  <title>The Mallard Logo</title>
  <media type="image" mime="image/png" src="mallard-logo.png"/>
</figure>

The Mallard Logo

Processing Expectations

A block title is displayed at the beginning of its containing element. It is generally displayed in a different font, size, or weight to make it stand out from the surrounding content.

Comparison to Other Formats

The title element is similar to the title element in DocBook.

The title element is similar to the title element in DITA.

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 block title element. The namespace declarations for this definition are on the page Pages.

mal_block_title = element title {
  mal_block_title_attr,
  mal_block_title_inline
}
mal_block_title_attr = (
  attribute style { xsd:NMTOKENS } ?,
  mal_attr_external *
)
mal_block_title_inline = mal_inline