Bibliographic Reference

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

Schema ID: http://schemas.digitallinguistics.io/BibliographicReference-5.2.0.json

Type: object

Description

A bibliographic Reference

Developer Notes

This is a top-level database object

Schema Definitions

This schema defines the following subschemas for reuse:

  • Person: person

    Type: object

    Description

    An object representing a Person

    Properties

    The following properties are defined for this object:

    • First Name: firstName

      Type: string

      Description

      The first name(s) of this author

    • Last Name: lastName

      Type: string

      Description

      The last name(s) of this author

    Additional Properties

    Any additional properties must adhere to the following schema:

    No values are valid for this schema.

Required Properties

  • title

Properties

The following properties are defined for this object:

  • ID: id

    Description

    A unique database identifier for this Reference

  • Type: type

    Type: string

    Read-only: true

    Description

    The type of object. Must be set to BibliographicReference.

    This item must have the following value:

    "BibliographicReference"
  • Authors: authors

    Type: array

    Description

    An array of authors for this Reference

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Author: authors

    Type: object

    Description

    A Person object representing an author

    Referenced Schema

    This item must validate against the following schema:

    #/definitions/person

  • City: city

    Type: string

    Description

    The city in which this reference was published

  • Digital Object Identifier (DOI): doi

    Type: string

    Description

    The Digtial Object Identifier (DOI) for this publication. This should be just the DOI itself, not a URL, and should not include the doi: prefix (e.g. 10.1075/cal.20.02hie not https://doi.org/10.1075/cal.20.02hie or doi:10.1075/cal.20.02hie).

    Regular expression to match: ^10.\d{4,9}/[-._;()/:A-Za-z0-9]+$

  • Edition: edition

    Type: integer

    Description

    The edition of this Reference, formatted as an integer

    Minimum: 1

  • Editors: editors

    Type: array

    Description

    An array of editors for this Reference

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Editor: editors

    Type: object

    Description

    A Person object representing an editor

    Referenced Schema

    This item must validate against the following schema:

    #/definitions/person

  • Issue: issue

    Type: string

    Description

    The publication issue

  • Pages: pages

    Type: string

    Description

    The page numbers of this Reference

  • Publication: publication

    Type: string

    Description

    The publication where this item was published

  • Publication Type: publicationType

    Type: string

    Description

    The type of publication

    Allowed Values

    • "journal article"
    • "book"
    • "generic"
    • "book section"
    • "conference proceedings"
    • "working paper"
    • "report"
    • "web page"
    • "thesis"
    • "magazine article"
    • "newspaper article"
    • "television broadcast"
    • "encyclopedia article"
    • "film"
  • Publisher (or Institution): publisher

    Type: string

    Description

    The name of the publisher of this reference, or the institution where it was published

  • Series: series

    Type: string

    Description

    The series in which this publication was published

  • Title: title

    Type: string

    Description

    The title of this publication

    Minimum length: 1

  • Translators: translators

    Type: array

    Description

    An array of translators for this Reference

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Translator (Person): translators

    Type: object

    Description

    A Person object representing a translator

    Referenced Schema

    This item must validate against the following schema:

    #/definitions/person

  • URL: url

    Type: string

    Description

    A URL for this Reference

    Format: uri

  • Volume: volume

    Type: integer

    Description

    The volume number for this publication

    Minimum: 1

  • Year: year

    Type: integer

    Description

    The year this item was published. Use a positive integer for AD / ACE, and a negative integer for BC / BCE.

Additional Properties

Any additional properties must adhere to the following schema:

This schema imposes no restrictions. All values are valid.

Examples

The following are example values for this schema:

  • {
      "authors": [
        {
          "firstName": "Daniel W.",
          "lastName": "Hieber"
        }
      ],
      "city": "Amsterdam",
      "doi": "10.1075/cal.20.02hie",
      "editors": [
        {
          "firstName": "Kristel",
          "lastName": "Van Goethem"
        },
        {
          "firstName": "Muriel",
          "lastName": "Norde"
        },
        {
          "firstName": "Evie",
          "lastName": "Coussé"
        },
        {
          "firstName": "Gudrun",
          "lastName": "Vanderbauwhede"
        }
      ],
      "id": "46d3ad45-d1b8-4656-b496-dcb39203c5a9",
      "publication": "Category change from a constructional perspective",
      "publicationType": "book section",
      "publisher": "John Benjamins",
      "series": "Constructional approaches to language",
      "title": "Catgory genesis in Chitimacha",
      "type": "BibliographicReference",
      "url": "https://api.digitallinguistics.io/references/Hieber2018.json",
      "volume": 20,
      "year": 2018
    }
  • {
      "authors": [
        {
          "firstName": "Daniel W.",
          "lastName": "Hieber"
        }
      ],
      "doi": "10.1515/lingty-2013-0013",
      "id": "4b735346-d174-456d-9945-1b00d5ed776b",
      "issue": "2",
      "pages": "15–46",
      "publication": "Linguistic Typology",
      "publicationType": "journal article",
      "title": "On linguistics, linguists, and our times: A linguist’s personal narrative reviewed",
      "type": "BibliographicReference",
      "url": "https://api.digitallinguistics.io/references/Hieber2013.json",
      "year": 2013
    }