Skip to main content

Cite

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

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

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 : There are two main citation modes: parenthetical and narrative (a.k.a textual). See https://apastyle.apa.org/style-grammar-guidelines/citations/basic-principles/parenthetical-versus-narrative for an explanation. This property is optional and tools are recommended to assume parenthetical if missing. Narrative citations will usually be of form "As noted by Smith (1992)," but narrative-author allows for "In the early nineties, Smith noted" and narrative-year allows for "As noted by Smith in 1992 and 1993". Pandoc's CitationMode enumeration has Normal (for parenthetical), AuthorInText (for textual), and SuppressAuthor (for textual-year). See https://github.com/jgm/pandoc-types/blob/0158cd0e2a2ca9d6f14389a1a57bc64cab45a7dd/src/Text/Pandoc/Definition.hs#L353. LaTeX's natbib package has \citep{} (for parenthetical), \citet{} (for textual), \citeauthor{} (for textual-author), \citeyear{} (for textual-year). See https://www.overleaf.com/learn/latex/Natbib_citation_styles.
  2. citationPrefix : Previously this was name prefix but for consistency with citationMode and honorificPrefix, to avoid ambiguity with other prefixes was renamed to citationPrefix.
  3. citationSuffix : See comment on citationPrefix 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"
}
]
}
  • Parent: Entity
  • Descendants: None

Available as

Source

This documentation was generated from Cite.schema.yaml.