Article
An article, including news and scholarly articles.
This is an implementation, and extension, of schema.org Article
. It extends schema.org Article
by, adding a content
property which must be an array of BlockContent
, as well as the properties added by CreativeWork
which it extends. An Article
is analogous, and structurally similar to, the JATS XML <article>
element.
Properties​
Name | @id | Type | Description | Inherited from |
---|---|---|---|---|
about | schema:about | Array of ThingTypes | The subject matter of the content. See note 1. | CreativeWork |
alternateNames | schema:alternateName | Array of string | Alternate names (aliases) for the item. | Thing |
authors | schema:author | Parser 'scsi' and Array of (Person or Organization) | The authors of this creative work. | CreativeWork |
comments | schema:comment | Array of Comment | Comments about this creative work. | CreativeWork |
content | stencila:content | Array of BlockContent | The structured content of this article. See note 2. | Article |
dateAccepted | stencila:dateAccepted | Date | Date/time of acceptance. See note 3. | CreativeWork |
dateCreated | schema:dateCreated | Date | Date/time of creation. | CreativeWork |
dateModified | schema:dateModified | Date | Date/time of most recent modification. | CreativeWork |
datePublished | schema:datePublished | Date | Date of first publication. | CreativeWork |
dateReceived | schema:dateReceived | Date | Date/time that work was received. | CreativeWork |
description | schema:description | Array of BlockContent or Array of InlineContent or string | A description of the item. See note 4. | Thing |
editors | schema:editor | Array of Person | People who edited the CreativeWork . | CreativeWork |
fundedBy | stencila:fundedBy | Array of (Grant or MonetaryGrant) | Grants that funded the CreativeWork ; reverse of fundedItems . See note 5. | CreativeWork |
funders | schema:funder | Array of (Person or Organization) | People or organizations that funded the CreativeWork . | CreativeWork |
genre | schema:genre | Parser 'csi' and Array of string | Genre of the creative work, broadcast channel or group. | CreativeWork |
id | schema:id | string | The identifier for this item. | Entity |
identifiers | schema:identifier | Array of (PropertyValue or string) | Any kind of identifier for any kind of Thing. See note 6. | Thing |
images | schema:image | Array of (ImageObject or Format 'uri') | Images of the item. | Thing |
isPartOf | schema:isPartOf | CreativeWorkTypes | An item or other CreativeWork that this CreativeWork is a part of. | CreativeWork |
keywords | schema:keywords | Parser 'csi' and Array of string | Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas. | CreativeWork |
licenses | schema:license | Array of (CreativeWorkTypes or Format 'uri') | License documents that applies to this content, typically indicated by URL. | CreativeWork |
maintainers | schema:maintainer | Array of (Person or Organization) | The people or organizations who maintain this CreativeWork. See note 7. | CreativeWork |
meta | stencila:meta | object | Metadata associated with this item. | Entity |
name | schema:name | string | The name of the item. | Thing |
pageEnd | schema:pageEnd | integer or string | The page on which the article ends; for example "138" or "xvi". | Article |
pageStart | schema:pageStart | integer or string | The page on which the article starts; for example "135" or "xiii". | Article |
pagination | schema:pagination | string | Any description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55". | Article |
parts | schema:hasParts | Array of CreativeWorkTypes | Elements of the collection which can be a variety of different elements, such as Articles, Datatables, Tables and more. | CreativeWork |
publisher | schema:publisher | Person or Organization | A publisher of the CreativeWork. | CreativeWork |
references | schema:citation | Array of (CreativeWorkTypes or string) | References to other creative works, such as another publication, web page, scholarly article, etc. | CreativeWork |
text | schema:text | string | The textual content of this creative work. | CreativeWork |
title | schema:headline | Array of InlineContent or string | The title of the creative work. See note 8. | CreativeWork |
url | schema:url | Format 'uri' | The URL of the item. | Thing |
version | schema:version | string or number | The version of the creative work. See note 9. | CreativeWork |
Notes​
- about : Consistent with https://schema.org/about, this property allows for linking to one of more
Thing
nodes. This could for example include aPerson
(e.g for a bibliography) or aDefinedTerm
(e.g. for subject areas the creative work relates to). - content : This is an override of
CreativeWork.content
to restrict node toBlockContent
node types e.gParagraph
. - dateAccepted : This is not yet a schema.org property but the term is used in Dublin Core.
- description : Allows for the description to be an array of nodes (e.g. an array of inline content, or a couple of paragraphs), or a string. The
minItems
restriction avoids a string being coerced into an array with a single string item. - fundedBy : This follows the proposal here for a property that is the reverse of
fundedItems
. It is an any because aCreativeWork
may have been funded through more than oneGrant
. - identifiers : Some identifiers have specific properties e.g the
issn
property for thePeriodical
type. These should be used in preference to this property which is intended for identifiers that do not yet have a specific property. Identifiers can be represented as strings, but using aPropertyValue
will usually be better because it allows forpropertyID
(i.e. the type of identifier). - maintainers : A maintainer of a Dataset, SoftwareApplication, or other CreativeWork. A maintainer is a Person or Organization that manages contributions to, and/or publication of, some (typically complex) artifact. It is common for distributions of software and data to be based on "upstream" sources. When maintainer is applied to a specific version of something e.g. a particular version or packaging of a Dataset, it is always possible that the upstream source has a different maintainer. The isBasedOn property can be used to indicate such relationships between datasets to make the different maintenance roles clear. Similarly in the case of software, a package may have dedicated maintainers working on integration into software distributions such as Ubuntu, as well as upstream maintainers of the underlying work.
- title : Allows for the title to include inline content (e.g
Strong
,Math
) or a string. The title can not be block content e.gParagraph
. TheminItems
restriction avoids a string being coerced into an array with a single string item. - version : In this case
string
is listed as an alternative beforenumber
to avoid semantic version numbers e.g.1.0
being parsed, and subsequently encoded, as1
thereby resulting in loss of information.
Examples​
{
"type": "Article",
"title": "Recherches sur les substances radioactives",
"authors": [
{
"type": "Person",
"honorificPrefix": "Dr",
"givenNames": [
"Marie",
"Skłodowska"
],
"familyNames": [
"Curie"
],
"honorificSuffix": "PhD"
}
],
"content": [
"Le présent travail a pour but d'exposer les recherches que je poursuis depuis"
]
}
Related​
- Parent: CreativeWork
- Descendants: None
Available as​
- JSON-LD
- JSON Schema
- Python
class Article
- TypeScript
interface Article
- R
class Article
- Rust
struct Article
Source​
This documentation was generated from Article.schema.yaml.