The info element contains various metadata and information about automatic links for a page or section. Mallard provides a core set of informational elements for most common needs. Informational elements like link, title, and desc are the core of automatic links. Other informational elements record credits, copyrights, revisions, and license information.
Furthermore, Mallard allows elements from external namespaces to be used inside the info element. External-namespace informational elements can be used to record any additional information you need.
The info element contains a mixture of the following, in any order:
An optional desc element.
Any number of credit elements.
Any number of license elements.
Any number of informational link elements.
Any number of informational title elements.
Any number of revision elements.
Any number of elements from an external namespace. There are no restrictions on the contents of these elements. See External Namespaces for more information on external-namespace elements.
The info element can occur as the first element of a page or section element.
The info element can have attributes from external namespaces. See External Namespaces for more information on external-namespace attributes.
The core informational elements are elements that can appear directly inside an info element.
Mallard provides additional elements that allow you to provide structured information inside some informational elements.
Information inside an info element is not displayed directly, although some tools may adjust their formatting or display extra controls or information based on elements in the info element.
Certain informational elements are responsible for automatic links. Pages and sections are displayed with additional links based on this information. See Dynamic Links for more information.
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 info element. The namespace declarations for this definition are on the page Pages.
mal_info = element info {
mal_attr_external *,
( mal_info_desc ? &
mal_info_credit * &
mal_info_license * &
mal_info_link * &
mal_info_title * &
mal_info_revision * &
mal_external *
)
}