xml.schema.z3998-book-1.0-latest.schemadoc.subfiles.e-name01.html Maven / Gradle / Ivy
Schema Documentation: the name element
The name element
On this page:
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
address,
annoref,
annotation (block variant),
annotation (phrase variant),
m:annotation-xml,
aside (block variant),
aside (toc variant),
block,
caption,
citation (block variant),
citation (phrase variant),
d,
definition,
description (block variant),
description (phrase variant),
emph,
entry (toc variant),
entry (index variant),
entry (bibliography variant),
entry (glossary variant),
expansion,
xforms:group,
h,
hd,
hpart,
item,
xforms:label,
ln,
d:longdesc,
meta,
note (block variant),
note (phrase variant),
noteref,
object (block variant),
object (phrase variant),
sel:otherwise,
p,
ssml:phoneme,
ssml:prosody,
quote (block variant),
quote (phrase variant),
its:rb,
ref,
xforms:repeat,
its:rt,
s,
ssml:say-as (phrase variant),
ssml:say-as (text variant),
d:simplifiedLanguageDescription,
span,
spine,
ssml:sub,
d:summary,
td,
term,
th,
d:tour and
sel:when
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,
@sel:selid,
@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 textend 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:
-
Places
this tendency has been found incurable in dogs which have been brought home as
puppies from countries, such as <name role="place">Tierra del Fuego</name> …
-
Nationalities
What <name role="nationality">English</name> breeders have actually effected is
proved by the enormous prices given for animals with a good pedigree …
-
Organizations
I have associated with several eminent fanciers, and have been permitted to join two
of the <name role="organization">London Pigeon Clubs</name>.
-
Taxonomic Classifications
I am fully convinced that the common opinion of naturalists is correct, namely,
that all have descended from the rock-pigeon (<name role="taxonomy">Columba livia</name>) …
-
Events
so that the latter, by the regulations for the <name role="event">Goodwood Races</name>,
are favoured in the weights they carry …
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.