• 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

XInclude

About

XInclude is a mechanism for merging one XML document into another, which is particularly useful if you reuse the same text in a number of pages. Mallard offers full XInclude support.

You must have a complete and validated file to be included. In the container file, use the include tag to add the file name of the included file and the namespace XInclude, from the URL http://www.w3.org/2001/XInclude.

For build integration, you must add the included file to the Makefile.am.

For example, you can place your license in a separate document and include that file in all of your pages.

Examples

index.page

<page xmlns="http://projectmallard.org/1.0/"
      type="guide"
      id="index">

  <info>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Write Mallard help</title>

</page>

legal.xml

<license xmlns="http://projectmallard.org/1.0/"
         href="http://creativecommons.org/licenses/by-sa/3.0/">

  <p>This work is licensed under a
  <link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons
  Attribution-ShareAlike 3.0 Unported License</link>.</p>

</license>