Text

Validate against: http://json-schema.org/schema#

Description

A text is the fundamental unit of documentation. It represents a linguistic performance of a stretch of discourse in context. This may include a wide variety of linguistic genres: an elicitation session, a conversation, a narrative, a song, etc. In technical terms, a text is an interlinearized set of utterances with one or more transcriptions, translations, and optionally Leipzig-style glosses.

Type: object

Required Properties

  • title
  • utterances

Additional properties: true

Properties

  • Type: "type"

    Description

    The type of object. Must be set to Text.

    Type: string

  • ID: "id"

    Description

    A unique database identifier for this Text

  • Abbreviation: "abbreviation"

    Description

    An abbreviation for this Text

    Must be an instance of the Abbreviation schema.

  • Access Rights: "access"

    Description

    An object describing the acess rights to this Text

    Must be an instance of the Access schema.

  • Annotations: "annotations"

    Description

    A collection of annotations on this text

    Type: array

    Unique items: true

    Items

    Annotation

    Description

    An annotation on this text

    Must be an instance of the Annotation schema.

  • Contributors (People): "contributors"

    Description

    A collection of people who contributed to the creation or analysis of this text in some way. This should miniimally include the speaker(s) who produced the text.

    Type: array

    Items

    Contributor (Person - DatabaseReference)

    Description

    A database reference to a Person object that describes this contributor.

    Must be an instance of the DatabaseReference schema.

  • Date Created: "dateCreated"

    Description

    The date and optionally time that this Text was created in the database (not the date it was recorded; see the dateRecorded property instead)

    Type: string

    Validates Against (oneOf)

    This schema must validate against one and only one of the following schemas:

    • Format: date

    • Format: date-time

  • Date Modified: "dateModified"

    Description

    The date and optionally time that this Text object was last modified (not the date that the recording of the text was modified)

    Type: string

    Validates Against (oneOf)

    This schema must validate against one and only one of the following schemas:

    • Format: date

    • Format: date-time

  • Date Recorded: "dateRecorded"

    Description

    The date and optionally time that this text was recorded

    Type: string

    Validates Against (oneOf)

    This schema must validate against one and only one of the following schemas:

    • Format: date

    • Format: date-time

  • Discourse Type: "discourseType"

    Description

    The type of discourse event, e.g. monologue, dialogue, or song

    Type: string

  • Genre: "genre"

    Description

    The genre of the text, e.g. folktale, personal narrative, or expository

    Type: string

  • Link: "link"

    Description

    A URL where a presentational format for this resource may be viewed

    Type: string

    Format: uri

  • Location: "location"

    Description

    A database reference to the location where this text was recorded

    Must be an instance of the DatabaseReference schema.

  • Media: "media"

    Description

    An array of objects containing information about the media files associated with this Text. Usually this will include the WAV or video file that was originally recorded for the text, but can also include any derivative media files (such as MP3) as well. Media associated with a text are automatically considered to be part of the same database bundle as the Text.

    Type: array

    Unique items: true

    Items

    Media Items (Database Reference)

    Description

    A database reference to an object describing a media file

    Must be an instance of the DatabaseReference schema.

  • Notes: "notes"

    Description

    A collection of notes about this Text

    Type: array

    Unique items: true

    Items

    Note

    Description

    A Note object

    Must be an instance of the Note schema.

  • References: "references"

    Description

    A list of any bibliographic references concerning or relating to this Text

    Type: array

    Items

    Reference

    Description

    A bibliographic reference about this text

    Must be an instance of the BibliographicReference schema.

  • Tags: "tags"

    Description

    A set of tags associated with this Text

    Must be an instance of the Tags schema.

  • Title: "title"

    Description

    A title is a human-readable prose description of the content of the Text. The title object contains all the titles of the text, in one or more languages (at least one must be provided). Each attribute in the title object should be the abbreviation of a language, and its value should be the title of the text in that language.

    Must be an instance of the MultiLangString schema.

  • URL: "url"

    Description

    The URL where this data can be retrieved in JSON format

    Type: string

    Format: uri

  • Utterance: "utterances"

    Description

    A collection of all the Utterances contained in this Text. The DLx specification imposes no requirements regarding how the linguist should segment the text into Utterances. The linguist may decide to segment their text based on intonation units, turns, or any other appropriate linguistic subdivision. The order of Utterances in the collection must reflect their actual order in the Text. Utterances do not have to be JSON unique - an Utterance may be repeated in a text. However, utterances are conceptually unique: each utterance represents a different token of speech.

    Type: array

    Min items: 1

    Items

    Utterance

    Description

    An Utterance object

    Must be an instance of the Utterance schema.