Oxford University Press Text Capture Instructions

 

Names of people and organizations

When requested to do so by another topic in the TCIs, capture names and their role in a nameGrp element and capture the different parts of a name in the appropriate attributes.

FNM

Forename

FAM

Family name

ALTNM

Alternative name

VARNM

Variant name

TITLE

Name title

INST

Institutional names

INST:F

Foreign institutional names

BODY

Association or body

BODY:F

Foreign association or body

 
//nameGrp
//nameGrp/@role

Capture personal names, including titles, in the nameGrp element. The attributes of the nameGrp element pick out the components of the name.

If in doubt as to which content to place in which attributes, ask your contact at OUP.

Where the name is an author, editor or played a similar role in preparing the document, capture their role in the role attribute as one of the following:

  • author
  • partAuthor
  • editor
  • editor in chief
  • translator
  • contributor
  • interviewer
  • interviewee

Additional roles are applied to both the OBO and ODNB products.

The "main name" part of a personal name (mainName attribute) may be underlined in the source document to assist capture. This formatting is used to help identify the value of the mainName attribute, but should not otherwise be preserved in the XML.

Example


      <nameGrp role="author" foreNames="Fred E." mainName="Smith">Smith, Fred E.</nameGrp>

Sub-topics

  1. Name parts in name groups

    Identify parts within a person's name such as descriptive parts, locative parts, and suffixes and capture them within the subsidiaryName attribute.

  2. Linking name groups to A-Z entries

    Within the sense content of an e entry, where a name within a nameGrp matches an entry headword name elsewhere in the content, wrap the nameGrp in an xrefGrp xref link. Where it does not match the entry, do not create a link.

  3. Foretitle in name groups

    Capture a person's status in the foretitle attribute.

  4. Main name (surname) in name groups

    The main name is the family name or surname of a person, as opposed to any given names. Capture the main name in the mainName attribute.

  5. Forenames in name groups

    Capture the remaining part of the name, after the mainName, foreTitle, and subsidiaryName have been identified, in the foreNames attribute. This includes initials.

  6. Alternative names and name variants

    Capture each alternative or variant name using an additional nameGrp with an altType within the main nameGrp. Using the typecode as an indicator, apply a role value of either 'alternative' or 'variant'.

  7. Titles and academic qualifications in name groups

  8. Compound names in name groups

    A compound name is a connecting word such as of in a name like Odard of Bamburgh, where the main name by which the name may be alphabetized follows the word.

  9. Names of organizations in name groups

    Capture the names of companies or other organizations in a nameGrp with attribute nameType="nonPersonal".

  10. Example name captures

    Examples of name captures in nameGrp elements.

Release ID:
20261202
ID:
OUP_Structured_Text_TCI_topic_3_13
Author:
dunnm
Last changed:
Wed, 04 Jun 2025
Modified by:
buckmasm
Revision#:
4400