Schema Documentation - Newsfeed Aggregator Profile
version 1.0

The phrase variant of the annotation element

On this page:

The annotation element represents an annotation that an author, editor, publisher, or other individual or agency has added to a document.

The inline inclusion of annotation elements does not influence the rendering of the annotations or reflect their appearance in a print medium; inlining allows annotations to be included as close to their referenced element as is desired. It is equally valid for Block-layer annotations to reference inline elements.

Unless an annotation element has a role value of temporary, it must reference at least one element in the document using the ref attribute or be referenced by at least one annoref . For annotations that apply to more than one element, use a space-separated list of xml:id values in the ref attribute.

The ref attribute identifies the specific element(s) being annotated by referencing their xml:id values.

The annotation element should not be used to add descriptions, footnotes or endnotes. Refer to the description and note elements for more information.

Usage Example

<verse>
    <ln xml:id="bw_1">Famed was this Beowulf:
        <annotation ref="bw_1">Not, of course, Beowulf the Great, hero of the epic.</annotation>
    </ln>            
    <ln>far flew the boast of him,</ln>
</verse>

Allowed parents

address, annotation (block variant), annotation (phrase variant), block, byline, caption, citation (block variant), citation (phrase variant), dateline, definition, description (block variant), description (phrase variant), item, ln, lngroup, d:longdesc, meta, object (block variant), object (phrase variant), p, quote (block variant), quote (phrase variant), its:rb, its:rt, s, d:simplifiedLanguageDescription, span, d:summary, td, th and d:tour

Allowed children

This element may contain text.

This element may contain the following children: abbr, address, annoref, annotation, citation, code, definition, emph (text variant), emph (phrase variant), expansion, ln, name, num, object (text variant), object (phrase variant), quote, ref, its:ruby, s, span (text variant), span (phrase variant), sub, sup, term, time and w

Content model and additional requirements

optional attributes: @about, @by, @class, @content, @datatype, @desc, @its:dir, @its:translate, @property, @ref, @rel, @resource, @rev, @role, @typeof, @xml:base, @xml:id, @xml:lang and @xml:space
one or more of
a choice of
either one of the 27 elements: abbr, address, annoref, annotation, citation, code, definition, emph, emph, expansion, its:ruby, ln, name, num, object, object, quote, ref, s, span, span, sub, sup, term, time, w or w
or text
end of choice
Note that in addition to restrictions presented in the content model above, use of this element must also respect the following requirements:
  • The annotation element must be referenced by an annoref or reference another element in the document unless it has the role value temporary.
  • The annotation element must neither be empty nor contain only whitespace.
  • Annotations with a role value of temporary must be removed prior to document finalization.
Such requirements take precedence over any conflicting statements in the content model or in the lists above of allowed children and parents.

Variants

This element exists in 2 variants. The other variant is the block variant.

Namespace

http://www.daisy.org/ns/z3998/authoring/