blob: 4de41dee9651f8704dfad85d19d03381a90f242a (
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
63
64
65
66
67
68
69
70
71
72
73
74
75
|
<topic xmlns="http://www.gnome.org/~shaunm/mallard">
<info>
<version number="0.1" date="2007-02-05" status="draft"/>
<credit type="author" name="Shaun McCance" email="shaunm@gnome.org"/>
<copyright year="2007" name="Shaun McCance"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
</info>
<title>Captions</title>
<synopsis><code mime="application/relax-ng-compact-syntax">
mal_caption = element caption {
<link xref="mal_inline">mal_inline</link>+
}
</code></synopsis>
<p>The <code>caption</code> element marks a short text caption at the
bottom of a <link xref="mal_figure">figure</link>. Captions provide
a short textual description of the contents of the figure, often an
image. Captions are simple block elements that can contain all
general <link xref="mal_inline">inline content</link>.</p>
<comment>
<cite name="Shaun McCance" date="2007-02-02"/>
<p>also appears in table</p>
</comment>
<!-- BEGIN examples -->
<section id="examples">
<title>Examples</title>
<p>More exaples of figures can be found on the page <link xref="mal_figure"/>.</p>
<code><![CDATA[
<figure>
<media type="image" mime="image/png" href="figures/mallard.png"/>
<caption>Drake, the Mallard mascot</caption>
</figure>
]]></code>
<figure>
<media type="image" mime="image/png" href="figures/mallard.png"/>
<caption>Drake, the Mallard mascot</caption>
</figure>
<comment>
<cite name="Shaun McCance" date="2007-02-06"/>
<p>Maybe add an example with a non-image figure? Should we even allow these?</p>
</comment>
</section>
<!-- END examples -->
<!-- BEGIN processing -->
<section id="processing">
<title>Processing Expectations</title>
<p>The exact display of a caption will depend on how the enclosing figure is
displayed. A caption is a block of text that should be displayed directly
below the normal contents of the enclosing figure.</p>
<p>Display tools should attempt to display the caption in a way that makes it
clear that it belongs to the enclosing figure. For example, if a display tool
draws a frame around the enclosing figure, it may choose to place the caption
inside that frame. If the figure is indented from its enclosing block, the
caption should also be at the same indentation level.</p>
<p>Captions are typically displayed directly below the normal contents of the
enclosing figure, with very little vertical space above them. If the enclosing
figure contains content other than images, then display tools should be careful
to ensure the caption is not confused with the normal figure content.</p>
</section>
<!-- END processing -->
</topic>
|
