blob: 717e5b0cb2bb275da19281ebe06dca446d93ec57 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
<topic xmlns="http://www.gnome.org/~shaunm/mallard"
id="mal_p">
<info>
<link type="guide" xref="mal_block#simple"/>
</info>
<title>Paragraphs</title>
<synopsis><code mime="application/relax-ng-compact-syntax">
mal_p = element p {
<link xref="mal_attr">mal_attr_common</link>,
<link xref="mal_inline">mal_inline</link>+
}</code></synopsis>
<p>The most basic block-level element in Mallard is the <code>p</code>
element. The <code>p</code> element creates a paragraph in the formatted
outout.</p>
<comment>
<cite><name>Shaun McCance</name><date>2007-01-25</date></cite>
<p>Add some more description.</p>
</comment>
<!-- BEGIN examples -->
<section id="examples" status="tentative">
<title>Examples</title>
<comment>
<cite><name>Shaun McCance</name><date>2007-01-25</date></cite>
<p>Add examples.</p>
</comment>
</section>
<!-- END examples -->
<!-- BEGIN processing -->
<section id="processing" status="tentative">
<title>Processing Expectations</title>
<comment>
<cite><name>Shaun McCance</name><date>2007-01-25</date></cite>
<p>Add processing expectations. Very basic. Mention margins and
indentation as means of demarkating paragraphs. Explicitly mention
the no-block-nesting thing.</p>
</comment>
</section>
<!-- END processing -->
<!-- BEGIN docbook -->
<section id="docbook" status="tentative">
<title>Comparison to DocBook</title>
<p>The <code>p</code> element in Mallard appears to be equivalent to to the
<code href="http://www.docbook.org/tdg/en/html/para.html">para</code> element
in DocBook. While both elements create a paragraph in the formatted output,
the <code>p</code> element in Mallard is actually much more restrictive, as it
does not permit nested block content. In this regard, it is actaully similar
to the <code href="http://www.docbook.org/tdg/en/html/simpara.html">simpara</code>
element in DocBook.</p>
</section>
<!-- END docbook -->
</topic>
|