The
name
element represents particular instances of names, places and things (proper nouns).
The
role
attribute optionally expresses the semantic nature of the proper noun. No implicit value is associated with the
name
element.
Usage details available in the Usage Details section.
Usage Example
AFTER having been twice driven back by heavy south-western gales, Her Majesty's ship <name>Beagle</name>,
a ten-gun brig, under the command of
<name role="personal-name"><span role="name-title">Captain</span> <span role="family-name">Fitz Roy</span></name> …
Allowed parents
annoref,
annotation (block variant),
annotation (phrase variant),
m:annotation-xml,
aside,
block,
caption,
citation (block variant),
citation (phrase variant),
d,
definition,
description (block variant),
description (phrase variant),
emph,
expansion,
h,
hd,
hpart,
item,
ln,
d:longdesc,
meta,
note (block variant),
note (phrase variant),
noteref,
object (block variant),
object (phrase variant),
p,
ssml:phoneme,
ssml:prosody,
quote (block variant),
quote (phrase variant),
its:rb,
ref,
its:rt,
s,
ssml:say-as (phrase variant),
ssml:say-as (text variant),
d:simplifiedLanguageDescription,
span,
ssml:sub,
d:summary,
td,
term,
th and
d:tour
Allowed children
This element may contain text.
This element may contain the following children: abbr,
ssml:break,
char,
emph,
object,
ssml:phoneme,
ssml:prosody,
its:ruby,
ssml:say-as,
span,
sub,
ssml:sub,
sup and
ssml:token
Content model and additional requirements
optional attributes:
@about,
@by,
@class,
@content,
@datatype,
@desc,
@its:dir,
@its:translate,
@property,
@rel,
@resource,
@rev,
@role,
@ssml:onlangfailure,
@typeof,
@xml:base,
@xml:id,
@xml:lang and
@xml:space
one or more of
a choice of either one of the 15 elements:
abbr,
char,
emph,
its:ruby,
object,
span,
span,
ssml:break,
ssml:phoneme,
ssml:prosody,
ssml:say-as,
ssml:sub,
ssml:token,
sub or
sup
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 requirement:
- The
name
element must neither be empty nor contain only whitespace.
Such requirements take precedence over any conflicting statements in the
content model or in the lists above of allowed children and parents.
Namespace
http://www.daisy.org/ns/z3998/authoring/
Usage Details
Personal name markup
In order to specify that a
name
represents a personal name, the
personal-name property from the Z39.98 Structural Semantics Vocabulary is used.
The Z39.98 Structural Semantics Vocabulary further contains a set of properties related to
name components, supporting the representation of honorary titles, given and family names. The following example shows how to represent three
typical components of a personal name:
<name role="personal-name">
<span role="given-name">CHARLES</span>
<span role="family-name">DARWIN</span>,
<span role="name-title">ESQ</span>
</name>
(Note also that the name components in the Z39.98 Structural Semantics Vocabulary are explicitly equivalent to properties
in the
FOAF vocabulary.)
Proper noun markup
The
name
element can be used to represent any proper noun, for example for:
The above example are not meant to present an exhaustive listing of proper nouns, or all available values for specifying.
Where a role value is not available and necessary for a document type, the inherent extensibility of the
role
attribute can be extended to accommodate.