NAME

SemanticWeb::Schema::CreativeWork - The most generic kind of creative work

VERSION

version v5.0.0

DESCRIPTION

The most generic kind of creative work, including books, movies, photographs, software programs, etc.

ATTRIBUTES

about

The subject matter of the content.

A about should be one of the following types:

InstanceOf['SemanticWeb::Schema::Thing']

abstract

An abstract is a short description that summarizes a CreativeWork.

A abstract should be one of the following types:

Str

access_mode

accessMode

The human sensory perceptual system or cognitive faculty through which a person may process or perceive information. Expected values include: auditory, tactile, textual, visual, colorDependent, chartOnVisual, chemOnVisual, diagramOnVisual, mathOnVisual, musicOnVisual, textOnVisual.

A access_mode should be one of the following types:

Str

access_mode_sufficient

accessModeSufficient

A list of single or combined accessModes that are sufficient to understand all the intellectual content of a resource. Expected values include: auditory, tactile, textual, visual.

A access_mode_sufficient should be one of the following types:

InstanceOf['SemanticWeb::Schema::ItemList']

accessibility_api

accessibilityAPI

Indicates that the resource is compatible with the referenced accessibility API (WebSchemas wiki lists possible values).

A accessibility_api should be one of the following types:

Str

accessibility_control

accessibilityControl

Identifies input methods that are sufficient to fully control the described resource (WebSchemas wiki lists possible values).

A accessibility_control should be one of the following types:

Str

accessibility_feature

accessibilityFeature

Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility (WebSchemas wiki lists possible values).

A accessibility_feature should be one of the following types:

Str

accessibility_hazard

accessibilityHazard

A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 (WebSchemas wiki lists possible values).

A accessibility_hazard should be one of the following types:

Str

accessibility_summary

accessibilitySummary

A human-readable summary of specific accessibility features or deficiencies, consistent with the other accessibility metadata but expressing subtleties such as "short descriptions are present but long descriptions will be needed for non-visual users" or "short descriptions are present and no long descriptions are needed."

A accessibility_summary should be one of the following types:

Str

accountable_person

accountablePerson

Specifies the Person that is legally accountable for the CreativeWork.

A accountable_person should be one of the following types:

InstanceOf['SemanticWeb::Schema::Person']

aggregate_rating

aggregateRating

The overall rating, based on a collection of reviews or ratings, of the item.

A aggregate_rating should be one of the following types:

InstanceOf['SemanticWeb::Schema::AggregateRating']

alternative_headline

alternativeHeadline

A secondary title of the CreativeWork.

A alternative_headline should be one of the following types:

Str

associated_media

associatedMedia

A media object that encodes this CreativeWork. This property is a synonym for encoding.

A associated_media should be one of the following types:

InstanceOf['SemanticWeb::Schema::MediaObject']

audience

An intended audience, i.e. a group for whom something was created.

A audience should be one of the following types:

InstanceOf['SemanticWeb::Schema::Audience']

audio

An embedded audio object.

A audio should be one of the following types:

InstanceOf['SemanticWeb::Schema::AudioObject']
InstanceOf['SemanticWeb::Schema::Clip']

author

The author of this content or rating. Please note that author is special in that HTML 5 provides a special mechanism for indicating authorship via the rel tag. That is equivalent to this and may be used interchangeably.

A author should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

award

An award won by or for this item.

A award should be one of the following types:

Str

awards

Awards won by or for this item.

A awards should be one of the following types:

Str

character

Fictional person connected with a creative work.

A character should be one of the following types:

InstanceOf['SemanticWeb::Schema::Person']

citation

A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.

A citation should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
Str

comment

Comments, typically from users.

A comment should be one of the following types:

InstanceOf['SemanticWeb::Schema::Comment']

comment_count

commentCount

The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.

A comment_count should be one of the following types:

InstanceOf['SemanticWeb::Schema::Integer']

conditions_of_access

conditionsOfAccess

Conditions that affect the availability of, or method(s) of access to, an item. Typically used for real world items such as an ArchiveComponent held by an ArchiveOrganization. This property is not suitable for use as a general Web access control mechanism. It is expressed only in natural language. For example "Available by appointment from the Reading Room" or "Accessible only from logged-in accounts ".

A conditions_of_access should be one of the following types:

Str

content_location

contentLocation

The location depicted or described in the content. For example, the location in a photograph or painting.

A content_location should be one of the following types:

InstanceOf['SemanticWeb::Schema::Place']

content_rating

contentRating

Official rating of a piece of content—for example,'MPAA PG-13'.

A content_rating should be one of the following types:

InstanceOf['SemanticWeb::Schema::Rating']
Str

content_reference_time

contentReferenceTime

The specific time described by a creative work, for works (e.g. articles, video objects etc.) that emphasise a particular moment within an Event.

A content_reference_time should be one of the following types:

Str

contributor

A secondary contributor to the CreativeWork or Event.

A contributor should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

copyrightHolder

The party holding the legal copyright to the CreativeWork.

A copyright_holder should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

copyrightYear

The year during which the claimed copyright for the CreativeWork was first asserted.

A copyright_year should be one of the following types:

Num

correction

Indicates a correction to a CreativeWork, either via a CorrectionComment, textually or in another document.

A correction should be one of the following types:

InstanceOf['SemanticWeb::Schema::CorrectionComment']
Str

creative_work_status

creativeWorkStatus

The status of a creative work in terms of its stage in a lifecycle. Example terms include Incomplete, Draft, Published, Obsolete. Some organizations define a set of terms for the stages of their publication lifecycle.

A creative_work_status should be one of the following types:

InstanceOf['SemanticWeb::Schema::DefinedTerm']
Str

creator

The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork.

A creator should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

date_created

dateCreated

The date on which the CreativeWork was created or the item was added to a DataFeed.

A date_created should be one of the following types:

Str

date_modified

dateModified

The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed.

A date_modified should be one of the following types:

Str

date_published

datePublished

Date of first broadcast/publication.

A date_published should be one of the following types:

Str

discussion_url

discussionUrl

A link to the page containing the comments of the CreativeWork.

A discussion_url should be one of the following types:

Str

editor

Specifies the Person who edited the CreativeWork.

A editor should be one of the following types:

InstanceOf['SemanticWeb::Schema::Person']

educational_alignment

educationalAlignment

An alignment to an established educational framework.

A educational_alignment should be one of the following types:

InstanceOf['SemanticWeb::Schema::AlignmentObject']

educational_use

educationalUse

The purpose of a work in the context of education; for example, 'assignment', 'group work'.

A educational_use should be one of the following types:

Str

encoding

A media object that encodes this CreativeWork. This property is a synonym for associatedMedia.

A encoding should be one of the following types:

InstanceOf['SemanticWeb::Schema::MediaObject']

encoding_format

encodingFormat

Media type typically expressed using a MIME format (see IANA site and MDN reference) e.g. application/zip for a SoftwareApplication binary, audio/mpeg for .mp3 etc.). In cases where a CreativeWork has several media type representations, encoding can be used to indicate each MediaObject alongside particular encodingFormat information. Unregistered or niche encoding and file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia/Wikidata entry.

A encoding_format should be one of the following types:

Str

encodings

A media object that encodes this CreativeWork.

A encodings should be one of the following types:

InstanceOf['SemanticWeb::Schema::MediaObject']

example_of_work

exampleOfWork

A creative work that this work is an example/instance/realization/derivation of.

A example_of_work should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

expires

Date the content expires and is no longer useful or available. For example a VideoObject or NewsArticle whose availability or relevance is time-limited, or a ClaimReview fact check whose publisher wants to indicate that it may no longer be relevant (or helpful to highlight) after some date.

A expires should be one of the following types:

Str

file_format

fileFormat

Media type, typically MIME format (see IANA site) of the content e.g. application/zip of a SoftwareApplication binary. In cases where a CreativeWork has several media type representations, 'encoding' can be used to indicate each MediaObject alongside particular fileFormat information. Unregistered or niche file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia entry.

A file_format should be one of the following types:

Str

funder

A person or organization that supports (sponsors) something through some kind of financial contribution.

A funder should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

genre

Genre of the creative work, broadcast channel or group.

A genre should be one of the following types:

Str

has_part

hasPart

Indicates an item or CreativeWork that is part of this item, or CreativeWork (in some sense).

A has_part should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

headline

Headline of the article.

A headline should be one of the following types:

Str

in_language

inLanguage

The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage.

A in_language should be one of the following types:

InstanceOf['SemanticWeb::Schema::Language']
Str

interaction_statistic

interactionStatistic

The number of interactions for the CreativeWork using the WebSite or SoftwareApplication. The most specific child type of InteractionCounter should be used.

A interaction_statistic should be one of the following types:

InstanceOf['SemanticWeb::Schema::InteractionCounter']

interactivity_type

interactivityType

The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.

A interactivity_type should be one of the following types:

Str

is_accessible_for_free

isAccessibleForFree

A flag to signal that the item, event, or place is accessible for free.

A is_accessible_for_free should be one of the following types:

Bool

is_based_on

isBasedOn

A resource from which this work is derived or from which it is a modification or adaption.

A is_based_on should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
InstanceOf['SemanticWeb::Schema::Product']
Str

is_based_on_url

isBasedOnUrl

A resource that was used in the creation of this resource. This term can be repeated for multiple sources. For example, http://example.com/great-multiplication-intro.html.

A is_based_on_url should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
InstanceOf['SemanticWeb::Schema::Product']
Str

is_family_friendly

isFamilyFriendly

Indicates whether this content is family friendly.

A is_family_friendly should be one of the following types:

Bool

is_part_of

isPartOf

Indicates an item or CreativeWork that this item, or CreativeWork (in some sense), is part of.

A is_part_of should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

keywords

Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.

A keywords should be one of the following types:

Str

learning_resource_type

learningResourceType

The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.

A learning_resource_type should be one of the following types:

Str

license

A license document that applies to this content, typically indicated by URL.

A license should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
Str

location_created

locationCreated

The location where the CreativeWork was created, which may not be the same as the location depicted in the CreativeWork.

A location_created should be one of the following types:

InstanceOf['SemanticWeb::Schema::Place']

main_entity

mainEntity

Indicates the primary entity described in some page or other CreativeWork.

A main_entity should be one of the following types:

InstanceOf['SemanticWeb::Schema::Thing']

material

A material that something is made from, e.g. leather, wool, cotton, paper.

A material should be one of the following types:

InstanceOf['SemanticWeb::Schema::Product']
Str

material_extent

materialExtent

The quantity of the materials being described or an expression of the physical space they occupy.

A material_extent should be one of the following types:

InstanceOf['SemanticWeb::Schema::QuantitativeValue']
Str

mentions

Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.

A mentions should be one of the following types:

InstanceOf['SemanticWeb::Schema::Thing']

offers

An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event.

A offers should be one of the following types:

InstanceOf['SemanticWeb::Schema::Offer']

position

The position of an item in a series or sequence of items.

A position should be one of the following types:

InstanceOf['SemanticWeb::Schema::Integer']
Str

producer

The person or organization who produced the work (e.g. music album, movie, tv/radio series etc.).

A producer should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

provider

The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller.

A provider should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

publication

A publication event associated with the item.

A publication should be one of the following types:

InstanceOf['SemanticWeb::Schema::PublicationEvent']

publisher

The publisher of the creative work.

A publisher should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

publisher_imprint

publisherImprint

The publishing division which published the comic.

A publisher_imprint should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']

publishing_principles

publishingPrinciples

The publishingPrinciples property indicates (typically via URL) a document describing the editorial principles of an Organization (or individual e.g. a Person writing a blog) that relate to their activities as a publisher, e.g. ethics or diversity policies. When applied to a CreativeWork (e.g. NewsArticle) the principles are those of the party primarily responsible for the creation of the CreativeWork. While such policies are most typically expressed in natural language, sometimes related information (e.g. indicating a funder) can be expressed using schema.org terminology.

A publishing_principles should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
Str

recorded_at

recordedAt

The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event.

A recorded_at should be one of the following types:

InstanceOf['SemanticWeb::Schema::Event']

released_event

releasedEvent

The place and time the release was issued, expressed as a PublicationEvent.

A released_event should be one of the following types:

InstanceOf['SemanticWeb::Schema::PublicationEvent']

review

A review of the item.

A review should be one of the following types:

InstanceOf['SemanticWeb::Schema::Review']

reviews

Review of the item.

A reviews should be one of the following types:

InstanceOf['SemanticWeb::Schema::Review']

schema_version

schemaVersion

Indicates (by URL or string) a particular version of a schema used in some CreativeWork. For example, a document could declare a schemaVersion using an URL such as http://schema.org/version/2.0/ if precise indication of schema version was required by some application.

A schema_version should be one of the following types:

Str

sd_date_published

sdDatePublished

Indicates the date on which the current structured data was generated / published. Typically used alongside sdPublisher

A sd_date_published should be one of the following types:

Str

sd_license

sdLicense

A license document that applies to this structured data, typically indicated by URL.

A sd_license should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']
Str

sd_publisher

sdPublisher

Indicates the party responsible for generating and publishing the current structured data markup, typically in cases where the structured data is derived automatically from existing published content but published on a different site. For example, student projects and open data initiatives often re-publish existing content with more explicitly structured metadata. The sdPublisher property helps make such practices more explicit.

A sd_publisher should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

source_organization

sourceOrganization

The Organization on whose behalf the creator was working.

A source_organization should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']

spatial

The "spatial" property can be used in cases when more specific properties (e.g. locationCreated, spatialCoverage, contentLocation) are not known to be appropriate.

A spatial should be one of the following types:

InstanceOf['SemanticWeb::Schema::Place']

spatial_coverage

spatialCoverage

The spatialCoverage of a CreativeWork indicates the place(s) which are the focus of the content. It is a subproperty of contentLocation intended primarily for more technical and detailed materials. For example with a Dataset, it indicates areas that the dataset describes: a dataset of New York weather would have spatialCoverage which was the place: the state of New York.

A spatial_coverage should be one of the following types:

InstanceOf['SemanticWeb::Schema::Place']

A person or organization that supports a thing through a pledge, promise, or financial contribution. e.g. a sponsor of a Medical Study or a corporate sponsor of an event.

A sponsor should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

temporal

The "temporal" property can be used in cases where more specific properties (e.g. temporalCoverage, dateCreated, dateModified, datePublished) are not known to be appropriate.

A temporal should be one of the following types:

Str

temporal_coverage

temporalCoverage

The temporalCoverage of a CreativeWork indicates the period that the content applies to, i.e. that it describes, either as a DateTime or as a textual string indicating a time period in ISO 8601 time interval format. In the case of a Dataset it will typically indicate the relevant time period in a precise notation (e.g. for a 2011 census dataset, the year 2011 would be written "2011/2012"). Other forms of content e.g. ScholarlyArticle, Book, TVSeries or TVEpisode may indicate their temporalCoverage in broader terms - textually or via well-known URL. Written works such as books may sometimes have precise temporal coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 interval format format via "1939/1945". Open-ended date ranges can be written with ".." in place of the end date. For example, "2015-11/.." indicates a range beginning in November 2015 and with no specified final date. This is tentative and might be updated in future when ISO 8601 is officially updated.

A temporal_coverage should be one of the following types:

Str

text

The textual content of this CreativeWork.

A text should be one of the following types:

Str

thumbnail_url

thumbnailUrl

A thumbnail image relevant to the Thing.

A thumbnail_url should be one of the following types:

Str

time_required

timeRequired

Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience, e.g. 'PT30M', 'PT1H25M'.

A time_required should be one of the following types:

InstanceOf['SemanticWeb::Schema::Duration']

translation_of_work

translationOfWork

The work that this work has been translated from. e.g. 物种起源 is a translationOf “On the Origin of Species”

A translation_of_work should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

translator

Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market, or that translates during some event.

A translator should be one of the following types:

InstanceOf['SemanticWeb::Schema::Organization']
InstanceOf['SemanticWeb::Schema::Person']

typical_age_range

typicalAgeRange

The typical expected age range, e.g. '7-9', '11-'.

A typical_age_range should be one of the following types:

Str

version

The version of the CreativeWork embodied by a specified resource.

A version should be one of the following types:

Num
Str

video

An embedded video object.

A video should be one of the following types:

InstanceOf['SemanticWeb::Schema::Clip']
InstanceOf['SemanticWeb::Schema::VideoObject']

work_example

workExample

Example/instance/realization/derivation of the concept of this creative work. eg. The paperback edition, first edition, or eBook.

A work_example should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

work_translation

workTranslation

A work that is a translation of the content of this work. e.g. 西遊記 has an English workTranslation “Journey to the West”,a German workTranslation “Monkeys Pilgerfahrt” and a Vietnamese translation Tây du ký bình khảo.

A work_translation should be one of the following types:

InstanceOf['SemanticWeb::Schema::CreativeWork']

SEE ALSO

SemanticWeb::Schema::Thing

SOURCE

The development version is on github at https://github.com/robrwo/SemanticWeb-Schema and may be cloned from git://github.com/robrwo/SemanticWeb-Schema.git

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/SemanticWeb-Schema/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Robert Rothenberg <rrwo@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2019 by Robert Rothenberg.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)