Shaun McCance
shaunm@gnome.org 2008-2009
Crear un documento de múltiples páginas en sólo diez minutos.

# Tour de diez minutos

shaunm

Esto es un borrador. Aún no estoy contento con el tono.

In this page, we will present how to create a simple multiple-page Mallard document. We will create a document for the fictitious Beanstalk application, which allows you to plant magic beans.

A Mallard document is composed of multiple independent pages. Topic pages present some piece of information to the reader. This might be a tutorial, a conceptual overview, reference material, or any other type of written content. Guide pages serve as the navigational glue between topics, helping readers find and explore content.

We can begin making a Mallard document by writing a front page for our document. Generally, the front page of any document will be a guide page, as its purpose is to help users navigate to other content. In Mallard, the front page of any document is named index.page.

# index.page

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

This simple example is a valid Mallard guide page. Taken alone, it is also a valid Mallard document, although it's rather useless. We can add another page to the document by creating a new page file.

# planting.page

<page xmlns="http://projectmallard.org/1.0/" type="topic" id="planting"> <title>Planting Beans</title> </page>

Notice that we have set the `type` attribute to `"guide"` in index.page and to `"topic"` in planting.page. This specifies that index.page is a guide page, which will allow it to have automatic links to other pages. Currently, we have two standalone pages without interlinking. We can have index.page link to planting.page.

# planting.page

<page xmlns="http://projectmallard.org/1.0/" type="topic" id="planting"> <info> <link type="guide" xref="index"/> </info> <title>Planting Beans</title> </page>
shaunm

Explicar el enlazado e introducir el siguiente ejemplo.

# planting.page

<page xmlns="http://projectmallard.org/1.0/" type="topic" id="planting"> <info> <link type="guide" xref="index"/> </info> <title>Planting Beans</title> <p>By the end of this page, you will be able to plant your magic beans and nurture them into a bean sprout.</p> <steps> <item><p>Dig a hole 5cm deep.</p></item> <item><p>Place your magic beans in the hole.</p></item> <item><p>Fill the hole with clean dirt and pat it level.</p></item> <item><p>Water daily.</p></item> </steps> </page>
shaunm

Rellenar con más contenido.