Этот класс разметки описывает Статью (Article) на веб-странице (класс разметки WebPage). Разметка Article может быть трансформирована в более специфический тип (такой, как NewsArticle (Новостная статья)), если выполняются необходимые условия.
Триггеры#
Может выводиться только на страницах, у которых определен автор. В случае стандартных установок WordPress, пространство этой разметки ограничено Записями (Posts).
Обязательные свойства#
Валидная разметка статьи Article должна содержать следующие свойства.
- @id: Неизмененный канонический URL родительской страницы WebPage, добавленный следующим образом: #/schema/article/{{ID}}, где {{ID}} это уникальный идентификатор упоминаемой статьи.
- headline: Заголовок статьи (отсылающий нас к заголовку страницы - title для WebPage).
- description: краткое содержание статьи (связан с meta description страницы).
- isPartOf: Ссылка по ID на узел разметки WebPage.
- mainEntityOfPage: Ссылка по ID на узел разметки WebPage .
- datePublished: Дата и время первой публикации статьи, в формате ISO 8601; например, 2015-10-31T16:10:29+00:00.
- dateModified: Дата и время последнего изменения статьи, в формате ISO 8601 format; например, 2015-10-31T16:10:29+00:00.
- author: A reference-by-ID to the author of the article.
- publisher: Ссылка по ID на издателя статьи.
- image: изображение (или массив всех изображений из статьи), ссылка по ID.
- Ширина изображения должна быть минимум 696 пикселей.
- Для разметки допустимы только следующие форматы и расширения файлов: .jpg, .png, or .gif.
Сценарии ошибок#
Если любое из обязательных полей отсутствует или заполнено некорректно, разметка не выводится.
Если этот узел разметки не выводится, узел разметки родительской страницы WebPage должен быть изменен - теперь он будет ссылаться на следующие свойства по ID (когда это возможно):
- author (Автор)
- commentCount (Количество комментариев)
Отсутствие изображений#
Если причина ошибки в том, что в статье отсутствуют изображения, можно сослаться по ID на одно из перечисленных ниже изображений, при условии, что они действительно подходят (перечислены в порядке предпочтения):
- Изображение, указанное в свойстве primaryImageOfPage в разметке родительской страницы (WebPage).
- Первое изображение из массива изображений, прикрепленного к родительской странице (класс разметки WebPage).
Если подходящих изображений не находится, узел разметки не выводится (тогда обращаемся к Сценариям ошибок).
Необязательные свойства#
Следующие свойства должны добавляться, когда это возможно:
- video: массив всех видео в статье, если они есть; ссылка по ID.
- comment: Массив ссылок по ID на разметку комментариев.
- articleSection: массив названий рубрик, к которым принадлежит статья (напрмер, ["кошки","собаки","пирожные"]).
- inLanguage: Языковой код статьи; например, en-GB.
- speakable: Объект SpeakableSpecification, который размечает пригодный для озвучивания контент.
Условные свойства#
Опциональные свойства разметки, которые могут выводиться только, если задан соответствующий критерий.
Если информация о правах (copyright) доступна#
- copyrightYear: Год, с которого назначены права на публикацию.
- copyrightHolder: Владелец прав, ссылка по ID на организацию (класс Organization) или персону (класс Person), которой принадлежат права.
Если есть комментарии#
- commentCount: целое число комментариев, относящихся к статье.
- comment: массив со ссылкой по ID комментариев, относящихся к статье.
- potentialAction: Объект CommentAction со следующими значениями:
- name: "Comment".
- target: url родительской страницы (класс WebPage), связанной с комментарием #comment.
Изменения#
Тип разметки Article может быть изменен по следующему сценарию:
- Когда явно видно, что статья новостная "news article", свойство type должно быть заменено на следующий массив [Article, NewsArticle].
Примеры разметки Article#
Минимум свойств#
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Article",
"@id": "https://www.example.com/blog/example-article/#/schema/article/abc123",
"headline": "Example article headline",
"description": "Example article description",
"isPartOf": {
"@id": "https://www.example.com/blog/example-article/"
},
"mainEntityOfPage": {
"@id": "https://www.example.com/blog/example-article/"
},
"datePublished": "2019-07-10T08:08:40+00:00",
"dateModified": "2019-07-10T08:43:03+00:00",
"author": {
"@id": "https://www.example.com/#/schema/person/abc123"
},
"publisher": {
"@id": "https://www.example.com/#/schema/organization/abc123"
},
"image": {
"@id": "https://www.example.com/#/schema/image/abc123"
}
}
]
}
Расширенный набор свойств#
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Article",
"@id": "https://www.example.com/blog/example-article/#/schema/article/abc123",
"headline": "Example article headline",
"description": "Example article description",
"isPartOf": {
"@id": "https://www.example.com/blog/example-article/"
},
"mainEntityOfPage": {
"@id": "https://www.example.com/blog/example-article/"
},
"datePublished": "2019-07-10T08:08:40+00:00",
"dateModified": "2019-07-10T08:43:03+00:00",
"commentCount": 6,
"articleSection": "Cats,Dogs,Recipes",
"inLanguage": "en-US",
"author": {
"@id": "https://www.example.com/#/schema/person/abc123"
},
"publisher": {
"@id": "https://www.example.com/#/schema/organization/abc123"
},
"image": [
{
"@id": "https://www.example.com/#/schema/image/abc123"
},
{
"@id": "https://www.example.com/#/schema/image/def456"
}
],
"video": [
{
"@id": "https://www.example.com/#/schema/video/abc123"
},
{
"@id": "https://www.example.com/#/schema/video/def456"
}
]
}
]
}
