This is a type used in Stencila Schema for references to creative works.

It exists to represent bibliographic entries and related reference metadata in a structured way that can be cited, rendered, and transformed across formats. It is distinct from Citation, which represents an in-text reference occurrence.

Key properties include the referenced work metadata and identifiers used for linking citations to entries.

Analogues

The following external types, elements, or nodes are similar to a Reference:

schema.org CreativeWork: Approximate schema.org analogue because references largely reuse creative-work metadata, but Stencila Reference is specialized for bibliographic entries and citation linking.

Pandoc Citation: Only a partial Pandoc analogue; Pandoc citation items capture identifiers and locators, while Stencila Reference represents the bibliographic entry itself.

CSL JSON item: Close analogue for structured bibliographic record data used by citation processors.

Properties

The Reference type has these properties:

Name	Description	Type	Inherited from
`workType`	The type of `CreativeWork` being referenced (e.g. Article, Book, Dataset).	`CreativeWorkType`	-
`doi`	The Digital Object Identifier (https://doi.org/) of the work being referenced.	`String`	-
`authors`	The authors of the work.	`Author`*	-
`editors`	People who edited the referenced work.	`Person`*	-
`publisher`	A publisher of the referenced work.	`Person` \| `Organization`	-
`date`	Date of first publication.	`Date`	-
`title`	The title of the referenced work.	`Inline`*	-
`isPartOf`	Another `Reference` that this reference is a part of.	`Reference`	-
`volumeNumber`	Identifies the volume of publication or multi-part work; for example, "iii" or "2".	`Integer` \| `String`	-
`issueNumber`	Identifies the issue of a serial publication; for example, "3" or "12".	`Integer` \| `String`	-
`pageStart`	The page on which the article starts; for example "135" or "xiii".	`Integer` \| `String`	-
`pageEnd`	The page on which the article ends; for example "138" or "xvi".	`Integer` \| `String`	-
`pagination`	Any description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55".	`String`	-
`version`	The version/edition of the referenced work.	`String` \| `Number`	-
`identifiers`	Any kind of identifier for the referenced work.	(`PropertyValue` \| `String`)*	-
`url`	The URL of the referenced work.	`String`	-
`text`	Plain text representation of the referenced work.	`String`	-
`content`	A rendering of the reference using the citation style of the document.	`Inline`*	-
`id`	The identifier for this item.	`String`	`Entity`

The Reference type is related to these types:

Parents: Entity

Children: none

Bindings

The Reference type is represented in:

JSON-LD

JSON Schema

Python class Reference

Rust struct Reference

TypeScript class Reference

This documentation was generated from Reference.yaml by docs_types.rs.

Analogues

Properties

Related

Bindings