This page is meant to inform you, the contributor, how best to use the system in order to enter data to a manuscript entity. In Pandit the Manuscript entity type represents a handwritten manuscript (on palm leaves or paper) or any fragment or piece thereof.
Identifiers and names
An identifier of a manuscript contains the information required to identify it. The identifier is either computed by the system or, in special cases, entered manually.
1. Computed identifier [BETA]
The identifier is computed using the formula: [MS Site Institution Collection Shelfmark]
The system computes the identifier if, and only if, values are entered for the following manuscript fields:
- Located in (site)
- Stored in (institution)
Note: Entering a value in "Currently collected in" field is optional and is added to the computed identifier if given.
Note: The system uses the "Short name" field of each of the involved entities (the site, the institution and the collection).
Please make an effort to fill all three fields, so that the system can indeed compute the identifier of the manuscript. Of course, before editing or adding a manuscript entity, you should make sure that all the needed entities that you would like to refer to already exist. Please check this in the following order: State, Site, Institution, and Collection.
2. Manual identifier
If you do not supply values for all 3 fields, then you must supply a value in the "Manual identifier" field. Please use this field only if you have no other choice. If you are sure that the automatically-computed identifier is wrong, you may also supply a manual identifier - this will bypass the computing. (BETA note: if you think that the system actually SHOULD compute the identifier by the values you supply, please contact the managers so we can revise our computing rules).
Note: This field should be used only for the current identifier.
Other identifiers and names
- Former identifier - This field is used in cases where the manuscript previously consisted a part of another collection, or, if it previously belonged to a collection that is not the one set in the "Currently collected in" field.
- Alternative name - This field is used when you want to add a widely known name of a manuscript that is not a former identifier.
(Advanced) Type relationship
For the visual-oriented contributor, we supply here a fraction of the type diagram concerns only the explained above. This is done in order to let you better understand the identifier computing logic and the structure of a manuscript storage. See Type relationships for the general explanation about relationships among types and how to read the diagram and. Note that in this diagram we show not only the name of the type in each box (above the line inside the box) but also the properties of the type (its fields). For these entity types and relationships in their full context see Current class diagram.
[State|*Name : text;Part of : state]->[State], [Site|*Name : text;*Short name : text;State : state (choose the most specific)], [Site]->State[State], [Manuscript|Identifier (computed) : text;Located in : site;Stored in : institution (most specific);Currently collected in : collection;Shelfmark : text;Manual name : text;Aka : text (many);Former identifier : text (many);Also collected in : collection;]->Currently collected in AND Also collected in[Collection], [Collection|*Name : text;*Short name : text;Located in : site (many);Stored in : institution (many)], [Collection]->Stored in[Institution|*Name : text;*Short name : text;Part of : institution;*Located in : site], [Collection]->Located in[Site], [Institution], [Institution]->Located in[Site], [Manuscript]->Stored in[Institution], [Manuscript]->Located in[Site], [Institution]->[Institution]
(Advanced) TEI - Exporting identifier to <msIdentifier> [Planned]
When time arrives, here is how we currently plan to export the data to conform with the TEI Manuscript identifier structure.
The word in bold (on the left) represents the TEI element. The wording following each element indicate where we take the data from, starting from the manuscript entity.
IF (Stored in (institution)->State has parent)
<country> = Located in (site)->State->Parent State->Name
<region> = Located in (site)->State->Name
<country> = Located in (site)->State->Name
(no region in this case)
<settlement> = Located in (site)->Name
<repository> = Stored in (institution)->Name
IF (Stored in (institution) has parent)
<institution> = Stored in (institution)->Parent institution->Name
<institution> = Stored in (institution)->Name (same value as repository)
<collection> = Collected in (collection)->Name
<idno> = Identifier
<altIdentifier> = Former identifier (plural)
<msName> = Alternative name (plural)