xml.schema.z3998-book-1.0-latest.schemadoc.subfiles.e-description04.html Maven / Gradle / Ivy
Schema Documentation: the description element
The description element
On this page:
The
description element is the root container element for a description. It consists of an optional container element for metadata information
(the
head
) and a required container for the different description types and alternate image renditions (the
body
).
The language of the description can be specified by attaching an
xml:lang
attribute to the
description element. If the description will be made available in a standalone context (i.e., in which its language cannot be inherited
from a host content document), the language should always be specified.
The
DIAGRAM Description profile provides the ability to compile one or more
description elements into a single document for distribution (e.g., to accompany an EPUB).
When storing a description in a standalone context, the Description feature namespace
http://www.daisy.org/ns/z3998/authoring/features/description/ should be declared on the
description element using the xmlns namespace association mechanism defined in
XMLNAMES
. Although not required, the prefix
d is recommended.
Usage Example
<d:description xml:lang="en">
<d:head>
<meta property="dc:identifier" content="water-cycle" />
<meta property="diagram:targetAge" content="9-12" />
<meta property="diagram:targetGrade" content="4-7" />
</d:head>
<d:body>
<d:longdesc>
…
</d:longdesc>
</d:body>
</d:description>
Allowed parents
address,
annotation,
m:annotation-xml,
aside (block variant),
aside (toc variant),
backcover,
block,
caption,
entry (bibliography variant),
entry (glossary variant),
flaps,
frontcover,
item,
d:longdesc,
note (block variant),
note (phrase variant),
sel:otherwise,
quote,
section,
d:simplifiedLanguageDescription,
td,
th,
d:tour and
sel:when
Allowed children
This element must not contain text.
This element must contain the following children: d:body
This element may contain the following children: d:head
Content model
Namespace
http://www.daisy.org/ns/z3998/authoring/features/description/