Shaun McCance
shaunm@gnome.org 2008-2009
Provide alternate titles for automatic link text and sorting.

# Informational Tiltes

    mal_info_title = element title {
      attribute type { xsd:NMTOKEN },
      attribute role { xsd:NMTOKEN } ?,
      attribute * - (mal:* | local:*) { text } *,

      mal_inline
    }

Use the `title` element inside an `info` to list alternative titles for pages and sections. These titles can be used as alternative link text, for sorting, or for other application-specific purposes.

# Anmerkungen

The `title` element can contain a mixture of text and any general inline elements.

Das `title`-Element kann in jedem `info`-Element vorkommen.

The `type` attribute specifies what purpose this informational title is serving. The following values are currently recognized:

`"link"` | specifies alternate link text; see
`"sort"` | specifies a sort key; see

The `role` attribute can be used for link titles to specify multiple alternate link texts.

The `title` element can have attributes from external namespaces. See for more information on external-namespace attributes.

# Primary Titles

The primary title of a page or section is the one specified in the block context and used for display purpose. While this title is not an informational title as specified here, it is used as fallback for all informational titles.

# Link Titles

Pages and sections can have multiple link titles. These are used as alternate content for automatic link text. When automatic text must be generated for a `link` element, it is taken first from the link titles, falling back to the primary title if no suitable link title is found.

You can use the `role` attribute to specify multiple link titles. These can be selected using the `role` attribute of the `link` element. This can be used for a variety of purposes. One common purpose is to specify link text for different parts of speech in languages which have case declensions. Without this feature, it can be difficult to provide grammatically correct automatic link text in some languages.

# Sort Titles

Sort titles allow you to specify alternate text to be used when sorting the page or section. Certain automatic link sections will sort the nodes they link to. When this happens, providing a sort title allows you to control how the node is collated. This is useful for excluding leading articles such as “an” and “the”.

# Processing Expectations

Informational titles are not displayed directly, although they will affect the output of any material which links to the given page or section.

The content model of the `info` element allows for any mixture of informational titles. As such, it is entirely possible for multiple titles to exist for some specified combination of the `type` and `role` attributes. When such an ambiguity arrises, processing tools should select the first informational title that matches the desired criteria.