Home | Element index | Tree view | Page images | Special topics | Sample Files | Search | FAQ | Questions?

name

The name of a person. For organisations or entities, corporatename should be used.

The correct identification of the parts of names in DTD 4 XML files is very important as it allows the creation of automatic links between articles and from articles to online citation databases when published online. The following rules apply to the markup of names.

General

1. Each separate name must be tagged as a separate name element.
2. An appropriate type attribute must be given to the name element to contextualize the name. Possible values for type are given on the attributes page (link below).
3. Names should be captured as upper- and lower-case, even if they're displayed as all caps.

Forenames/initials/given names

1. The person's forenames (a.k.a. 'given' names) should be tagged with forenames.
2. Forenames in full or initials are all captured in the forenames element.
3. An optional type attribute is available on forenames to identify that the content is initials rather than full names.
4. If initials are displayed with separating full points, the full points can be tagged with the x element within forenames.

Surname/family name

1. The person's surname (a.k.a. 'family' name) should be tagged with surname.
2. Each name element should contain only one surname sub-element.
3. surnameprefix allows the identification of prefixes to an author's name (e.g. 'von', 'de')

Text preceding a name

1. Descriptive titles preceding the person's name ('Mrs', 'Sir', 'Dr', 'Professor' etc.) should be tagged as nametitle.

Text and qualifications following a name

1. Academic qualifications which follow the person's name should be tagged as qualifications.
2. Text indicating ancestry or lineage ('Jr' etc.) should be tagged as pedigree.
3. Occasionally, names are followed by an indication of the person's role (as distinct from a full affiliation paragraph). In these cases, the text indicating the person's role can be tagged as roles.

Other name types

1. alternativename is intended for the markup of an alternative version of an author's name. For an example of its use, see the alternativename page.
2. fullname allows the identification of a person's full name where this cannot be broken down into forename/surname. e.g. a graphic representation of the transliteration into Chinese of an author's name.

Some examples of names and how they should be tagged in DTD 4 XML are given below.

For an example of how to tag the list of authors in e.g. a journal article, see namegroup

Attributes

View name's attributes

Content model

View name's content model

Sub-elements

• alternativename -- alternative version of a name
• br -- line break (%formatting;)
• forenames -- a person's forenames (given names)
• fullname -- the complete name of an author etc.
• link -- a link to another part of a document e.g. to a figure, affiliation or heading ID value
• nametitle -- a title in a name ('Mrs', 'Sir', 'Dr', 'Professor' etc.)
• pedigree -- an author's pedigree or lineage (e.g. 'Jr' or 'III')
• qualifications -- a person's qualifications (e.g. 'PhD')
• roles -- an author's role (e.g. 'Chairman of ...')
• surname -- a person's surname (family name)
• surnameprefix -- the prefix to a surname (e.g. 'von' in 'von Trapp')
• x -- punctuation or significant white space (%formatting;)

Parent elements

• accolade -- a brace spanning table rows
• answer -- the answer in a question and answer section ('questiongroup')
• bookdetails -- book details
• contents -- the contents of a book (BPS) or a table of contents in a document e.g. of headings
• correspondent -- the adddressee for correspondence about an article or document
• definition -- the definition of a term in a definitionpair
• entry -- an entry in a table row
• event -- an event e.g. in a list of events
• feedback -- feedback relating to an answer in an answergroup
• heading -- a heading in a document section
• hint -- a hint associated with a question
• imprint -- the publisher's imprint associated with a book (BPS)
• indexentry -- an entry in an index
• keyword -- a keyword in a keyword group or index entry
• layeredtext -- text in a legend associated with a particular image part
• miscellaneoustext -- text for which a more suitable tag isn't available in an author's details or a reference etc.
• namegroup -- a group or list of names
• p -- a paragraph
• question -- a question in a question group
• reference -- a reference cited in an article
• term -- part of a definition pair
• title -- the title of a document, book or journal etc.

Home | Element index | Tree view | Page images | Special topics | Sample Files | Search | FAQ | Questions?

Created: Tue Dec 23 14:02:01 2003