Bibliographic Source

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

Schema ID: http://schemas.digitallinguistics.io/BibliographicSource-1.0.0.json

Type: object

Description

A bibliographic source, such as a book or journal article

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 bibliographic source

  • Type: type

    Type: string

    Read-only: true

    Description

    The type of object. Must be set to BibliographicSource.

    This item must have the following value:

    "BibliographicSource"

  • Authors: authors

    Type: array

    Description

    An array of authors for this bibliographic source

    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

  • Citation Key: citationKey

    Description

    A citation key which must be a valid Abbreviation. This field can be used by bibliographic reference management software like Mendeley or Zotero to store the citation key for a source.

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Abbreviation.json

  • City: city

    Type: string

    Description

    The city in which this bibliographic source 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 publication, formatted as an integer

    Minimum: 1

  • Editors: editors

    Type: array

    Description

    An array of editors for this bibliographic source

    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

  • Link: link

    Type: string

    Description

    A link to a web page where this publication may be viewed or downloaded

    Format: uri

  • Pages: pages

    Type: string

    Description

    The page numbers of this publication

  • Publication: publication

    Type: string

    Description

    The publication that this bibliographic source is published in

  • 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 soruce, 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 bibliographic source

    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

  • JSON URL: url

    Type: string

    Description

    A URL for the JSON data for this bibliographic source

    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"
    }
  ],
  "citationKey": "Hieber2018",
  "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": "Category genesis in Chitimacha",
  "type": "BibliographicSource",
  "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",
  "link": "https://benjamins.com/catalog/cal.20.02hie",
  "pages": "15–46",
  "publication": "Linguistic Typology",
  "publicationType": "journal article",
  "title": "On linguistics, linguists, and our times: A linguist’s personal narrative reviewed",
  "type": "BibliographicSource",
  "url": "https://api.digitallinguistics.io/references/Hieber2013.json",
  "year": 2013
}