CSL JSON/YAML

Type: array

JSON schema for CSL input data

Each item of this array must be:

Type: object

Type: enum (of string)

Must be one of:

  • "article"
  • "article-journal"
  • "article-magazine"
  • "article-newspaper"
  • "bill"
  • "book"
  • "broadcast"
  • "chapter"
  • "classic"
  • "collection"
  • "dataset"
  • "document"
  • "entry"
  • "entry-dictionary"
  • "entry-encyclopedia"
  • "figure"
  • "graphic"
  • "hearing"
  • "interview"
  • "legal_case"
  • "legislation"
  • "manuscript"
  • "map"
  • "motion_picture"
  • "musical_score"
  • "pamphlet"
  • "paper-conference"
  • "patent"
  • "performance"
  • "periodical"
  • "personal_communication"
  • "post"
  • "post-weblog"
  • "regulation"
  • "report"
  • "review"
  • "review-book"
  • "software"
  • "song"
  • "speech"
  • "standard"
  • "thesis"
  • "treaty"
  • "webpage"

Type: string or number

Type: array of string

Each item of this array must be:

Type: string

Type: string

Type: string

Type: string

Type: array

Each item of this array must be:

Type: object

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string, number or boolean

Type: string, number or boolean

Type: string

Type: string, number or boolean

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

[Deprecated - Use original related author property instead]

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

Each item of this array must be:

Type: array

[Deprecated - Use reviewed related author property instead]

Each item of this array must be:

Type: array

Each item of this array must be:

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Type: string

CSL input supports EDTF, levels 0 and 1.

Must match regular expression: ^[0-9-%~X?./]{4,}$

Can either be an object, or a two-item array.

An EDTF date represented as an object. Seasons can be represented using the 21-24 month values of EDTF, decades and centuries using the X notation, and the qualifiers with the included boolean properties

Type: object

The following properties are required:

  • year
Type: object

The following properties are required:

  • undefined

Example:

{
    "id": "one",
    "type": "book",
    "title": "The Title",
    "issued": {
        "year": 2000,
        "month": 3,
        "day": 10
    },
    "approximate": "true"
}

Type: integer

A year; can be negative.


Examples:

"2012"
"-32"

Type: integer

A month; can also represent seasons using the EDTF 21-24 values.


Examples:

"2"
"22"

Type: integer

Type: string

A date that should be passed through to the processor as is; for dates that cannot be represented in EDTF.


Example:

"Han Dynasty"

Type: boolean

Indicates an approximate or circa date, which may be presented as circa May 23, 1972.

Type: boolean

Indicates uncertainty about a date representation, which may be presented as May 23, 1972?

Type: boolean

Use to represent an open end of a range.

Type: array

An EDTF range is a two-item array. An open end or beginning of a range can be represented with an empty (date) object.

Must contain a minimum of 2 items

Must contain a maximum of 2 items

Each item of this array must be:

An EDTF date represented as an object. Seasons can be represented using the 21-24 month values of EDTF, decades and centuries using the X notation, and the qualifiers with the included boolean properties

Same definition as items_accessed_oneOf_i1_oneOf_i0

Examples:

{
    "id": "range-1",
    "type": "book",
    "title": "The Title",
    "issued": [
        {
            "year": 2000
        },
        {
            "year": 2001
        }
    ]
}
{
    "id": "range-2",
    "type": "book",
    "title": "The Title",
    "issued": [
        {
            "year": 2000
        },
        {
            "undefined": true
        }
    ]
}

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Same definition as items_accessed

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Same definition as items_accessed

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Same definition as items_accessed

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Same definition as items_accessed

[Deprecated - Use original related date property instead]

Same definition as items_accessed

The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.

Same definition as items_accessed

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string or number

Type: string or number

Type: string

Type: string or number

Type: object

Titles are represented as an object.


Examples:

{
    "full": "Finis Coronat Opus: A Curious Reciprocity; Shelley’s “When the Lamp Is Shattered”",
    "main": "Finis Coronat Opus",
    "sub": "A Curious Reciprocity",
    "sub-sub": "Shelley’s “When the Lamp Is Shattered”"
}
{
    "main": "Whose Music?",
    "sub": "A Sociology of Musical Language"
}
{
    "main": "Pardon the Interruption",
    "sub": "Goal Proximity, Perceived Spare Time, and Impatience"
}
{
    "main": "England’s Monitor",
    "alt": "The History of the Separation"
}
{
    "main": "Kriegstagebuch des Oberkommandos der Wehrmacht, 1940–1945",
    "short": "Kriegstagebuch"
}

Type: string

The full title string for the item; should generally be redundant, as it's simply the main + the sub titles and/or alternate title.

The primary title component for the item.

Same definition as items_collection-title_full

The sub-title component for the item.

Same definition as items_collection-title_full

The secondary subtitle component for the item. This is rarely used in practice, but see https://style.mla.org/punctuation-with-titles/.

Same definition as items_collection-title_full

An alternative variant title. This is rarely used in practice, but see https://style.mla.org/punctuation-with-titles/.

Same definition as items_collection-title_full

A short variant title component for the item.

Same definition as items_collection-title_full

Titles are represented as an object.

Same definition as items_collection-title

Type: string

Type: string

Type: string

Type: string or number

Type: string

Type: string

Type: string or number

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string

Type: string or number

Type: string

Type: string

Type: string or number

Type: string

Type: string

Type: string or number

Type: string or number

Type: string or number

Type: string

[Deprecated - Use original related publisher property instead]

Type: string

[Deprecated - Use original related publisher-place property instead]

[Deprecated - Use original related title property instead]

Same definition as items_collection-title

Type: string or number

Type: string or number

Type: string or number

Type: string

Type: string

Type: string

Type: string or number

Type: string

Type: string

Type: string

Type: string

[Deprecated - Use reviewed related title property instead]

Type: string

Type: string

Type: string

Type: string

Type: string or number

Titles are represented as an object.

Same definition as items_collection-title

Titles are represented as an object.

Same definition as items_collection-title

Type: string

Type: string

Type: string or number

Type: string

Type: object

Used to store additional information that does not have a designated CSL JSON field. The note field can also store additional information, but custom is preferred for storing key-value pairs.


Examples:

{
    "short_id": "xyz",
    "other-ids": [
        "alternative-id"
    ]
}
{
    "metadata-double-checked": true
}