JSON schema for CSL input data
The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.
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
{ "id": "one", "type": "book", "title": "The Title", "issued": { "year": 2000, "month": 3, "day": 10 }, "approximate": "true" }
A year; can be negative.
"2012"
"-32"
A month; can also represent seasons using the EDTF 21-24 values.
"2"
"22"
A date that should be passed through to the processor as is; for dates that cannot be represented in EDTF.
"Han Dynasty"
Indicates an approximate or circa date, which may be presented as circa May 23, 1972
.
Indicates uncertainty about a date representation, which may be presented as May 23, 1972?
Use to represent an open end of a range.
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
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{ "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_accessedThe CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.
Same definition as items_accessedThe CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.
Same definition as items_accessedThe 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]
The CSL input model supports two different date representations: an EDTF string (preferred), and a more structured alternative.
Same definition as items_accessedTitles are represented as an object.
{ "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" }
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_fullThe sub-title component for the item.
Same definition as items_collection-title_fullThe 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_fullAn alternative variant title. This is rarely used in practice, but see https://style.mla.org/punctuation-with-titles/.
Same definition as items_collection-title_fullA short variant title component for the item.
Same definition as items_collection-title_fullTitles are represented as an object.
Same definition as items_collection-title[Deprecated - Use original
related publisher
property instead]
[Deprecated - Use original
related publisher-place
property instead]
[Deprecated - Use original
related title
property instead]
[Deprecated - Use reviewed
related title
property instead]
Titles are represented as an object.
Same definition as items_collection-titleTitles are represented as an object.
Same definition as items_collection-titleUsed 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.
{ "short_id": "xyz", "other-ids": [ "alternative-id" ] }
{ "metadata-double-checked": true }