NAME

SemanticWeb::Schema::Article - An article

VERSION

version v14.0.0

DESCRIPTION

An article, such as a news article or piece of investigative report. Newspapers and magazines have articles of many different types and this is intended to cover them all. See also [blog post](http://blog.schema.org/2014/09/schemaorg-support-for-bibliographic_2. html).

ATTRIBUTES

article_body

articleBody

The actual body of the article.

A article_body should be one of the following types:

Str

_has_article_body

A predicate for the "article_body" attribute.

article_section

articleSection

Articles may belong to one or more 'sections' in a magazine or newspaper, such as Sports, Lifestyle, etc.

A article_section should be one of the following types:

Str

_has_article_section

A predicate for the "article_section" attribute.

backstory

For an SemanticWeb::Schema::Article, typically a SemanticWeb::Schema::NewsArticle, the backstory property provides a textual summary giving a brief explanation of why and how an article was created. In a journalistic setting this could include information about reporting process, methods, interviews, data sources, etc.

A backstory should be one of the following types:

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

_has_backstory

A predicate for the "backstory" attribute.

page_end

pageEnd

The page on which the work ends; for example "138" or "xvi".

A page_end should be one of the following types:

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

_has_page_end

A predicate for the "page_end" attribute.

page_start

pageStart

The page on which the work starts; for example "135" or "xiii".

A page_start should be one of the following types:

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

_has_page_start

A predicate for the "page_start" attribute.

pagination

Any description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55" or "10-12, 46-49".

A pagination should be one of the following types:

Str

_has_pagination

A predicate for the "pagination" attribute.

speakable

Indicates sections of a Web page that are particularly 'speakable' in the sense of being highlighted as being especially appropriate for text-to-speech conversion. Other sections of a page may also be usefully spoken in particular circumstances; the 'speakable' property serves to indicate the parts most likely to be generally useful for speech.

The speakable property can be repeated an arbitrary number of times, with three kinds of possible 'content-locator' values:

1.) id-value URL references - uses id-value of an element in the page being annotated. The simplest use of speakable has (potentially relative) URL values, referencing identified sections of the document concerned.

2.) CSS Selectors - addresses content in the annotated page, eg. via class attribute. Use the [[cssSelector]] property.

3.) XPaths - addresses content via XPaths (assuming an XML view of the content). Use the [[xpath]] property.

For more sophisticated markup of speakable sections beyond simple ID references, either CSS selectors or XPath expressions to pick out document section(s) as speakable. For this we define a supporting type, SemanticWeb::Schema::SpeakableSpecification which is defined to be a possible value of the speakable property.

A speakable should be one of the following types:

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

_has_speakable

A predicate for the "speakable" attribute.

word_count

wordCount

The number of words in the text of the Article.

A word_count should be one of the following types:

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

_has_word_count

A predicate for the "word_count" attribute.

SEE ALSO

SemanticWeb::Schema::CreativeWork

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-2022 by Robert Rothenberg.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)