Shaun McCance
shaunm@gnome.org 2008-2009
Erstellen Sie ein mehrseitiges Dokument in nur zehn Minuten.

# Zehn-Minuten-Tour

shaunm

Dies ist ein Entwurf. Ich bin noch nicht wirklich zufrieden damit.

In dieser Seite führen wir vor, wie ein einfaches mehrseitiges Mallard-Dokument erstellt wird. Wir erstellen ein Dokument für eine fiktive Beanstalk-Anwendung, welche zum Anbau magischer Bohnen dient.

Ein Mallard-Dokument wird aus mehreren voneinander unabhängigen Seiten gebildet. Themenseiten bietet dem Leser einige Informationen. Das kann eine Schritt-für-Schritt-Anleitung sein, ein Überblick über das Konzept, Referenzmaterial oder jede andere Art geschriebenen Inhalts. Anleitungsseiten fungieren als Verbindungsglied für die Navigation innerhalb der verschiedenen Themen, die dem Leser das Auffinden und Entdecken des Inhalts ermöglichen.

Wir können mit der Erstellung eines Mallard-Dokuments beginnen, indem wir zunächst dessen Titelseite schreiben. Generell wird diese Titelseite eine Anleitungsseite sein, die dem Benutzer dabei hilft, durch das Dokument zu navigieren. In Mallard erhält die Titelseite jedes Dokuments den Namen index.page.

# index.page

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

Dieses einfache Beispiel ist eine gültige Mallard-Anleitungsseite. Für sich allein betrachtet stellt sie selbst ein gültiges Mallard-Dokument dar, allerdings ein recht nutzloses. Wir können eine weitere Seite zum Dokument hinzufügen, indem wir eine weitere Seitendatei erstellen.

# planting.page

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

Beachten Sie, dass wir das `type`-Attribut in index.page auf `"guide"` gesetzt haben und in planting.page auf `"topic"`. Dies legt fest, dass index.page eine Anleitungsseite ist, was bewirkt, dass sie automatische Links zu anderen Seiten haben kann. Gegenwärtig haben wir zwei allein stehende Seiten, die nicht untereinander verlinkt sind. Wir können index.page mit planting.page verlinken.

# 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

Explain the linking and introduce the next example.

# 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

Fill in more content.