• Introduction
• Why Mallard?
• About this book
• About Mallard
• Pre-requisites
• Comparing Mallard to other tools
• Projects that use Mallard
• Core Mallard
• Mallard in action
• Basic concepts
• Guide pages
• Topic pages
• Basic tutorial
• Integration
• Integration requirements
• Yelp
• Yelp tools
• Build system integration
• Context-sensitive help
• Extended Mallard
• Pages and sections
• Information element
• Linking pages
• Titles
• Page descriptions
• Block elements
• Inline elements
• Editorial comments
• Lists
• Tables
• style attribute
• XInclude
• Namespaces
• Appendix
• Further resources

Page descriptions

About

Use the <desc> element to provide a short description for a page or section. This description is generally not shown on the page itself, but is used in automatic links to the page or section.

Examples 

Use the <desc> element to show a short description of the topic on guide pages:

<info>
  <desc>Use applications and the desktop without a mouse.</desc>
</info>

<title>Keyboard navigation</title>

Short description of the Keyboard navigation page

Using <desc> to create links to sub-topics in a guide page:

<info>
  <desc>
    <link xref="keyboard">Keyboard</link>,
    <link xref="mouse">mouse</link>,
    <link xref="prefs-display">display</link>,
    <link xref="prefs-language">languages</link>,
    <link xref="user-accounts">user accounts…</link>
  </desc>
</info>

<title>User &amp; system settings</title>

Sub-topics on a guide page