1
<page xmlns="http://projectmallard.org/1.0/"
6
<link type="guide" xref="spec"/>
8
<revision version="0.1" date="2009-04-16" status="review"/>
10
<credit type="author">
11
<name>Shaun McCance</name>
12
<email>shaunm@gnome.org</email>
16
<name>Shaun McCance</name>
19
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
21
<desc>Rich semantic elements for marking up inline content.</desc>
24
<title>Inline Elements</title>
26
<synopsis><code mime="application/relax-ng-compact-syntax">
28
<link xref="mal_inline_app">mal_inline_app</link> *,
29
<link xref="mal_inline_cmd">mal_inline_cmd</link> *,
30
<link xref="mal_inline_code">mal_inline_code</link> *,
31
<link xref="mal_inline_em">mal_inline_em</link> *,
32
<link xref="mal_inline_file">mal_inline_file</link> *,
33
<link xref="mal_inline_gui">mal_inline_gui</link> *,
34
<link xref="mal_inline_guiseq">mal_inline_guiseq</link> *,
35
<link xref="mal_inline_input">mal_inline_input</link> *,
36
<link xref="mal_inline_key">mal_inline_key</link> *,
37
<link xref="mal_inline_keyseq">mal_inline_keyseq</link> *,
38
<link xref="mal_inline_link">mal_inline_link</link> *,
39
<link xref="mal_inline_media">mal_inline_media</link> *,
40
<link xref="mal_inline_output">mal_inline_output</link> *,
41
<link xref="mal_inline_span">mal_inline_span</link> *,
42
<link xref="mal_inline_sys">mal_inline_sys</link> *,
43
<link xref="mal_inline_var">mal_inline_var</link> *,
44
element * - (mal:* | local:*) { mal_inline } *
48
<p>Mallard provides a small but rich set of semantic inline elements.
49
The elements provided are culled from first-hand experience with software
50
documentation and other document formats. The inline elements defined in
51
this specification will serve most software documentation writers' needs
54
<p>Authors, editors, or other content producers sometimes need to supply
55
richer information in their documents. While this information may not
56
be conveyed by display tools, it may be used for various internal tracking
57
purposes. Mallard allows elements to be extended with attributes from
58
external namespaces. See <link xref="mal_external"/> for more
61
<p>Furthermore, Mallard allows elements from external namespaces to be
62
used in any inline context. See <link xref="#processing"/> below for
66
<!-- BEGIN elements -->
67
<section id="elements" style="2column">
69
<title type="link">Inline Elements</title>
71
<title>Elements</title>
76
<!-- BEGIN processing -->
77
<section id="processing">
79
<title type="link">Inline Processing Instructions</title>
81
<title>Processing Expectations</title>
83
<p>Inline elements occur within block elements or other inline elements.
84
Mallard never allows block elements within inline elements. Inline elements
85
should never introduce a line break in the rendered output.</p>
87
<p>Different inline elements may introduce different styling effects, such
88
as font variations, text and background colors, and backgrounds. Generally,
89
if a styling effect is set for a particular element, it is in effect for all
90
descendant elements, unless explicitly overridden.</p>
92
<p>Mallard allows elements from external namespaces to be used in any inline
93
context. Processing tools may have special behavior for particular elements
94
they understand. Otherwise, an unknown inline element should be processed
95
as if it were replaced by its child content.</p>
97
<!-- END processing -->