|
|
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)
|
|
|
11.
|
|
|
index.page
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:44(file) C/mal_block_listing.page:89(file)
|
|
|
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)
|
|
|
13.
|
|
|
planting.page
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/tenminutes.page:58(file) C/tenminutes.page:74(file) C/tenminutes.page:92(file)
|
|
|
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)
|
|
|
17.
|
|
|
2009
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/spec.page:14(years) C/mal_inline.page:13(years) C/mal_info_years.page:13(years) C/mal_info_name.page:13(years) C/mal_info_email.page:13(years) C/mal_block_screen.page:13(years) C/links.page:15(years) C/l10n.page:13(years) C/its.page:13(years) C/i18n.page:13(years)
|
|
|
18.
|
|
|
Complete specification of the Mallard XML vocabulary.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
C/spec.page:17(desc)
|
