# Microdata

**Microdata** — это способ разметки, при котором данные передаются в стандартных элементах языка HTML.

Для разметки материала добавьте атрибут itemscope к любому тегу, в котором содержится описываемая сущность. Чтобы указать, что это за сущность, сразу после itemscope добавьте атрибут itemtype и в качестве его значения пропишите нужный класс в виде `itemtype="http://schema.org/<Имя класса>"`. Сущности также можно вкладывать друг в друга. Чтобы указать свойства сущности, используйте атрибут itemprop.

**Внимание!** Корректный сбор и отправка разметки возможны только при отсутствии вложенных сущностей.

Для корректной передачи информации следует настроить следующие сущности:

* [Тип материала](#tip-materiala) \[обязательно]
* [Идентификатор материала](#identifikator-materiala) \[обязательно]
* [Заголовок материала](#id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required) \[обязательно]
* [Дата публикации](#data-publikacii) \[обязательно]
* [Дата модификации](#data-modifikacii)
* [Url материала](#url-materiala)
* [Рубрика](#rubrika)
* [Тематика](#tematika)
* [Автор](#avtor)
* [Аннотация материала ](#annotaciya-materiala-vvodnyi-abzac)(вводный абзац)
* [Текст](#tekst)
* [Видео](#video)

Как разметить материал:

### Тип материала

Для передачи типа необходимо воспользоваться полями [schema.org/Article](https://schema.org/Article), [schema.org/NewsArticle](http://schema.org/NewsArticle), [schema.org/BlogPosting](https://schema.org/BlogPosting) или [schema.org/WebPage](https://schema.org/WebPage).

* Article — общая разметка, подходящая всем текстовым материалам;
* NewsArticle — отдельная разметка для новостей или дополнительных материалов;
* BlogPosting — разметка для статьи из блога;
* WebPage — общая разметка, подходящая к любому материалу.

**Пример:**

`<div` `itemtype="`[`http://schema.org/Article`](http://schema.org/Article)`">`\
`<h1>Крым, Турция, США. Как отдыхают футболисты</h1>`\
`<p>Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно. </p>`\
`</div>`

### Идентификатор материала

Для передачи идентификатора материала необходимо настроить передачу поля [identifier](https://schema.org/identifier). Идентификатор должен содержать более 3х символов.

**Пример:**

`<meta` `itemprop="identifier"` `content="entity_78686">`

### **Заголовок материала** <a href="#id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required" id="id-standartysemanticheskoimikrorazmetki-microdata-zagolovok-required"></a>

Для передачи заголовка материала необходимо настроить передачу полей [headline](https://schema.org/headline) или [alternativeHeadline](https://schema.org/alternativeHeadline).

**Пример:**

`<h1` `itemprop="headline">Стиль бохо входит в моду летом 2019</h1>`

### Дата публикации

Для передачи даты публикации необходимо использовать поле [datePublished](https://schema.org/datePublished). Разметка передается в формате [ISO 8601](https://www.iso.org/standard/40874.html).

**Пример:**

`<time itemprop="datePublished"` `datetime="2019-07-17T11:45:13+04:00">17.07.2019, 11:45</time>`

### Дата модификации

Поля [datePublished](https://schema.org/datePublished) (обязательное) и дата изменения [dateModified](https://schema.org/dateModified) (опциональное). Разметка поддерживает формат [ISO 8601](https://www.iso.org/standard/40874.html).

**Пример:**

`<meta itemprop="dateModified"` `content="2019-07-18T08:21:11+04:00">`

### Url материала

Для передачи url материала и контейнера можно использовать поле [url](https://schema.org/url)

**Пример:**

`"<link itemprop="url" href="https://www.championat.com/football/article-4522451-s-kem-sygraet-sbornaya-rossii-v-stykovyh-matchah-chm-2022-severnaya-makedoniya-vozmozhnyj-sopernik-komandy-karpina.html"></link>"`

### Рубрика

Для передачи данных по рубрикам можно использовать [breadcrumbList](https://schema.org/BreadcrumbList) или [genre](https://schema.org/genre).\
Рубрики отражают иерархическую структуру сайта. Рубрика может быть узкой и находиться внутри широкой темы. Определите несколько сущностей типа [ListItem](https://schema.org/ListItem) внутри класса, задайте им свойства [itemListElement](https://schema.org/itemListElement), которые описывают текущую и более широкие рубрики. Рубрикой данного материала будет считаться значение сущности с наибольшим position.

**Пример:**

`<p><meta itemprop="genre" content="style, fashion"/>Новый стиль моды в Москве</p>`

**Пример:**

`<ol` `itemscope=""` `itemtype="`[`http://schema.org/BreadcrumbList`](http://schema.org/BreadcrumbList)`">`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion">`\
`<span` `itemprop="name">Мода</span></a>`\
`<meta` `itemprop="position"` `content="1">`\
`</li>`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion/boho">`\
`<span` `itemprop="name">Стиль бохо</span></a>`\
`<meta` `itemprop="position"` `content="2">`\
`</li>`\
`<li` `itemprop="itemListElement"` `itemscope=""` `itemtype="`[`http://schema.org/ListItem`](http://schema.org/ListItem)`">`\
`<a` `itemprop="item"` `href="//site.ru/fashion/boho/woven-bags">`\
`<span` `itemprop="name">Плетеные сумки</span></a>`\
`<meta` `itemprop="position"` `content="3">`\
`</li>`\
`</ol>`

### Тематика

Для передачи тематики необходимо использовать поле [about](https://schema.org/about). Тематики отражают содержание статьи. В отличие от рубрик, количество тематик материала не ограничено. Обозначьте ее ключевыми словами или тегами.

**Пример:**

`<div` `itemprop="about">Мода</div>`\
`<div` `itemprop="about"` `itemscope=""` `itemtype="`[`https://schema.org/Thing`](https://schema.org/Thing)`">`\
`<span` `itemprop="name">Одежда</span>`\
`</div>`

### Автор

Для передачи автора можно воспользоваться полями [author](https://schema.org/author) или [person](https://schema.org/Person). Если их несколько, укажите каждого в отдельном теге.

**Пример:**

`<div` `itemprop="author">Автор статьи</div>`\
`<div` `itemprop="author"` `itemscope=""` `itemtype="`[`http://schema.org/Person`](http://schema.org/Person)`"> <span` `itemprop="name">Автор статьи</span></div>`

### Аннотация материала (вводный абзац)

Для передачи аннотации материала используется поле [abstract](https://schema.org/abstract).

**Пример:**

`<p` `itemprop="abstract"> Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно.</p>`

### Текст

Для передачи текста материала используется поле [articleBody](https://schema.org/articleBody). Текст статьи, должен содержать более 500 знаком и быть в единственном экземпляре на странице.

**Пример:**

`<p` `itemprop="articleBody">Летнее межсезонье в Российской Премьер-Лиге получилось мимолётным, многие команды уже вышли из отпуска и начали подготовку к новому розыгрышу. Футболисты попытались воспользоваться этой паузой максимально продуктивно.</p>`

### Видео

Для передачи видео информации используется поле [videoObject](https://schema.org/VideoObject). Минимально необходимые поля для описания видео.

| url         | [URL](http://schema.org/URL)                  | Ссылка на видеоролик.                                 |
| ----------- | --------------------------------------------- | ----------------------------------------------------- |
| name        | [Text](http://schema.org/Text)                | Название видео.                                       |
| description | [Text](http://schema.org/Text)                | Описание видео.                                       |
| duration    | [Duration](https://schema.org/Duration)       | Продолжительность видео.                              |
| thumbnail   | [ImageObject](https://schema.org/ImageObject) | Описание изображения при предварительном просмотре.   |
| uploadDate  | [Date](http://schema.org/DateTime)            | Дата загрузки видеоролика на сайт в формате ISO 8601. |

**Пример:**

| <p><code>\<div</code> <code>itemprop="video"</code> <code>itemscope itemtype="</code><a href="http://schema.org/VideoObject"><code><http://schema.org/VideoObject></code></a><code>"</code> <code>></code><br><code>\<a</code> <code>itemprop="url"</code> <code>href="</code><a href="https://www.mysite.com/view/306/"><code><https://www.mysite.com/view/306/></code></a><code>"></code><br><code>\<h1</code> <code>itemprop="name">Что такое Schema.org\</h1></code><br><code>\</a></code><br><code>\<p</code> <code>itemprop="description">Schema.org - это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года. Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска.\</p></code><br><code>\<meta</code> <code>itemprop="duration"</code> <code>content="PT6M58S"></code><br><code>\<meta</code> <code>itemprop="isFamilyFriendly"</code> <code>content="true"></code><br><code>\<p>Дата загрузки: \<span</code> <code>itemprop="uploadDate">2013-06-05T00:00:00\</span>\</p></code><br><code>\<span</code> <code>itemprop="thumbnail"</code> <code>itemscope itemtype="</code><a href="http://schema.org/ImageObject"><code><http://schema.org/ImageObject></code></a><code>"></code><br><code>\<img</code> <code>itemprop="contentUrl"</code> <code>src="</code><a href="https://www.mysite.com/images/preview/img1.jpg"><code><https://www.mysite.com/images/preview/img1.jpg></code></a><code>"></code><br><code>\<meta</code> <code>itemprop="width"</code> <code>content="250"></code><br><code>\<meta</code> <code>itemprop="height"</code> <code>content="120"></code><br><code>\</span></code><br><code>\</div></code></p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://top-100-writer.gitbook.io/top100-documentation/nastroika-sbora-i-otpravki-dannykh/veb-schyotchik/razmetka-dlya-otchetov-po-media/razmetka-schema.org/microdata.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.