Entities ID structure

IDs can contain no special characters, umlaut, underdots and other combining diacritics, only digits and Latin characters!

Structure of record IDs

The following principles for the creation of new IDs should be followed for new records:

  • Manuscripts

    • BLadd100 (LIBRARY + collection + shelfmark)

    • BNFabb3 (LIBRARY + collection + shelfmark)

    • EMML2312

    • ESam002 (Ethio-Spare)

  • Works = LIT1001Homili (LIT + incremental number + first word of the title)

  • Places = LOC2969Ensala (LOC + incremental number + first word of the place name)

  • People = PRS1001AbbaTam (PRS + incremental number + first word of the name)

  • Repositories = INS0030Addaqaharsi (INS + 4 digit number + initials or keyword)

  • Art Themes = AT1005Crucifixion (AT + incremental number + title of the art theme)

The manuscript ID should be composed of:

  • The abbreviation of the repository holding the manuscript, as it is contained in the repository ID, written in capitals

  • The abbreviation of the collection to which the manuscript belongs

  • a numeral: BAVet1

The collection and the numeral should be given as they are in the current/most commonly used official shelfmark of the manuscript.

If the manuscript has not yet been catalogued and/or has no shelfmark, an ID has to created individually, following as much as possible the usual process:

  • The abbreviation of the repository holding the manuscript, as it is contained in the repository ID, written in capitals

  • If no more information is available, the ID can be created with a work contained in the manuscript and a numeral, such as: TMChronicle1

Structure of internal xml:ids

An @xml:id can be assigned to any element in a record, to allow direct references to this element both within the same record and from other records. For the elements listed below, the structure of the @xml:id follows a specific pattern. For all other elements the value for @xml:id can be choosen freely. However, it is extremely important that no @xml:id is identical to the @xml:id of the root element <TEI> of any record. This means that the names of records - manuscripts, works, persons, places, keywords etc. - must not used as @xml:id in any record. For example, giving the value "Supplication" to an @xml:id, for example in a manuscript description or a textpart in a work, will lead to problems, because "Supplication" is already the @xml:id of the Authority file Supplication.

Element ID pattern
msPart p\d+[\.\d+]+
msItem p\d+[\.\d+]+_i\d+[\.\d+]+
binding decoNote b\d+
decoNote d\d+
addition a\d+
extra e\d+
quire q\d+
foliation unit fol\d+
hand h\d+
title t\d+
name n\d+
edition ed\d+
transformation tr\d+
Uni\w+ (SdC) Uni\w+\d+ (SdC)

See also Identifiers Structure.

This page is referred to in the following pages

Revisions of this page

  • Pietro Maria Liuzzo on 2018-04-30: first version of guidelines from Wiki
  • Dorothea Reule on 2018-08-03: Addition on diacritics
  • Dorothea Reule on 2022-03-21: Addition on xml:ids