Preliminaries
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14, RFC2119 and RFC8174 when, and only when, they appear in all capitals, as shown here.
This document is licensed under CC-BY-ND-4.0 (via SPDX).
The style of this documentation is adapted from OpenAPI 3.0.2 specification.
Status of this Document
The current version of this document is 0.0.1
according
to Semantic Versioning 2.0.0.
As long as the version number is not increased to 1.0.0
this document is
considered to be an early draft and major changes MAY be implemented over night and
without any announcement.
Definitions
Cardinalities
Cardinality | Description | REQUIRED |
---|---|---|
1 | exactly one | yes |
+ | one or more | yes |
? | zero or one | no |
* | zero or more | no |
Data Types
Type | Description |
---|---|
[…] | array |
string | a sequence of characters, MAY be empty |
URI | a valid URI, see URI Syntax |
iso3166-2 | alpha-2 country code according to ISO 3166 alpha-2 |
Module Schema
If you decide to use this schema, make sure to set at least all required fields. Register the module in your main TextAPI in the Module Object.
This module claims the prefix em-
.
Collection Object
The following fields MAY
be added to a Collection Object describing e.g. an edition comprising one or more manuscripts.
Caution: em-editor
is required.
Field Name | Cardinality | Type | Description |
---|---|---|---|
em-editor | + | [Actor Object] | a personal entity responsible for the edition (editor) |
em-funder | * | [Actor Object] | an entity responsible for funding the project in which the text(s) in focus is/are edited (funder) |
Manifest Object
The following fields MAY
be added to a Manifest Object describing a manuscript or fragment.
Caution: em-identifier
is required.
Field Name | Cardinality | Type | Description |
---|---|---|---|
em-origin | ? | string | the origin of the manuscript. MAY also comprise full provenence information. |
em-identifier | 1 | string | the identifier of the manuscript, e.g. a shelfmark |
em-textClass | * | string | a term classifying the text’s genre(s) or category/categories, preferably taken from a controlled vocabulary |
Repository Object
The following fields MUST
be added to a Repository Object describing the current location of the manuscript:
Field Name | Cardinality | Type | Description |
---|---|---|---|
em-repoCountry | 1 | iso3166-2 | the country in which the repository is located as ISO 3166 alpha-2 code, e.g. DE for Germany |
em-repoPlace | 1 | string | the name of a settlement, e.g. city or village, in which the repository in focus is located |