Разметка RSS-канала
Данные для Турбо‑страниц экспортируются в XML-based формате RSS 2.0. См. также Использование HTML и CSS.
Структура RSS-канала
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:yandex="http://news.yandex.ru"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:turbo="http://turbo.yandex.ru"
version="2.0">
<channel>
<!-- Информация о сайте-источнике -->
<title>Название канала</title>
<link>http://www.example.com/</link>
<description>Краткое описание канала</description>
<language>ru</language>
<turbo:analytics></turbo:analytics>
<turbo:adNetwork></turbo:adNetwork>
<item turbo="true">
<!-- Информация о странице -->
<turbo:extendedHtml>true</turbo:extendedHtml>
<link>http://www.example.com/category/sub-category/page1.html</link>
<turbo:source></turbo:source>
<turbo:topic></turbo:topic>
<pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
<author>Иван Иванов</author>
<metrics>
<yandex schema_identifier="Идентификатор">
<breadcrumblist>
<breadcrumb url="http://example.com/" text="Домашняя"/>
<breadcrumb url="http://example.com/category/" text="Категория"/>
<breadcrumb url="http://example.com/category/sub-category/" text="Подкатегория"/>
<breadcrumb url="http://example.com/category/sub-category/page1.html" text="Пример страницы"/>
</breadcrumblist>
</yandex>
</metrics>
<yandex:related></yandex:related>
<turbo:content>
<![CDATA[
<!-- Содержимое 1 страницы -->
]]>
</turbo:content>
</item>
<item turbo="true">
...
<turbo:content>
<![CDATA[
<!-- Содержимое 2 страницы -->
]]>
</turbo:content>
</item>
...
</channel>
</rss>
|
Информация о сайте-источнике. |
|
Название RSS-канала. Если экспортируется содержимое всего сайта, укажите название сайта. Если экспортируется раздел сайта, укажите только название раздела. |
|
Домен сайта, данные которого транслируются. |
|
Описание канала одним предложением. Не используйте HTML-разметку. |
|
Язык статьи по стандарту ISO 639-1. |
|
Счетчик системы веб-аналитики для учета посещаемости Турбо‑страниц. |
|
Внимание Данный способ указания рекламных блоков устарел. Вместо него используйте настройки в интерфейсе Вебмастера. Подробнее в разделе Ручная настройка в интерфейсе. Используйте для указания блоков Рекламной сети Яндекса и сторонней рекламы, подключенной через Adfox. Подробнее о рекламных блоках на Турбо‑страницах в разделе Реклама. |
|
Информация о странице. Для отображения Турбо‑страниц, добавьте атрибут Один элемент |
|
Активация обработки пользовательского HTML и CSS. Обязательный параметр для использования полного набора тегов. Если не передавать этот параметр, то некоторые теги будут игнорироваться. |
|
URL страницы сайта, для которой нужно сформировать Турбо‑страницу. Требования:
При переходе по ссылке заголовок и начало текста должны быть видны на первом экране при разрешении 1024 × 768. |
|
URL страницы-источника, который можно передать в Яндекс.Метрику. |
|
Заголовок страницы, который можно передать в Яндекс.Метрику. |
|
Время публикации в формате RFC-822. Обязательный элемент для формирования автоматической главной страницы. |
|
Автор статьи, размещенной на странице. |
|
Внимание Вложенные элементы Дополнительная информация о странице. Используется для связывания контентной информации на основной и Турбо‑странице сайта. |
|
Информация для Яндекс.Метрики. Допустимые атрибуты:
|
|
Внимание Элементы Блок с рубриками, который указан на основной странице сайта. |
|
Информация о странице. Допустимые атрибуты:
|
|
Вы можете разместить ссылки на другие ресурсы или настроить отображение бесконечной ленты статей. Такие ссылки будут располагаться внизу Турбо‑страницы. Чтобы добавить ссылки в любом месте страницы, используйте Блок ссылок на дополнительные материалы. Блок со ссылками на другие страницыСодержит элемент Чтобы добавить к статье изображение, используйте атрибут Оборачиваемый в элемент
Бесконечная лента рекомендацийВнимание Бесконечную ленту можно сформировать только из статей, для которых уже сформированы Турбо‑страницы. Чтобы задать набор страниц вручную:
Пример:
Чтобы реклама Adfox отображалась на Турбо‑страницах с бесконечной лентой:
Подробнее о настройке в Помощи Adfox. |
|
* Обязательный параметр
Передача содержимого страницы
Содержимое для Турбо‑страницы передается с помощью элемента turbo:content
. Содержимое необходимо обернуть в раздел <![CDATA[]]>
...
<turbo:content>
<![CDATA[
<!-- Содержимое страницы -->
]]>
</turbo:content>
...
Содержимое страницы обязательно должно содержать шапку страницы и контентную часть:
-
Шапка задается с помощью элемента
header
и может содержать заголовок, меню и картинку для превью. -
Контентная часть может содержать все доступные элементы Турбо‑страниц: текст, картинки и видео, таблицы и т. д. При этом она должна полностью повторять структуру и содержимое основной страницы. Подробнее в разделе Требования к содержимому.
Для того, чтобы сделать Турбо‑страницу более похожей на оригинал, используйте HTML и CSS. Стили устанавливаются через настройки CSS в Вебмастере.
...
<!-- Шапка -->
<header>
<h1>Заголовок страницы</h1>
<figure>
<img src="http://example.com/img.jpg"/>
</figure>
<h2>Заголовок второго уровня</h2>
<menu>
<a href="http://example.com/page1.html">Текст ссылки</a>
<a href="http://example.com/page2.html">Текст ссылки</a>
</menu>
</header>
<!-- Контентная часть -->
...
|
|
|
Заголовок страницы. |
|
Элемент, который используется для формирования превью в шапке. Может использоваться для формирования картинки с подписью. |
|
Атрибут |
|
Заголовок второго уровня. |
|
Навигационное меню. |
|
Пункт меню. Атрибут |
* Обязательный параметр
Символы и кодировки
В экспортном файле укажите кодировку, отдаваемую вашим сервером. Наиболее часто используются: UTF-8, Windows-1251, KOI8-R.
Во всех элементах RSS-файла, кроме содержимого раздела <![CDATA[]]>, необходимо кодировать следующие символы:
Символ | Название | Код замены |
---|---|---|
& | Амперсанд | & |
> | Правая угловая скобка | > |
< | Левая угловая скобка | < |
" | Кавычки | " |
' | Апостроф | ' |
Например, ссылка http://example.com/?id=1&page=10
должна быть приведена к виду http://example.com/?id=1&page=10
.
Если RSS-файл передается в кодировке KOI8-R, замените встречающиеся в тексте символы кодировки Windows-1251 на аналоги KOI8-R:
Символ | Название | Код замены |
---|---|---|
... | Многоточие | 133 |
– | Короткое тире (en-dash) | 150 |
— | Длинное тире (em-dash) | 151 |
' ' | Английские одиночные кавычки | 145 и 146 |
" " | Английские двойные кавычки («лапки») | 147 и 148 |
« » | Французские кавычки («елочки») | 171 и 187 |
№ | Номер | 185 |
Пример RSS-канала
<rss xmlns:yandex="http://news.yandex.ru" xmlns:media="http://search.yahoo.com/mrss/" xmlns:turbo="http://turbo.yandex.ru" version="2.0">
<channel>
<title>Название RSS-канала</title>
<link>http://www.example.com/</link>
<description>Краткое описание RSS-канала</description>
<turbo:analytics type="Yandex" id="123456"></turbo:analytics>
<turbo:adNetwork type="Yandex" id="идентификатор блока" turbo-ad-id="first_ad_place"></turbo:adNetwork>
<turbo:adNetwork type="Adfox" turbo-ad-id="second_ad_place">
<![CDATA[
<div id="идентификатор контейнера"></div>
<script>
window.Ya.adfoxCode.create({
ownerId: 123456,
containerId: 'идентификатор контейнера',
params: {
pp: 'g',
ps: 'cmic',
p2: 'fqem'
}
});
</script>
]]>
</turbo:adNetwork>
<item turbo="true">
<link>http://www.example.com/page1.html</link>
<author>Иван Иванов</author>
<category>Технологии</category>
<pubDate>Sun, 29 Sep 2002 19:59:01 +0300</pubDate>
<yandex:related type="infinity">
<link url="http://www.example.com/other-page1.html">Текст ссылки</link>
<link url="http://www.example.com/other-page2.html">Текст ссылки</link>
</yandex:related>
<turbo:content>
<![CDATA[
<header>
<h1>Ресторан «Полезный завтрак»</h1>
<h2>Вкусно и полезно</h2>
<figure>
<img src="https://avatars.mds.yandex.net/get-sbs-sd/403988/e6f459c3-8ada-44bf-a6c9-dbceb60f3757/orig">
</figure>
<menu>
<a href="http://example.com/page1.html">Пункт меню 1</a>
<a href="http://example.com/page2.html">Пункт меню 2</a>
</menu>
</header>
<p>Как хорошо начать день? <del>С чашки бодрящего кофе!</del> <ins>Вкусно и полезно позавтракать!</ins></p>
<p><b>Приходите</b> к нам на завтрак. Фотографии наших блюд ищите <a href="#">на нашем сайте</a>.</p>
<h2>Меню</h2>
<figure>
<img src="https://avatars.mds.yandex.net/get-sbs-sd/369181/49e3683c-ef58-4067-91f9-786222aa0e65/orig">
<figcaption>Омлет с травами</figcaption>
</figure>
<p>В нашем меню всегда есть свежие, вкусные и полезные блюда.</p>
<p>Убедитесь в этом сами.</p>
<button formaction="tel:+7(123)456-78-90" data-background-color="#5B97B0" data-color="white" data-primary="true">Заказать столик</button>
<section id="contacts">
<div data-block="widget-feedback" data-stick="false">
<div data-block="chat" data-type="whatsapp" data-url="https://whatsapp.com"></div>
<div data-block="chat" data-type="telegram" data-url="http://telegram.com/"></div>
<div data-block="chat" data-type="vkontakte" data-url="https://vk.com/"></div>
<div data-block="chat" data-type="facebook" data-url="https://facebook.com"></div>
<div data-block="chat" data-type="viber" data-url="https://viber.com"></div>
</div>
<p>Наш адрес: <a href="#">Nullam dolor massa, porta a nulla in, ultricies vehicula arcu.</a></p>
<section>
<p><small>Фотографии — http://unsplash.com</small></p>
]]>
</turbo:content>
</item>
</channel>
</rss>
Обязательный параметр