Story SGML
PrevNext

names

Name

names -- Elements used to define the story elements name.

Synopsis

Content Model
names ::=
( proper-name, (nick-name|short-name|title-name|last-name|middle-name|first-name)*)
Attributes

Name

Type

Default

fmtNMTOKENNone

Description

The names tag and it's sub tags is used to give names to story elements. A Story Element can have several names, or none at all. When using the name elements one is required to start them (that is use a tag like <nick-name>). Ending them is not required (so one does not have to finish it with </nick-name>).

Each name type has it's own tag as follows:

proper-name

This element is completely optional. Unlike the other name elements, it is not required to start it or end it. It represent the default name of the story element.

nick-name

Is a nick name for the story element.

short-name

A short name for the element. It is similar to the nick name, but this would be how someone calls himself, not what the others call him.

title-name

The title attributed to the person: Mr, Mrs, Prince, King, Lord, etc.

last-name

The last name.

middle-name

The middle name.

first-name

The first name.

Processing expectations

Names will be expanded in references (like in the ref tags), and will also appear when producing a page for that story element. When used in any reference the name will be selected by the fmt attribute. This is handled by the DSSSL transformation drivers. But as a simple example if we have a tag like: <ref id="xx" fmt="nick">, the value of the nick-name will replace the reference in the generated text.

Attributes

fmt

fmt defines the default format to be used when expanding references to the story element that owns these names.

See Also

ref, Element IDs, Element Names and ReferencesIDS, Names, Reference

Examples

The proper-name tag is completely optional so the following SGML: 

<names> Thomas M. Sant'Ana </names>

Is equivalent to:

<names> <proper-name> Thomas M. Sant'Ana  </proper-name> </names>

The other name elements must be started, but need not be ended. So this code: 

<names> Thomas M. Sant'Ana  <short-name> Thomas </names>

Has the same effect as this code: 

<names> 
   <proper-name> Thomas M. Sant'Ana  </proper-name> 
   <short-name> Thomas </short-name> 
</names>

PrevHomeNext
memberUppara