Типы и свойства schema.org

Не все веб-страницы посвящены фильмам и людям - в дополнение к типам Movie и Person, описанным в предыдущей главе, schema.org описывает множество других типов элементов, каждый из которых имеет свой собственный набор свойств, которые можно использовать для описания контента.

Самый обширный тип элемента - это Thing (сущность), который имеет четыре свойства: имя, описание, URL-адрес и изображение. Более конкретные типы имеют общие свойства с обширными. Например, Place (место) - это более конкретный для типа Thing, а LocalBusiness (частный бизнес) - более конкретный для типа Place. Более конкретные элементы наследуют свойства своих родителей. (На самом деле LocalBusiness - это более конкретный для типа Place и более конкретный для типа Organization, поэтому он наследует свойства от обоих родительских типов.)

Вот набор часто используемых типов сущностей:

Полный список всех типов элементов можно увидеть на отдельной странице.

Ожидаемые типы, текст и URL-адреса

Вот несколько примечаний, которые следует учитывать при добавлении разметки schema.org на свои веб-страницы.

Больше значит лучше (кроме скрытого текста)

Смысл - чем больше контента вы разметите, тем лучше. Однако, главное правило, желательно размечать только тот контент, который виден людям, которые посещают веб-страницу, а не контент в скрытых div'ах или других скрытых элементах страницы.

Ожидаемые типы и текст

Просматривая типы schema.org, вы заметите, что многие свойства имеют «ожидаемые типы» (expected types). Это означает, что значение свойства может быть встроенным элементом. Но это не является обязательным требованием - можно использовать обычный текст или URL-адрес. Кроме того, всякий раз, когда указан ожидаемый тип, также можно встраивать элемент, который является дочерним типом ожидаемого типа. Например, если ожидаемый тип - Place (место), можно встраивать LocalBusiness (частный бизнес).

Использование свойства url

Некоторые веб-страницы посвящены определенному элементу. Например, у вас может быть веб-страница о какой-то персоне, которую вы можете разметить с помощью типа элемента Person. На некоторых страницах контент состоит из набора элементов. Например, на сайте вашей компании может быть страница со списком сотрудников со ссылкой на страницу профиля каждого человека. Для таких страниц с набором элементов вы должны разметить каждый элемент отдельно (в нашем примере - Person) и добавить свойство url к ссылке на соответствующую страницу для каждого элемента, например:

<div itemscope itemtype="https://schema.org/Person">
  <a href="vasya.html" itemprop="url">Василий Петров</a>
</div>
<div itemscope itemtype="https://schema.org/Person">
  <a href="petya.html" itemprop="url">Петр Васильев</a>
</div>

Тестирование разметки

Подобно тому, как веб-браузер важен для тестирования изменений в макете веб-страницы, а компилятор кода важен для тестирования кода, который вы пишете, вы также должны протестировать разметку schema.org, чтобы убедиться, что она реализована правильно. Yandex предоставляет инструмент для тестирования расширенных фрагментов кода, который можно использовать для проверки разметки и выявления ошибок.