Skip to main content

Cite

A reference to a CreativeWork that is cited in another CreativeWork.

!array('A ')Cite!array(' node is used within a ')CreativeWork!array(', usually an ')Article!array(', to refer to an other ')CreativeWork!array('. Often a ')Cite!array(' will be associated with other citations, in a ')CiteGroup!array('.')

This schema type is marked as unstable ⚠️ and is subject to change.

Properties#

Name@idTypeDescriptionInherited from
targetstencila:targetstringThe target of the citation (URL or reference ID).Cite
citationIntentstencila:citationIntentArray of CitationIntentEnumerationThe type/s of the citation, both factually and rhetorically.Cite
citationModestencila:citationMode'Parenthetical', 'Narrative', 'NarrativeAuthor', 'NarrativeYear', 'normal', 'suppressAuthor'Determines how the citation is shown within the surrounding text. See note 1.Cite
citationPrefixstencila:citationPrefixstringText to show before the citation. See note 2.Cite
citationSuffixstencila:citationSuffixstringText to show after the citation. See note 3.Cite
contentstencila:contentArray of InlineContentOptional structured content/text of this citation.Cite
idschema:idstringThe identifier for this item.Entity
metastencila:metaobjectMetadata associated with this item.Entity
pageEndschema:pageEndinteger or stringThe page on which the work ends; for example "138" or "xvi".Cite
pageStartschema:pageStartinteger or stringThe page on which the work starts; for example "135" or "xiii".Cite
paginationschema:paginationstringAny description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55".Cite

Notes#

  1. citationMode : !array('There are two main citation modes: parenthetical and narrative (a.k.a textual). See ')!array('https://apastyle.apa.org/style-grammar-guidelines/citations/basic-principles/parenthetical-versus-narrative')!array(' for an explanation.')
  2. citationPrefix : !array('Previously this was name ')prefix!array(' but for consistency with ')citationMode!array(' and ')honorificPrefix!array(', to avoid ambiguity with other prefixes was renamed to ')citationPrefix!array('.')
  3. citationSuffix : !array('See comment on ')citationPrefix!array(' regarding naming.')

Examples#

{
"type": "Article",
"title": "An example of using the Cite node type",
"authors": [
{
"type": "Person",
"givenNames": [
"Joe"
],
"familyNames": [
"Bloggs"
]
}
],
"content": [
{
"type": "Paragraph",
"content": [
"A citation of ",
{
"type": "Cite",
"target": "some-one-else-1991"
},
"."
]
}
],
"references": [
{
"type": "Article",
"id": "some-one-else-1991",
"title": "Another article by someone else",
"authors": [
{
"type": "Person",
"givenNames": [
"Some",
"One"
],
"familyNames": [
"Else"
]
}
],
"datePublished": "1991"
}
]
}

Related#

  • Parent: Entity
  • Descendants: None

Available as#

Source#

This documentation was generated from Cite.schema.yaml.