|
4.
|
|
|
Create a multiple-page document in only ten minutes.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:17(desc)
|
|
7.
|
|
|
This is draft material. I'm not happy with the tone yet.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:24(p)
|
|
8.
|
|
|
In this page, we will present how to create a simple multiple-page Mallard document. We will create a document for the fictitious <app>Beanstalk</app> application, which allows you to plant magic beans.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:27(p)
|
|
9.
|
|
|
A Mallard document is composed of multiple independent pages. <link xref="mal_page#topic">Topic pages</link> 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. <link xref="mal_page#guide">Guide pages</link> serve as the navigational glue between topics, helping readers find and explore content.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:31(p)
|
|
10.
|
|
|
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 <file>index.page</file>.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:38(p)
|
|
12.
|
|
|
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.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:53(p)
|
|
14.
|
|
|
Notice that we have set the <code>type</code> attribute to <code>"guide"</code> in <file>index.page</file> and to <code>"topic"</code> in <file>planting.page</file>. This specifies that <file>index.page</file> 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 <file>index.page</file> link to <file>planting.page</file>.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:67(p)
|
|
15.
|
|
|
Explain the linking and introduce the next example.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:88(p)
|
|
16.
|
|
|
Fill in more content.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:114(p)
|
|
18.
|
|
|
Complete specification of the Mallard XML vocabulary.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/spec.page:17(desc)
|