Schema Documentation: the name element

On this page:

Back to
main menu
Usage Example
Allowed parents
Allowed children
Content model and additional requirements
Namespace
Usage Details

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 (bibliography variant), entry (glossary variant), entry (index variant), entry (toc 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, 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

optionally the following 2 co-ocurring attributes: @ssml:alphabet and @ssml:ph

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:

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.

The name element